WhatsApp-Based SaaS Service Booking Platform with Twilio & Cal.com

We built a SaaS service booking platform powered by Twilio's WhatsApp Business API for conversational interactions, Cal.com for scheduling and calendar management, and a multi-tenant backend for business onboarding and configuration.

Architecture

• Messaging Layer: Twilio WhatsApp Business API for bi-directional messaging
• Scheduling Engine: Cal.com (self-hosted) for availability management, booking logic, and calendar sync
• Backend: Node.js/Express API with Amazon DynamoDB for multi-tenant data
• Conversation Engine: ChatGPT-powered AI conversation engine managing booking flows, rescheduling, and cancellations
• Notifications: Twilio for WhatsApp reminders, confirmations, and follow-ups
• Admin Dashboard: Vue.js frontend for business owners to manage services, availability, and bookings
• Payments: Stripe integration for deposits and pre-payments via WhatsApp payment links

Conversational Booking Flow

Discovery & Booking

The WhatsApp bot guides customers through a natural conversational flow: greeting, service selection (with descriptions, durations, and pricing), provider selection (with ratings and reviews), available time slot browsing (with week navigation), and booking confirmation with all details. The entire flow completes without leaving WhatsApp.

Rescheduling & Cancellation

Customers can reschedule or cancel by simply replying with a keyword. The bot identifies their active bookings, presents available alternatives, and confirms the change — with the freed time slot immediately becoming available to other customers.

Twilio WhatsApp Integration

Message Handling

• Inbound Webhook — Twilio forwards incoming WhatsApp messages to the backend via webhook
• Session Management — Conversation state tracked per phone number with DynamoDB-backed sessions
• Template Messages — Pre-approved WhatsApp Business templates for outbound notifications
• Free-Form Messages — Within the 24-hour session window, bot sends interactive replies
• Media Support — Business logo, service images, and location maps sent as rich media
• Quick Replies — Interactive button messages for common choices

Automated Notifications

The platform sends a series of automated notifications throughout the booking lifecycle: immediate booking confirmation, a reminder the day before, another reminder shortly before the appointment, a post-visit follow-up requesting feedback, a no-show notification with reschedule option, and a re-engagement message after a configurable period.

Cal.com Integration

Scheduling Engine

• Self-Hosted — Cal.com deployed as a dedicated instance for full data control
• Event Types — Each service mapped to a Cal.com event type with duration, buffer time, and pricing
• Availability Rules — Per-provider availability with recurring schedules, date overrides, and break times
• Calendar Sync — Two-way sync with Google Calendar, Outlook, and Apple Calendar
• Booking API — Cal.com REST API used programmatically by the WhatsApp conversation engine
• Buffer Times — Configurable before/after buffers prevent back-to-back bookings
• Round Robin — "Any available" option distributes bookings across providers evenly

Conflict Prevention

Cal.com checks real-time availability against all synced calendars, uses optimistic locking for concurrent requests, enforces buffer times between appointments, and handles date overrides for holidays and special hours.

Multi-Tenant Architecture

Tenant Isolation

• Each business gets a dedicated WhatsApp number or shared number with keyword routing
• Tenant-scoped DynamoDB queries for all operations
• Separate Cal.com event types and availability per tenant
• Branded message templates with business name and details
• Independent payment accounts for processing

Business Onboarding

New businesses are onboarded through the admin dashboard with automated provisioning of a WhatsApp number, service catalog configuration, provider availability setup with calendar sync, and message template approval — going live within 24 hours.

Admin Dashboard

Business Owner Features

• Service Catalog — Add/edit services with name, duration, pricing, description
• Provider Management — Add staff members, set availability, assign services
• Booking Calendar — Visual calendar showing all upcoming bookings across providers
• Customer Directory — Contact list with booking history and communication log
• Analytics — Booking volume, revenue, no-show rate, popular services, peak hours
• Settings — Business hours, notification preferences, payment configuration

Key Features

1. WhatsApp-Native Booking — Complete booking flow without leaving WhatsApp
2. Real-Time Availability — Cal.com syncs across Google/Outlook calendars instantly
3. Automated Reminders — Multi-stage reminders reduce no-show rate
4. Multi-Tenant SaaS — Shared platform serving multiple businesses independently
5. AI Conversation Engine — ChatGPT-powered context-aware bot remembers where the user left off
6. Payment Links — Stripe-powered deposit collection via WhatsApp message
7. Post-Visit Follow-Up — Automated rating request and re-engagement messages
8. Provider Round Robin — Fair distribution when customer selects "any available"
9. Rich Media — Service images, maps, and branded messages within WhatsApp