Scheduling Conversations Alpha

Read as Markdown

The Scheduling Conversation API endpoint is designed to support the scheduling of appointments and sessions within the flow of a chat conversation or similar.

A typical flow in chat tool would be as follows.

  1. User @grace initiates session with chat command, eg: meet @karl next tuesday
  2. The chat service creates a scheduling conversation with two participants, @grace and @karl.
  3. The chat service then queries the participant.possible_actions method for each participant. If the action slots_select is available then available slots are offered to that participant.
  4. The chat service updates the participant record with the chosen slots.
  5. When the final slot choice has been made, events are created or smart invites are sent to the participants.
  6. The scheduling conversation is now complete

In this section

Create Conversation

Creates a Scheduling Conversation in an initial state.

Read Conversation

Retrieve the current state of a scheduling conversation.

List Slots

This endpoint provides a list of slots available to be offered to participants in the conversation.

Select Slots

Enables the recording of an individual participant's choice of slots.

Webhooks

A scheduling_conversations object is added to the existing create channel endpoint allow your application to subscribe to scheduling conversation notifications for a particular account.