Cal.com

Cal.com is an open-source scheduling tool with a similar UX to Calendly. Hilal Chatbot’s Cal.com integration mirrors the Calendly flow exactly — connect via OAuth, pick which event types the bot can book, and the chatbot does the rest.

In this guide:

• Why use Cal.com vs. Calendly
• Connect Cal.com
• Pick event types
• Test a booking
• Disconnect

Why Cal.com

• Open source. You can self-host or use Cal.com’s hosted service.
• Generous free tier. Most of the scheduling features unlocked from day one.
• Same chatbot experience. Whichever tool you pick, the bot’s UX is identical.

If you’re already on Calendly and happy, stick with Calendly — both work the same way.

Step 1: Connect

On your chatbot detail page, go to Actions → Integrations. The Cal.com card sits next to Calendly.

Screenshot: The Cal.com integration card on the Actions → Integrations page.

Click Connect. You’re redirected to Cal.com’s OAuth flow. Sign in to Cal.com and approve.

You return to Hilal Chatbot with the integration showing as Connected.

Step 2: Pick which event types the bot can book

The integration lists event types from your Cal.com account. Pick one or more for the chatbot to expose to users.

Cal.com supports the standard set: round-robin team events, collective events, single-host events. The bot books whichever you allow.

Step 3: Test a booking

In the Playground, ask the bot to schedule a meeting. The flow:

1. The bot fetches available slots from Cal.com.
2. Renders inline in chat.
3. User picks a slot, provides email.
4. The bot books via Cal.com’s API.
5. Confirmation message + calendar invite from Cal.com.

Step 4: Configure availability action

You can configure the Cal.com get-availability action with specifics — minimum notice, max-days-out, time zone — at:

/chatbots/[id]/actions/calcom/get-available-slots

Or navigate via Actions → Cal.com → Get available slots.

Step 5: Disconnect

In Actions → Integrations, click the Cal.com card’s menu → Disconnect. Hilal Chatbot revokes the access token. The Cal.com side can also disconnect from your Cal.com integrations page.

Permissions and feature flags

• Feature flag: CALCOM_INTEGRATION must be enabled on your plan or by an Owner.
• Permissions: CALCOM_ACTIONS.READ to view, CALCOM_ACTIONS.CREATE to connect, CALCOM_ACTIONS.DELETE to disconnect.

If you don’t see the Cal.com card, your plan or role doesn’t allow it.

Troubleshooting

• “No event types available.” Create at least one in Cal.com first.
• OAuth fails with “App not approved.” Use a hosted Cal.com account, or check your self-hosted Cal.com OAuth app config.
• Booking conflicts. Cal.com’s calendar integration may not be fully configured. Verify in Cal.com that your Google/Outlook calendar is connected.

What’s next