Calendly Integration
The Calendly integration lets your AI agent offer open times from a Calendly event type during a call and send the contact the Calendly scheduling link for the time they pick. The contact finishes booking on Calendly.
Go to Platform › Developer › Integrations › Calendly.
Calendly is an add-on ($10.00 one-time). If the row shows Unlock, buy it first. See Integrations Overview.
What it does (and doesn't)
- Does: read open times for one of your Calendly event types, offer up to 3 of them, and return the scheduling link for the chosen time.
- Doesn't: create the booking. Calendly books the meeting when the contact opens the link and confirms. Calendly then sends its own confirmations and reminders.
Step 1: Get your Calendly API key
Calendly calls it a personal access token.
- In Calendly, open the API and webhooks settings (under Integrations).
- Create a personal access token and copy it.
In Taalk, How to get the API key? opens Calendly's instructions.
Step 2: Save the key in Taalk
- Go to Platform › Developer › Integrations and click Connect on Calendly.
- Paste the token into Calendly API Key ("Paste your Calendly API Key here.").
- Click Save. You see Saved.
After saving, the field shows a row of asterisks and the Integrations list shows Calendly as Connected. To replace the key, paste a new one and save again.
[Confirm] Saving the Calendly API key works for workspace admins.
Taalk doesn't test the key when you save it. If it's wrong, the first booking attempt fails.
Step 3: Use it on a call
Calendly is used through a plugin on your AI agent, typically built from the Calendar Booking plugin template:
- The agent asks when the contact is free ("tomorrow", "next week").
- A plugin action asks Taalk for open times on your Calendly event type.
- Taalk returns up to 3 open times, picked at random within that range ("week" or "month" looks 5 days ahead; anything else looks at one day).
- The agent offers them. The contact picks one.
- A second plugin action returns the scheduling link for that time.
- The agent sends the link, for example by text using the agent's In-Call Text Message, so the contact can confirm in Calendly.
[Confirm] The Calendly plugin actions are set up by Taalk support or the Calendar Booking template; the Calendly option is not in the plugin Auth list.
See Plugins Overview and SMS Messaging.
Tips
- Use a dedicated Calendly event type for AI-offered meetings so you can track them.
- Tell the agent, in its script, to say that the contact will get a link to confirm.
- Ask for any details your event type requires during the call, or let Calendly collect them on the booking page.
Troubleshooting
| Problem | What to check |
|---|---|
| "Calendly API Key is missing" | Save the key under Integrations. |
| "Cannot find the Calendly user" | The token is wrong or revoked. Create a new one in Calendly and save it. |
| No times offered | The event type has no availability in that range, or it's inactive. |
| Contact says the meeting isn't booked | Expected until they open the link and confirm in Calendly. |
What Calendly can't do (yet)
- Book the meeting directly. It always returns a link.
- Validate the key on save.
- Connect more than one Calendly account per workspace.
- Pick a specific team member on a round-robin event.
Related
- Google Calendar and Workspace Integration: books events directly
- Appointment Setting