Overview
Cal.com lets your agent share availability: the meeting types you offer and the times the team is free.
It can also book a meeting on the team's calendar when you allow it.
The journey at a glance
- 1Find Cal.comOpen Integrations, search for Cal.com and click Connect.
- 2Create an API key in Cal.comIn Cal.com, open Settings → Developer → API keys and create a key.
- 3Connect Cal.com in CevanosPaste the key and select Verify & connect.
- 4Choose what this agent can doChoose Workspace and This agent, then save.
- 5Review actions and approvalsKeep booking on Wait for approval and check the 3 actions.
- 6Verify the connectionTest the connection, then ask for meeting types or open slots.
Before you start
You need a Cal.com account with meeting types and availability configured, plus permission to manage integrations in Cevanos.
Keep the API key private
Anyone with the key can act on your Cal.com account. Do not paste it into shared documents or screenshots.
Step 1
Find Cal.com
- 1Open your agent in Cevanos and go to Deployment → Integrations.
- 2Search for Cal.com under Scheduling, then click Connect.
Result
The connection wizard opens.
Step 2
Create an API key in Cal.com
- 1Sign in to Cal.com. Select Settings at the bottom-left.
- 2Under Developer, select API keys.
- 3Select New. Keep API key selected, give it a recognizable name and choose an expiration date. Click Create.
- 4Copy the newly created key before closing the confirmation. You cannot view it again afterwards.
Result
Your API key is ready to paste into Cevanos.
Step 3
Connect Cal.com in Cevanos
- 1Return to Cevanos and click Get started.
- 2Paste the key into the API key field, then click Verify & connect.
- 3When Cal.com is connected, click Choose what it can do.
Result
Cal.com is connected to the workspace.
Step 4
Choose what this agent can do
Both boxes
Both Workspace and This agent must be checked for a capability to be available to this agent.
- 1Enable the two reads and the booking action only if you want the agent to use them.
- 2Click Save capabilities.
Result
The selected capabilities are available to this agent, subject to relevant policies and approval controls.
Step 5
Review actions and approvals
- 1Open Agent → Actions and find Cal.com under Scheduling.
- 2Open its card and confirm the two reads and one action that makes a change.
- 3For Book a meeting on this team's calendar, keep Wait for approval while testing. Review the action-specific setting before deploying.
Step 6
Verify the connection
Use Test connection on the connected integration page. Then ask the agent to list available meeting types or open slots.
No real bookings
Do not submit a real booking during verification.
Reference
What Cal.com can do
Cal.com supplies three actions: two reads and one that makes a change.
3 capabilities · 2 reads · 1 that change something
List what can be booked
cal_com.list_event_typesFind when the team is free
cal_com.list_available_times
Book a meeting on this team's calendar
Approval recommended.
cal_com.book_meeting
Troubleshooting
| Problem | What to check |
|---|---|
| The connection fails | Check that the API key is complete, active and not expired; then try Verify & connect again. |
| No meeting types or slots | Check event types and availability directly in Cal.com. |
| Booking cannot run | Verify both capability checkboxes, its Actions switch, and any applicable policy and approval settings. |
Optional
Disconnect Cal.com
In the Cal.com integration page, select Disconnect Cal.com and confirm.
Your data stays
This removes Cevanos's access but does not delete Cal.com meetings. Revoke the key in Cal.com separately if needed.
Ready to connect Cal.com?
Open your agent's Integrations and click Connect on the Cal.com card.