๐ฌ WhatsApp Business
Connect a WhatsApp Business account to send + receive messages from inside the unified Synalux chat surface.
๐จ WhatsApp Business Cloud API
- Webhook ingress โ
/api/v1/whatsapp/webhookreceives incoming messages, validates Metaโs signature, and surfaces them in the chat thread. - Outbound โ
/api/v1/whatsapp/sendposts to Metaโs Cloud API. Workspace-scoped credentials (Phone Number ID + access token). - Templates โ pre-approved message templates for transactional sends (appointment reminders, intake confirmations).
- Media โ text, images, documents, audio, location pins. Audio runs through Transcription on receipt.

๐ Setup
- Create a Meta Business + WhatsApp Business app at business.facebook.comย .
- Generate a permanent System User access token; paste into Synalux workspace settings.
- Configure webhook URL
https://synalux.ai/api/v1/whatsapp/webhookwith your verify token. - Subscribe to
messages+message_statusevents.
The in-app setup guide modal (/chat) walks you through every step with the exact field names from the Meta dashboard.
๐๏ธ Architecture
POST /api/v1/whatsapp/webhook Meta webhook ingress (signature-validated)
POST /api/v1/whatsapp/send Outbound (template or freeform within 24h window)
GET /api/v1/whatsapp/templates List approved templates for the workspaceProvider abstraction: lib/message-providers/whatsapp.ts matches the generic shape (Gmail / Telegram / SMS / etc.).
โ๏ธ HIPAA + Compliance
WhatsAppโs terms restrict PHI for non-Meta-BAA accounts. Synalux flags any message that looks PHI-bearing and requires explicit workspace-admin opt-in to send via WhatsApp. Signed BAA with Meta is on the customerโs roadmap.
๐ณ Plans
Available on Standard+. Free tier: receive only via the contact form.