WhatsApp webhook troubleshooting
WhatsApp webhook troubleshooting
When the connection looks fine but customer messages never reach ZaxSocial, Meta is usually not delivering webhooks for your number. Check these in order.
Checklist
- Phone Number ID matches the number customers are writing to (Meta App Dashboard › WhatsApp › API Setup).
- WABA ID is the account that owns that number.
- Webhook subscription: in the Meta App Dashboard › WhatsApp › Configuration, the callback URL is set and the messages field is subscribed.
- Access token permissions include
whatsapp_business_messagingandwhatsapp_business_management, and the token has not expired. - App mode: your Meta app is in Live mode. In Development mode only test numbers can message you.
- Selected phone number: the number is registered for Cloud API and not still active in the WhatsApp Business phone app.
Still stuck?
Open WhatsApp › Connection and tap Re-check connection. Then contact support with your Phone Number ID (never send us your token) and the time you sent a test message.