Planner

The Planner enables working with calendars, like scheduling a meeting or planning a callback appointment. The skill implements the Calendaring features of the DialoX platform. Developers could have a look here for more details.

Planning outcomes

The Planner skills can deliver the following type of outcomes

Planner outcome	Description
Event	An event is like any regular calendar event you would find in your Google or Microsoft calendars having a date, start time and duration.
Todo	A todo is modelled as a Note in the DialoX platform, but with a due date.

When using todo's with external calendars, created apppointments may not show up in your external calendar. If you need them to show up there, do not check the "Create a note when an event is created".

Determine availability

For the skill is able to support two different ways for determining which moments to allow to be scheduled. The availability of a certain moment in time can be determined according the following two strategies:

Availability is based on…	Description
Free/busy	Scheduling is based on free space in the calendar since there can only be one event on any given moment in time. Once planned, this moment in time is no longer available for planning.
Slots	Scheduling is based on the predefined capacity for a certain moment in time, called a slot. This slot capacity depletes once all slots are planned causing this slot to be no longer available.

Planner configuration

The planner can be configured to either create events (by not creating notes) or by creating todo's (by creating notes).

The planner will return availability based on either the free/busy or the slots strategy mentioned earlier.

Then there are two more settings.

• Day limit This limits the amount of days a customer can plan ahead. E.g. for scheduling an appointment at a barbershop, we might want to have a much higher limit than for scheduling a callback appointment for pharmacies.

• Minutes from now This prevents users from scheduling appointments that take place shortly after making the appointment. E.g. for realtors you might need to prepare a lot for an appointment, so there should be at least 4 hours between now and the start of the appointment. For callback appointments of an ISP it might be much shorter.

Conversation strategy options

This node allows for four different conversation strategies for eliciting the plan:

Strategy	Description
directly suggest 1 option	The bot will directly propose the first available option to which the user only has to reply with yes or no. When answering no, the bot will propose the next available option.
directly suggest multiple options	The bot will directly propose a couple of options out of which the user can choose. The user can also ask for more options after which the bot will present the next couple of slots.
first ask before suggesting 1 option	The bot will ask for the user's preferred date and time first before proposing an option that comes closest to the user's preference. The user can then answer with either yes or no.
first ask before suggesting multiple options	The bot will ask for the user's preferred date and time first before proposing a couple of options that come close to the user's preference.

Variables

In order to work with this data this skill is producing, the skill introduces the following variables to your Flow designer. They can be used to interpolate with your texts and questions in your Flow.

Variable	Description	Example
Plan date	Start date of the plan (friendly formatted)	Monday 5 January
Plan ISO	Start date and time in ISO format	2014-01-05T10:00:00Z
Plan datetime	Friendly formatted start date and time	Monday 5 January at 10:00
Plan day	Name of the start date (relative)	Tomorrow
Plan time	Start time of the plan	10:00
Plan until	End time of the plan	11:00
Plan until ISO	End date and time in ISO format	2014-01-05T11:00:00Z

You can also store the made appointment in a variable. This variable holds the entire planned appointment. This allows you to take a more custom approach on what to do with the result.