Calendar

Connect a Cal.com calendar to your AI agent. This allows the agent to check available appointments and make bookings directly for your callers.

Note: Currently, the integration supports retrieving available appointments as well as direct booking. Additional functions will be added gradually.

Requirements

• A Cal.com account (free or paid)
• At least one configured event type in Cal.com
• An API key from your Cal.com account

Create Cal.com API key

1

Log in at app.cal.com in

2

Navigate to Settings → Security → API Keys

3

Create a new API key

4

Store the key securely

API keys are valid for 30 days by default. In the Cal.com settings, you can adjust the validity period or create a key that is valid indefinitely.

Set up calendar integration in sipgate

1

Open your AI agent

and navigate to the Calendar

2

Click "Add"

to open the setup dialog

3

Enter your API key

and click on Next

4

Choose the appropriate mode, API region, and, if needed, additional IDs

See table

5

Click Save

6

Make sure no playbook for appointment requests is configured

A playbook for appointment requests can lead to unexpected behavior with active Cal.com integration.

Configuration fields

Field	Required	Description
API token	Yes	Your Cal.com API key (starts with cal_ or cal_live_)
Mode	Yes	Determines which calendar is accessed (see below)
API region	Yes	US or EU — depending on where your Cal.com account is hosted
Organization ID	Only in Organization mode	The ID of your Cal.com organization
Team ID	Only in Team mode, optional in Organization mode	The ID of your Cal.com team

Choose mode

Mode	Description
Personal	Access to your personal Cal.com calendar
Team	Access to a team calendar — requires a team ID
Organization	Access at organization level — requires an organization ID, team ID is optional

You can find the team ID and organization ID in the URL when you open the respective team or organization in Cal.com.

API region

Region	URL	Usage
US (Global)	api.cal.com	Default for Cal.com accounts
EU	api.cal.eu	For Cal.com accounts hosted in the EU (GDPR-compliant)

If you're unsure which region is correct: Look at the address bar of your browser while logged in to Cal.com. If the address is app.cal.eu, choose the EU region. If it is app.cal.com, choose US (Global).

Edit configuration

After setup, you can adjust the Mode, the API region and the API token separately via the edit buttons.

Good to know

• When Cal.com integration is active, no playbook for appointment requests should be configured.
• Do not enter any entries about appointments or appointment bookings in the customer questions. This can disrupt the booking process because the agent may then treat the concern as a knowledge question instead of using the calendar integration.
• Your API key is stored encrypted.
• The AI agent checks availability in your Cal.com calendar for every call.
• Changes to the configuration take effect immediately.
• If you delete the integration, the agent can no longer check or book appointments.

In the Enterprise plan more complex appointment and process logic can also be implemented. Learn more.