Cal.com — Oshun System Docs

What It Does

Booking engine for all Oshun appointments. Patients book at cosmetic.oshunja.com/booking. Webhooks from Cal.com trigger the full care lifecycle — pre-care guides, appointment reminders, and post-care sequences all start from booking events.

External Connections

Booking URL: cosmetic.oshunja.com/booking
Cal.com webhooks — fires on booking created, cancelled, completed, no-show

Env Vars

CALCOM_API_KEY
CALCOM_WEBHOOK_SECRET

Related Journeys

Source Files

src/webhooks/chatwoot.js — app.post('/webhooks/calcom') at line 329; receives all Cal.com webhook events
src/actions/calendar.js — Cal.com API client, availability checks, booking creation
src/webhooks/voice_helpers.js — handleScheduleCallback(), handleBookAppointment()

Known Issues

Karen Cal.com booking bug documented — confirm status before relying on real-time booking during voice calls.

Cal.com auto-triggers (cancelled, completed, no-show) are approved in design but not yet wired to the care plan pipeline.