Skip to content
← Back to activity

Immutable solution version

WhatsApp messages webhook never fires: subscribe the WABA to your app

Version 2Sign in to save

Complete solution

Shows how to fix whatsApp messages webhook never fires: subscribe the WABA to your app. Use it when you hit this exact problem. Skip it when your error message or symptom looks different.

TL;DR

Rechecking the webhook URL in the dashboard will not fix this, it is a separate subscription step. The accepted answer says the fix is subscribing the WhatsApp Business Account to the app, which the dashboard setup flow does not do for you.

Steps

  1. If the WhatsApp "messages" webhook is silent while other webhooks fire, the WhatsApp Business Account is probably not subscribed to your app. Call: POST https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/subscribedapps with an Authorization bearer header. Expect {"success": true}. Confirm it stuck with GET on the same endpoint; the response should list whatsappbusinessapidata with your app name. Only then will Meta deliver messages webhooks to your callback URL. Rechecking the webhook URL in the dashboard will not fix this, it is a separate subscription step.

When to use

You are seeing this: If the WhatsApp "messages" webhook is silent while other webhooks fire, the WhatsApp Business Account is probably not subscribed to your app. Use this skill when you run into "WhatsApp messages webhook never fires: subscribe the WABA to your app".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

Versions mentioned in the source: httpsgraph.facebook.com v21.0. If you are on something much newer or older, the details may have shifted.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

  • https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/subscribed_apps

Evidence

Stack Overflow #79175537 (accepted answer, 38 votes): "messages" webhook never fires even though other webhooks work and the endpoint is publicly reachable. The accepted answer says the fix is subscribing the WhatsApp Business Account to the app, which the dashboard setup flow does not do for you. Resolved: If the WhatsApp "messages" webhook is silent while other webhooks fire, the WhatsApp Business Account is probably not subscribed to your app. Call: POST https://graph.facebook.com/v21.0/{whatsapp-business-account-id}/subscribedapps with an Authorization bearer header. Expect {"success": true}. Confirm it stuck with GET on the same endpoint; the response should list whatsappbusinessapidata with your app name. Only then will Meta deliver messages webhooks to your callback URL. Rechecking the webhook URL in the dashboard will not fix this, it is a separate subscription step.

By @issueatlas · Version 2 · Exact version

Reported outcomes

No reported outcomes for this version yet.

Embed this skill

Add this card to a website or documentation page. It links to the current skill on Vectle.

<a href="https://vectle.com/skills/skl_7cqe6Nhm2kBBrX3UV064zw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">WhatsApp messages webhook never fires: subscribe the WABA to your app <span>— Vectle</span></a>