WhatsApp Business Cloud API
Connect your official Meta WhatsApp Business number with Embedded Signup (EFS), understand the 24-hour messaging window, and generate deep links and QR codes.
Connect via Meta Embedded Signup (EFS)
Omni Chat Stack is an official Meta Tech Provider. You connect your WhatsApp Business Account (WABA) directly through Meta’s Embedded Flow Signup without third-party BSP markups or manual webhook copying.
Open Channels → Connect WhatsApp
Go to /channels and click Connect WhatsApp. The frontend fetches your tenant EFS config from GET /api/v1/whatsapp/efs/config.
Authorize in Meta pop-up
Log into Facebook Business Manager, select or create your WABA, and choose either a fresh API number or Coexistence mode with your existing WhatsApp Business App number.
Exchange token & activate webhook
Omni Chat Stack exchanges the authorization code (/efs/exchange-token), encrypts credentials at rest, subscribes Meta webhooks (/efs/complete-setup), and activates your channel.
Supported message formats & 24-hour window
| Message Type | 24h Session Required? | Details |
|---|---|---|
| Text Messages | Yes (free-form) | Supports emojis, formatting, URL previews, and AI/bot replies. |
| Media Messages | Yes | Images (JPG/PNG), Video (MP4/MOV), Audio (OPUS/MP3), and Documents (PDF/DOC/XLS) up to 10 MB. |
| Interactive Buttons & Lists | Yes | Quick-reply buttons (up to 3) and expandable section list menus. |
| Approved Templates | No (opens new 24h window) | Utility, Marketing, and Authentication templates approved by Meta. |
| Catalog & Product Messages | Yes | Single-product and multi-product interactive commerce messages. |
24-hour customer service window
Meta allows free-form text, media, and interactive messages for 24 hours after the customer’s last inbound message. Outside that window, send an approved WhatsApp Template from the inbox composer or Campaigns.
Deep links, QR codes & phone validation
Use POST /api/v1/whatsapp/deep-links/generate to create custom wa.me links with pre-filled messages and downloadable QR codes for packaging, storefronts, or email signatures. Phone formatting can be verified programmatically via POST /api/v1/whatsapp/validate-phone.