Skip to main content
telli + Calendly integration

​
Overview

Calendly is configured per agent so each workflow can use the right event type, booking link, and booking-field mapping. This works well when different agents book different meeting types or route to different teams.

​
Before you start

  • A telli agent that should book appointments
  • A Calendly account and event type
  • A Calendly API key with at least users:read, organizations:read, event_types:read, availability:read, and scheduled_events:write
Booking through the Calendly API requires a paid Calendly plan. Booking is not possible via the API on the Free plan, even with the correct API key scopes.

​
Set up Calendly in telli

1

Open the agent

Open the agent you want to configure in telli.
2

Choose Calendly

In Calendar Integration, select Calendly.
3

Add your Calendly credentials

Create a Calendly API key with at least users:read, organizations:read, event_types:read, availability:read, and scheduled_events:write, then add it and select the Calendly event type that should be used for bookings.
4

Configure booking fields

Open the settings for the selected event type and map the booking questions you want telli to fill automatically.
5

Save the agent

Save the agent so telli can use the selected Calendly setup during calls.

​
Booking fields

When connecting Calendly, you can configure booking fields to automatically fill the custom questions on your Calendly event type during booking. Each booking field maps a Calendly question to a value source.

​
How it works

  • telli uses the configured Calendly event type for that agent
  • Booking fields are resolved automatically during booking
  • Contact properties and constants are filled without extra conversation
  • LLM parameters prompt the agent to collect missing information from the caller
Every required custom question on your Calendly event type must have a corresponding booking field configured, otherwise the booking will fail. Optional questions without a mapping are skipped.