Skip to main content

​
Overview

Cal.com is a calendar integration. Connecting it links your Cal.com account to your Voxworks team so the Book Calendar Appointment | Pro tool can check availability and create bookings against a Cal.com event type during a call. The connection uses an API key — you generate the key in Cal.com, paste it into Voxworks once, and Voxworks encrypts and stores it. There is no OAuth redirect. Until Cal.com (or another calendar provider) is connected, the calendar booking tool does not appear in the script editor’s tool picker at all — connecting is the prerequisite step before any event-URL booking can be configured.
Integrations are typically built out for specific clients, so the full functionality of Cal.com’s interface might not be available. If your team needs additional features from this integration, contact the Voxworks team directly to discuss what can be added.

​
Generating your Cal.com API key

You create the key inside Cal.com, not in Voxworks:
  1. Sign in to your Cal.com account.
  2. Open Settings, then find API keys under the Developer section.
  3. Create a new API key and copy it. Cal.com only shows the full key when it is created, so copy it before leaving the page.
Two tips while you are in Cal.com:
  • Set the key to never expire (or diarise the expiry). If the key expires, bookings from calls stop working until you reconnect with a fresh key.
  • Note your event type link — the public booking link for the event type you want the assistant to book, for example https://cal.com/jane-smith/15min. You will need this later when configuring the booking tool; it is not needed to connect.

​
Connecting Cal.com to Voxworks

  1. In the sidebar under Admin, open Integrations.
  2. In the Available Integrations section, find the Cal.com card. It carries a Calendar badge and the description “Integrate with Cal.com for automated scheduling”.
  3. Click Connect. The Connect Cal.com dialog opens: “Enter your Cal.com API key to establish the connection.”
  4. Paste your key into the API Key field and click Connect.
On success you’ll see an “Integration connected successfully” message, and the Cal.com card moves to the Connected Integrations section with a green Connected badge. The card’s footer shows how many tools the connection makes available.
Voxworks stores the key immediately and does not test it against Cal.com at connect time. A mistyped or revoked key only surfaces later, as availability or booking failures on calls — so double-check the key you paste, and run a test call after setup.

​
What connecting unlocks

Once Cal.com shows as Connected:
  • Book Calendar Appointment | Pro appears in the tool picker when you edit a script step. The picker hides integration-bound tools until their provider is connected.
  • With Cal.com as the provider, the tool adds one required Cal.com-specific field alongside its shared settings: event_url — the Cal.com event URL for the event type the assistant books into. It is a string, for example https://cal.com/jane-smith/15min, and accepts either a literal value or a variable (type / in the field to insert one).
  • If your team has more than one calendar provider connected, a provider select appears in the tool’s configuration panel so you can choose Cal.com explicitly.
Connecting Cal.com can also surface an older tool named Cal.com | Book Time in Calendar | Pro in the picker. It is the superseded predecessor of Book Calendar Appointment | Pro (it takes the same event_url field) — use Book Calendar Appointment | Pro in all new scripts.
Successful bookings are written to {{calendar.*}} variables your flow can speak or send — for example {{calendar.booking_time_spoken}} (string, e.g. 10:30 AM on Tuesday the 22nd of July) and {{calendar.booking_link}} (string, e.g. https://cal.com/booking/abc123). The full field-by-field and variable reference lives on the Cal.com booking tool page, and the settings shared by every calendar provider (availability window, SMS confirmation, timezone check) are on the calendar tools overview.

​
Managing or removing the connection

Click the gear icon on the connected Cal.com card to open Integration Settings:
  • Status — a Connected badge plus an API Key badge showing the authentication type. If the connection has failed, an Error badge appears here and on the card, with the error message.
  • Connection Details — when the connection was made and a masked view of the stored API key. The key is never displayed again after connecting.
  • Available Tools — how many tools this connection enables.
To replace the key (for example after rotating it in Cal.com), disconnect and reconnect with the new key. If the card shows an Error badge, it offers a Reconnect button that reopens the connect dialog directly. To remove the connection, click Disconnect in Integration Settings. The Disconnect Cal.com? dialog warns that disconnecting will stop active workflows using the integration, remove access to Cal.com features from your AI agents, and delete the stored authentication tokens. Any script step still configured with the Cal.com booking tool will fail to book until you reconnect. You can reconnect at any time by entering an API key again.

​
Next Steps