Skip to content

Connect WhatsApp Business

View as Markdown

The WhatsApp channel (/{slug}/channels/whatsapp) connects WhatsApp Business Cloud API (WABA) phone numbers to your workspace for unified Inbox messaging and AI Bot automation.

  • A Meta Business / WhatsApp Business Account (WABA) with at least one registered phone number on the WhatsApp Cloud API.
  • Browser popups enabled for the Meta OAuth sign-in window.
  1. Go to Channels → WhatsApp (or All Channels), click Add Channel, and choose WhatsApp.
  2. Verify the Meta App ID at the bottom of the dialog (loaded automatically from system config; click the App ID if you need to override it with a custom Meta App).
  3. Click Connect Now to open the Meta OAuth (v21.0) popup and grant:
    • whatsapp_business_management
    • whatsapp_business_messaging
  4. After authorization, OmnyBot retrieves the phone numbers associated with your WABA (showing the display phone number, verified name, and Phone Number ID).
  5. Select the desired phone number and click Confirm Connection.
  • Assign AI Bot & Toggle AI: Manage directly from the channels table (workspace:manage).
  • Open Channel Inbox: Click the WhatsApp channel name to open its dedicated conversation view.
  • Disconnect WhatsApp: Open the ⋮ menu at the end of the row and select Disconnect (nick:delete).