Google Calendar Webhooks & Sync Logic

Google Calendar Webhooks (also known as Push Notifications) allow Google to notify your KiviCare system whenever changes occur in calendar events. This ensures that appointments in KiviCare remain accurate and synchronized in real time.

How the Synchronization Works

1. Watch Channel Setup
   The plugin can create a watch channel for each doctor’s Google Calendar to monitor event changes.
2. Event Change Notification
   When an event is updated, deleted, or started in Google Calendar, Google sends a push notification to your KiviCare website.
3. Request Processing
   KiviCare receives the webhook request, identifies the related appointment, and applies the required updates within the system.

Supported Synchronization Scenarios

Security & Request Verification

Google includes specific HTTP headers in each webhook request, such as:

• X-Goog-Channel-ID
• X-Goog-Resource-ID

The plugin validates these headers to confirm that the request is genuine and originated from Google Calendar, preventing unauthorized or spoofed updates.

Configuration Notes (For Developers)

Webhook notifications are typically handled via the endpoint:

YOUR_SITE_URL/wp-json/kivicare/v1/settings/googlemeet/callback

or a dedicated webhook route.

At present, the Google Meet Addon primarily relies on direct API synchronization during appointment create, update, and delete actions in KiviCare. To enable full real-time push-based synchronization, ensure your Google Cloud Project is configured to allow outbound notifications to your server domain.