WhatsApp (Meta)

WhatsApp is connected as a channel master under Integrations. Spinners then select that master when sending templates.

OAuth connect

1. Configure on the API server:
   • META_APP_ID
   • META_APP_SECRET
   • PUBLIC_API_URL (must be your public HTTPS API, for example https://api.cxgear.ai)
2. In the Meta Developer app, under Facebook Login → Settings, add this Valid OAuth Redirect URI exactly:

https://api.cxgear.ai/api/v1/channels/whatsapp/oauth/callback

3. In CXGear, open Channels → WhatsApp and click Connect with Meta.

CXGear requests only:

• whatsapp_business_management
• whatsapp_business_messaging

(business_management is not requested — it is invalid for many app types.)

Screenshot needed

WhatsApp section with Connect with Meta button.

Where: Integrations → Channels → WhatsApp

Save as: src/assets/screenshots/22-whatsapp-connect.png

Webhook URL

After connect, register the webhook URL Meta shows you (includes the provider id):

https://api.cxgear.ai/api/v1/channels/whatsapp/webhook/{providerId}

Manual token

If OAuth is not available, paste a permanent system-user token, phone number id, and WABA id. Tokens are stored in the vault.

Development mode note

While the Meta app is in Development mode, only app admins, developers, and testers can complete OAuth. Live mode requires App Review for advanced access.

Next

• Channel steps
• Environments