How to Get Updates of WhatsApp Broadcast Status

WhatsApp Broadcast is a powerful feature that allows you to send messages to multiple recipients simultaneously. However, tracking the status of your broadcast can be crucial to ensure its success. You have the option to send WhatsApp broadcasts either through the omnichannel dashboard or via API. 

It's important to note that when using the WhatsApp Broadcast API, the status updates may not be instantaneous. You may receive success or failure responses directly returned from the API response. However, certain status updates might be given later as they require some processing within WhatsApp before being delivered to the end customers.

In this article, we will guide you on how to get updates on the status of your WhatsApp Broadcast using various ways.

Get Updates from the Omnichannel Dashboard - Outbound Message

The Omnichannel Dashboard provides a comprehensive overview of your WhatsApp Broadcast activity. Follow these steps to access the status updates:

1. Login to your Omnichannel Dashboard account.
2. Navigate to the "Outbound Message" section.
3. Select "WhatsApp Broadcast" from the available options.
4. Here, you will find a log that displays the status of each broadcast job.
5. If you have sent the broadcast using a CSV file, the log may contain multiple phone numbers. Click on the details of the broadcast job to view the individual status updates for each recipient.

Get Updates from Omnichannel Dashboard - Analytics

The Analytics section in your Omnichannel Dashboard provides detailed insights into your WhatsApp Broadcasts. Follow these steps to access the status updates:

1. Login to your Omnichannel Dashboard account.
2. Navigate to the "Analytics" section.
3. Select "WhatsApp", then choose "General" section from the available options.
4. Look for the "Broadcast Logs" section, which displays a comprehensive log of your broadcasts.
5. In this log, you can view the detailed status updates for each phone number.

Get Updates via Webhook

If you send WhatsApp broadcasts through an API and want to create your own reporting system within your internal system, utilizing webhooks is an ideal approach. Webhooks provide a mechanism for receiving real-time updates on new messages and any message statuses. Follow these steps to implement a webhook-based solution:

1. Set Webhook URL:

   • Implement a webhook endpoint in your internal system. This endpoint should be capable of receiving HTTP POST requests.
   • Ensure that the webhook endpoint is publicly accessible and secure.
   • Set your webhook URL to Omnichannel with this API. You will get this response if success.

     {
       "business_id": "101764325971xxx",
       "status": 200,
       "webhooks": {
          "url": "YOUR_DOMAIN_URL.com/receive_webhooks"
       }
     }

2. Send WhatsApp Template Broadcast:

   • Utilize the WhatsApp Broadcast API to send your messages to the desired recipients. See our documentation or Send WhatsApp Business API with Different Types of Template to get the sample API payload.
   • Make note of the message ID provided in the API response for each broadcast.

     {
       "contacts": [
         {
          "input": "62812xxxxxxxx",
          "wa_id": "62812xxxxxxxx"
         }
       ],
       "messages": [
         {
          "id": "wamid.HBgNNjI4Nzg4NzA3MDAyMxUCABEYEjIxRDhDQzcyMUY2MTgwNTVBQgA="
         }
       ],
       "messaging_product": "whatsapp"
     }

3. Store Message ID:

   • Capture and store the message ID associated with each broadcast in your internal database or system. This ID will be used to match incoming webhook updates with the corresponding messages.

4. Listen to Webhook Updates:

   • Configure the webhook URL you set up in Step 1 in your WhatsApp Broadcast API settings.
   • Start listening to incoming webhook notifications on your endpoint.

5. Match Message ID and Update Status:

   • Whenever a webhook notification is received, extract the message ID from the payload.
   • Match the message ID to the corresponding record in your internal database or system.
   • Update the status of the message based on the information provided in the webhook payload. This may include updates such as sent, delivered, read or failed.

Sample webhook payload:

{
  "app_code": "ramo-29xxxx",
  "channel_id": xxxx,
  "display_phone_number": "62812xxxx",
  "phone_number_id": "26142xxxxx",
  "statuses": [
   {
     "conversation": {
        "id": "82262311be09b56761609eeb073d097e",
        "origin": {
           "type": "marketing"
         }
     },
    "id": "wamid.HBgNNjI4Nzg4NzA3MDAyMxUCABEYEjIxRDhDQzcyMUY2MTgwNTVBQgA=",
    "pricing": {
       "billable": true,
       "category": "marketing",
       "pricing_model": "CBP"
     },
     "recipient_id": "62812xxxx",
     "status": "delivered",
     "timestamp": "1688542265"
   }
  ]
}

In case you encounter failed broadcasts, you can refer to the article Failed WhatsApp Broadcast Message with CSV or API for troubleshooting and possible solutions.

By utilizing the Omnichannel Dashboard, Analytics, and Webhooks, you can effectively track the status of your WhatsApp Broadcast and ensure that your messages reach the intended recipients.