Back to Documentation

Live Calendar Sync (Calendly)

Give your Voice Agent the ability to physically read your live calendar availability and schedule appointments dynamically during a conversation.

Calendly Token Architecture

1Generate your Access Token

  1. Log into your Calendly account.
  2. Go to your Integrations page and navigate to API & Webhooks (or go to this direct link).
  3. Click the Generate New Token button for a Personal Access Token (PAT). Name it "HeyAstra AI Agent".
  4. Copy the generated Token (it will look like a very long string of random characters ending with your account hash).

Warning: Calendly will only show you this token once! If you lose it, you must generate a new one. Do not share this token publicly.

2Bind to Astra

  1. In Calendly, go to your main Event Types page and copy the link of the specific appointment block you want the AI to route users to (e.g., https://calendly.com/your-business/consultation).
  2. Open your HeyAstra Dashboard.
  3. Navigate to the Integrations tab.
  4. Scroll down to the Live Calendar Sync section.
  5. Paste the long API String into the Personal Access Token field.
  6. Paste the Event Link into the Scheduling Event URL field.
  7. Click Save Active Configs.

Your AI Agent is now fully connected! You can test it by calling your number and asking: "Do you have any availability tomorrow morning?"

SMS Booking Links: When SMS is enabled, your AI agent can text the Calendly booking link directly to the caller during the conversation — no need to spell out a URL over the phone.