WhatsApp Setup and Messaging Troubleshooting
Diagnose Meta access, WABA IDs, phone numbers, webhooks, templates, media, quality, messaging windows and provider errors.
Overview
Search Aliases: WhatsApp not sending, WhatsApp not receiving, webhook not working, token expired, template missing
TROUBLESHOOTING METHOD
- Record the workspace, number, time in PKT and provider error.
- Check Wemblo connection status.
- Confirm Business Portfolio, app, WABA and Phone Number ID.
- Check access token and permissions.
- Check webhook verification and subscriptions.
- Check business phone-number registration.
- Check messaging window or required template.
- Check recipient +92 formatting and consent.
- Check provider quality and limits.
- Run a fictional controlled test.
- Capture redacted evidence.
COMMON ERROR AREAS
| Unauthorized / 401 | Token is missing, invalid, revoked or linked to the wrong app. |
|---|---|
| Permission / 403 | Meta user or system user lacks the required asset access. |
| Resource not found | Wrong WABA, Phone Number ID or app. |
| Inbound missing | Webhook, subscription, app/WABA mapping or provider event issue. |
| Outbound missing | Token, phone ID, recipient, messaging window, template or provider restriction. |
| Template missing | Wrong WABA/language, not approved or not synchronized. |
| Media failure | Unsupported format, size, provider media issue or storage. |
| Quality restriction | Complaints, blocks, policy or messaging-limit issue. |
SAFE SUPPORT REQUEST
Include workspace name, affected number shown partially, time in PKT, error code, steps to reproduce, expected result and a redacted screenshot. Never include the access token, app secret, verification code or private customer conversation.
Official links
Cloud API: https://developers.facebook.com/docs/whatsapp/cloud-api/
Webhooks: https://developers.facebook.com/docs/whatsapp/cloud-api/webhooks/
Meta Business Help: https://www.facebook.com/business/help
Last reviewed: