Taalk Help Center

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.

  1. In Calendly, open the API and webhooks settings (under Integrations).
  2. 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

  1. Go to Platform › Developer › Integrations and click Connect on Calendly.
  2. Paste the token into Calendly API Key ("Paste your Calendly API Key here.").
  3. 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:

  1. The agent asks when the contact is free ("tomorrow", "next week").
  2. A plugin action asks Taalk for open times on your Calendly event type.
  3. 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).
  4. The agent offers them. The contact picks one.
  5. A second plugin action returns the scheduling link for that time.
  6. 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