Calendar Sync (Native & Calendly)

Native Operator Calendar Provider

By default, Operator functions as a self-contained, enterprise appointment booking engine.

All bookings, schedules, and staff availability are tracked directly in your dedicated PostgreSQL database: - Zero third-party calendar dependencies required. - Full access to appointments inside the Operator dashboard (/appointments). - Automatic synchronization between phone calls, web chat, and messaging channels.

Calendly Integration

Operator supports reading external busy periods from Calendly via CalendlyProvider in src/server/services/calendar-provider.ts.

How it works: 1. When generating available appointment slots, Operator queries the Calendly Scheduled Events API: `GET https://api.calendly.com/scheduled_events?min_start_time=...&max_start_time=...` 2. Busy time blocks on Calendly are treated as blackout windows in Operator's scheduling calculations. 3. This prevents double-booking if staff members maintain appointments on Calendly.

Setup Instructions: 1. Generate a Personal Access Token in your **Calendly Account > Integrations**. 2. Go to **Settings > Calendar Connections** in Operator. 3. Select **Calendly**, paste your Access Token, and click **Connect**.

Provider Registry Codebase Verification

Google Calendar and Microsoft Outlook direct APIs are NOT currently supported in this release. </Callout>