whatsapp_business_management
permission.GET
, POST
, and DELETE
calls to /{whats-app-business-account-id}/subscribed_apps
are now subject to Business Use Case Rate Limits.
Follow our Webhooks Getting Started guide to create your endpoint and configure your Webhooks. When you configure your Webhooks, make sure to choose WhatsApp Business Account
and subscribe to one or more WhatsApp business account fields.
Field Name | Description |
---|---|
| A notification is sent to you when a WhatsApp Business Account (WABA) has been reviewed. |
| A notification is sent to you when a change to your WABA has occured. This change can include phone number update, a policy violation, a WABA has been banned and more. |
| A notification is sent to you when a capability has been updated. This can include a change for the maximum number of phone numbers a WABA can have or conversation per phone number. |
| A notification is sent to you when the message template has been approved or rejected, or if it has been disabled. |
| A notification is sent to you when your business has received a message. |
| A notification is sent to you when the name associated with a phone number has been approved or rejected. |
| A notification is sent to you when the quality-related status for a phone number has an update. |
Visit the
WhatsApp Business Account Webhooks Reference
for more information about each payload field and the
WhatsApp Cloud API Webhooks Reference
for more information on the different types of
messages
notifications you can receive.
You need to subscribe your app to Webhook notifications for the WhatsApp business account. We only send notifications when your Webhooks-configured app is subscribed under the WhatsApp business account, and when the app has permission to edit the WhatsApp business account.
To subscribe your app, have your app send a POST
request to the subscribed_apps
endpoint for the WhatsApp business account:
curl -i -X POST \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<VERSION>/<WHATSAPP_BUSINESS_ACCT_ID>/subscribed_apps"
A successful response will read:
{"success": "true"}
To see which apps your WhatsApp business account has subscribed to, send a GET
request to the subscribed_apps
endpoint.
curl -i -X GET \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<VERSION>/<WHATSAPP_BUSINESS_ACCT_ID>/subscribed_apps"
A successful response will list the subscribed apps:
{ "data": [ { "name": "<APP_NAME>", "id": "<APP_ID>" } ] }
To delete a subscription for an app, send a DELETE
request to the subscribed_apps
endpoint.
curl -i -X DELETE \ -d "access_token=<ACCESS_TOKEN>" \ "https://graph.facebook.com/<VERSION>/<WHATSAPP_BUSINESS_ACCT_ID>/subscribed_apps"
A successful response will read:
{"success": "true"}
If you don't want to subscribe your app with direct API calls, you can easily do it with Graph API Explorer.
Replace the me?fields=id,name
query with <WHATSAPP_BUSINESS_ACCT_ID>/subscribed_apps
. It will subscribe the app you use to send the POST
request in Graph Explorer.
Your app must have permission to edit the WhatsApp business account in order to successfully subscribe.
Example Webhook payload:
[ { "object": "whatsapp_business_account", "entry": [ { "id": "0", "time": 1602782939, "changes": [ { "field": "phone_number_name_update", "value": { "display_phone_number": "16505551111", "decision": "APPROVED", "requested_verified_name": "WhatsApp", "rejection_reason": null } } ] } ] } ]