The calendar action block opens a calendar UI in the chat widget. Visitors can choose a date from the calendar view. Some use cases of the calendar block are appointment booking, requesting a callback, and entering a date of birth. Here is what you need to setup the calendar action block:

​

Using the Calendar block

Add the Calendar block to your bot when you need to collect a date or schedule an appointment.

1. Open Bot Builder and add the Calendar block to the canvas.
2. Connect the block to the previous and next blocks in your flow.
3. Write a question.
4. Complete the required configurations
5. Save the selected date or appointment details to a variable.
6. Connect the appropriate output path to the next step in your flow.
7. Deploy the bot.

Use Cases:

• Collect a preferred date
  • Ask users which day they want to schedule a service, delivery, visit, or callback.
  • Example: “Which date would you like our team to contact you?”
• Schedule callbacks
  • The bot collects the customer’s preferred date and passes it to an agent or backend system for follow-up.
• Book date-based services
  • Useful when the service doesn’t require the customer to choose an exact time.
  • Example: home service, document collection, site visit, or delivery date.
• Event registration
  • Let users select the date they want to attend an event, webinar, consultation, or session.
  • The actual time can be assigned later.
• Collect availability
  • Ask users to select a date when they are available, then use that information in a later workflow.
• Date-based workflows
  • The selected date can be stored in a variable and used for conditions, notifications, API requests, or other bot actions.

​

Configuration

​

Question

Before showing the calendar UI, you need to ask a question to let users know why they are seeing it in the first place. For example, “Select your desired date of appointment”.

​

Save response to a Variable

• Variables store the date selected by the user so that it can be referenced later.
• You can choose an existing variable from the dropdown or create a new one.

For example, you can use the saved value to:

• Confirm the selected appointment with the user
• Include the date in a follow-up message
• Pass the selected date to another block
• Store the booking information for later use

Learn more about variables here.

​

Show past dates

Enabling this will allow visitors to choose past dates from today as well. Disabling it will only show the dates from today to the future.

​

Availability

Configure when users can book a slot.

• Days available — choose the days on which appointments can be booked.

Example: In the example below, select Saturday and Sunday as excluded days. By default, Monday to Friday will be available days.

​

Exclude days

You can choose to exclude certain days of the week, like Saturday and Sunday, from this dropdown. Doing so will always prevent those days from showing up in the calendar UI.

​

Exclude specific dates

You can click on the calendar icon and select the date you want to disable in the calendar UI. These could be to hide dates of public holidays in your region.

• USA - 4th July - Independence Day
• India- 15th August - Independence Day

​

Booking Details

Configure the information that should be included when an appointment is created. Depending on the connected calendar, booking details can include:

• Appointment title
• Description
• Date and time
• Attendee name
• Attendee email
• Meeting or location details
• Other information required by the connected calendar

Collect any required attendee information before the Calendar block attempts to create the appointment.

​

Preview

This is how the Calendar will appear in the chatbot. As per the current settings, Saturday and Sunday are selected under Excluded Days, and 2nd October is selected under Excluded Dates. Therefore, these days are not available for selection.

​

Output Paths

Use the Calendar block’s output paths to handle the result of an appointment booking.

​

Variables set

The Calendar block makes the user’s selected date or appointment information available to the flow. Depending on the selected mode, this can include:

• Selected date — the date chosen by the user.
• Booking details — information associated with the created appointment.

You can use these values in subsequent messages, conditions, or other blocks to continue the conversation after the date is collected or the appointment is booked.