Calendar card

This card helps to get the date and time inputs from the visitors using a calendar widget. The visitor can choose a specific date and time with this card.

AttributeMandatoryDescriptionValues
typeYesThe type of input to be displayed to the visitorcalendar
timeNoSpecifies whether the calendar should display only the date or time along with the date.true - To allow the visitor to choose the time value along with the date 
fromNoSpecifies the minimum date range from which the visitors are allowed to choose the date, i.e., the onset date the visitors are allowed to select from the calendar.+/- IntegerThe no. of days to be specified in the calendar will be calculated before and after the present day.

For Example:

+5 - This will calculate 5 days after the present-day
-3 - This will calculate days before the present-day

Long The date value is specified in milliseconds

For Example:

123232323 - start date/time specified in the calendar
121212133 - end date/time specified in the calendar

toNoSpecifies the minimum date range from where the visitors are allowed to choose the date, i.e., the latest date the visitors are allowed to select from the calendar.+/- IntegerThe no. of days to be specified in the calendar will be calculated before and after the present day.

For Example:

 

+5 - This will calculate 5 days after the present-day
-3 - This will calculate days before the present-day

Long The date value is specified in milliseconds

For Example:

123232323 - start date/time specified in the calendar
121212133 - end date/time specified in the calendar

tzNoSpecifies whether the visitor chooses the timezone in the calendartrue - To allow the visitor to choose the timezone in the calendar. It defaults the timezone of the visitor's device.
select_labelNoTo set customized text for widget values/slot submission actions

Instead of 'Schedule' they can use custom text like 'Choose a slot"

Note: Maximum character limit for values passed inside the select_label key is 20

time_formatNoTo set the time format (12 hrs/ 24 hrs) of calendar

"12" or "24" // 12 hrs format is default

Channel compatibility and limitations

  

Facebook Messenger:

  • The card is supported on Facebook. 
  • When using this card, the user would have to type the date/time manually. 
  • The "Change timezone" allows the user to change the timezone. 

Instagram:

  • The card is supported on Instagram. 
  • When using this card, the user would have to type the date/time manually.
  • The "Change timezone" allows the user to change the timezone.

WhatsApp:

  • The card is supported on WhatsApp. 
  • When using this card, the user would have to type the date/time manually.
  • The "Change timezone" allows the user to change the timezone.

Output

 

Sample code

Copied{
"platform": "ZOHOSALESIQ",
  "replies": [
      "Please select your preferred date"
    ],
  "input": {
    "type": "calendar",
    "label": "Schedule a meeting",
    "from": "-5",
    "to": "+5",
    "time": true,
    "tz": true,
    "select_label": "Choose a slot"
  }
}