Per-tenant Meta Cloud API configuration and diagnostics for /whatsapp.ashx.
This page configures WhatsApp Business API for your tenant. Sign in with an admin OIDC session.
Values from App_Data/<tenant>/chat-whatsapp/config.json. Secrets are masked on load and only sent when the field is edited.
Paste these into your Meta App at developers.facebook.com/apps under WhatsApp → Configuration.
While your Meta App is in unpublished / Development mode, Meta will not forward real WhatsApp messages to this webhook — only synthetic events fired from the Meta Dashboard’s Send test webhook button. To receive real customer messages, you need to complete App Review and publish the app (which in turn requires Business Verification). Outbound send is not affected — it works pre-publish as long as the recipient is on the allowed-tester list.
In the Meta App Dashboard → WhatsApp → Configuration → Webhooks, subscribe to these WhatsApp Business Account fields. Only messages is required for the chat bridge; the rest are recommended so operational events (template approvals, quality drops, account alerts) land in the audit log.
| Field | Purpose | Priority | Our handling |
|---|
GET to our webhook with hub.mode=subscribe. If it fails, check the Verify Token above matches character-for-character what you paste in the Meta Dashboard.
Sends a text message via POST /whatsapp.ashx?action=send. Requires Phone Number ID and Access Token to be filled in.
From the tenant audit log at chat-whatsapp/audit/*.jsonl. Inbound = webhook events from Meta. Outbound = replies you sent.