Skip to main content
Cal.com connects your workspace calendar setup to Vocily. After it is connected, agents can use calendar capabilities during conversations.

​
What Cal.com enables

Use the Cal.com integration when an agent needs to:
  • Check availability.
  • Book meetings.
  • Reschedule existing meetings.
  • Cancel meetings.
Cal.com is connected at the workspace level. You then add calendar capabilities to the specific agents that should use them.

​
Before you connect

Have a Cal.com account and API key ready.
If you do not have a Cal.com account yet, create one first. During setup, you can connect Google Calendar if you want Cal.com availability to stay in sync with your Google Calendar. Calendar sync is optional; it is only needed when you want bookings to reflect that calendar.
To create an API key:
  1. Go to Cal.com API keys.
  2. Select Create new.
  3. Recommended: set the key to never expire if your Cal.com workspace allows it.
  4. Copy the API key.
If the key expires, you need to create a new key and update the Cal.com integration in Vocily again.

​
Cal.com billing

Your Cal.com account, organization plan, seats, calendar-provider setup, and Cal.com invoices are managed by your business in Cal.com. Vocily does not create, upgrade, downgrade, cancel, or pay for your Cal.com plan. If your team uses a paid Cal.com organization plan, keep that plan active in Cal.com so the event types and booking permissions your agents rely on remain available. Vocily connects through the API key you provide and uses the Cal.com access that your account already has.

​
Connect Cal.com

To connect Cal.com:
  1. Open Integrations.
  2. Choose Cal.com.
  3. Paste your Cal.com API key.
  4. Save the connection.
Vocily stores the API key securely. After connection, the key is shown only in masked form, along with the connected calendar account details when they are available.

​
Add Cal.com to an agent

After Cal.com is connected:
  1. Open the agent.
  2. Go to Capabilities in the Configuration tabs.
  3. Open Integrations.
  4. Add a Cal.com capability.
  5. Choose what the agent should do: check calendar availability or book and manage appointments, then choose the Cal.com event type the agent should use.
  6. Select Configure.
  7. Review the fields and adjust the instructions for this agent.
  8. Select Add integration.
The event type controls which Cal.com meeting type this agent uses. Vocily creates default names and instructions from the selected event, and you can edit them before adding the capability to the agent.

​
Choose the capability type

Vocily supports two Cal.com capability types:

Calendar Availability

Checks open meeting slots from the selected Cal.com event type. Use this when the agent should offer available times before the customer chooses one.

Book Appointment

Books the selected Cal.com event type and can also list, reschedule, or cancel existing bookings for the caller.

​
Configure Calendar Availability

Use Calendar Availability when the agent only needs to check available slots or share options with the caller.
The default setup works without editing. Only adjust the instruction and message fields if you want the agent to follow a more specific policy or say a different line before it checks the calendar.

​
Configure Book Appointment

Use Book Appointment when the agent should create a booking or manage an existing booking during the conversation.
The default setup works without editing. Only adjust the instruction and message fields if you want the agent to follow a more specific policy or say a different line before it books or manages a meeting.
Book Appointment also includes booking-flow controls:

​
Write prompt instructions for scheduling

When the agent uses Cal.com, explain the scheduling behavior in the agent prompt:
  • When to offer a booking.
  • What information to collect before checking availability.
  • How to handle reschedules or cancellations.
  • What to say while it checks or updates the calendar.
Keep the prompt focused on the customer’s task. The capability handles the calendar action; the prompt tells the agent when and how to use it.

​
Disconnect Cal.com

Disconnecting Cal.com removes Cal.com-backed capabilities from agents in the workspace. Use this when you want agents to stop checking availability or managing bookings through that Cal.com account.

​
What’s next