Cal.com Booking - Voxworks

Get Started & Build

Calls, Contacts & Batches

Numbers & Routing

Tools, Automations & Integrations

Account, Billing & Security

Overview

Tool name: Cal.com | Book Time in Calendar | Pro Use this tool to book an appointment through a Cal.com event. See Calendar Booking Overview for how availability and booking work across providers.

Provider Settings

ID	Setting	Type	Required	Default	What it does
`120`	event_url	string, URL	Yes	none	Cal.com event URL, for example `https://cal.com/jared-buncombe-mcw6jg/15min`. Availability and booking use this event type.

Common Settings

ID	Setting	Type	Required	Default	What it does
`0`	Number of Weeks	integer	No	`4`	Weeks to check availability. Tool definition range is `1-8`.
`1`	SMS Message	text	No	empty	Custom SMS confirmation message. Written to `{{sms.message}}`.
`3`	Booking Purpose	text	No	empty	Purpose of the appointment. Written to `{{calendar.purpose}}`.
`5`	Check Timezone Before Booking	boolean	No	`false`	Whether the flow verifies the user’s timezone before booking. Written to `{{timezone.check_timezone}}`.
`6`	Send SMS Confirmation	boolean	No	`true`	Whether to send an SMS confirmation after booking. Written to `{{calendar.sms_flag}}`.
`7`	Booking Window Start Offset (Minutes)	integer	No	`15`	Availability starts this many minutes after call start.

Availability Behavior

Cal.com availability is loaded from the configured event URL and converted into the shared calendar format used by the booking flow.

Global Variables Written or Maintained

Variable	When set	Meaning
`{{calendar.purpose}}`	Tool entry	Booking purpose configured on the tool.
`{{sms.message}}`	Tool entry	Custom SMS confirmation message.
`{{timezone.check_timezone}}`	Tool entry	Timezone verification flag.
`{{calendar.sms_flag}}`	Tool entry	SMS confirmation flag.
`{{calendar.event_id}}`	Availability load	Cal.com event URL or event identifier.
`{{calendar.availability_spoken}}`	Availability check	Spoken availability response.
`{{calendar.booking_time_raw}}`	Slot validation and booking success	Exact selected slot in ISO date-time format.
`{{calendar.booking_time_spoken}}`	Booking success	Spoken confirmation time.
`{{calendar.booking_time_written}}`	Booking success	Written confirmation time.
`{{calendar.booking_id}}`	Booking success	Cal.com booking ID.
`{{calendar.booking_link}}`	Booking success	Link returned by provider logic when available.

Cancellation Behavior

If the user cancels during the same call, the flow uses the Cal.com cancellation path where supported. A successful cancellation clears the stored booking ID, booking link, and stored booking time values. Output variable result is boolean true when the appointment was booked successfully.