Calendly

The Calendly integration lets agents check your Calendly availability and list your event types, so they can offer callers real open slots.

Connect

1. Open your project and go to Tools → Add tool → From template.
2. Find Calendly and click Connect with Calendly.
3. Sign in to Calendly and approve access.
4. Back in the VoisX console, select the actions you want to enable and click Install integration.

Actions

Action	What it does
Get Availability	Returns open times for an event type
List Event Types	Lists your event types, such as "30 minute consultation"

List Event Types needs your Calendly user URI (it looks like https://api.calendly.com/users/...), and Get Availability needs an event type URI from that list. Put your user URI, or the event type URIs the agent should offer, in the agent's prompt. Calendly accepts an availability range of up to 7 days per request.

Example

When a caller asks to book a consultation:
1. Use Get Availability for the "30 minute consultation" event type for the next 7 days.
2. Offer the caller up to three open times.
3. Once they pick one, tell them they will receive a booking link by email or SMS.

note

These actions read availability. To create a booking during the call, combine them with a messaging integration that sends the caller your Calendly booking link, or use Google Calendar or Outlook to create the event directly.

Troubleshooting

No availability returned

Check that the event type is active in Calendly and that the date range is inside its booking window.

401 Unauthorized

The connection was revoked in Calendly. Reconnect Calendly.