Other Webhooks

In this section, you will be acquainted with the other Whatsapp Webhooks.
Other than managing your received messages and getting updates on your message delivery status, you may also get updates on your number quality, template status and whether your wab number has reached its daily limits.

📘

Email alerts

You are automatically subscribed to email alerts for Phone Number Quality Change and Template Status Change

Unifonic's conversation platform allows you to configure multiple webhook URLs

Configuring Webhook URLs

  1. Navigate to the Channels > WhatsApp.

  1. Click the Edit button, and navigate to the WEBHOOK tab.

  1. Click ADD NEW to paste the webhook URL on which the user would like to receive the incoming webhook responses for received messages

📘

Tip

Getting updates about your template status change allows you to manage your outreach campaign strategy. If a template is paused due to user reports, you might want to use another number or template to reach your end users.

Sample Webhook Payload

Daily Limit Hit

If the daily limit is reached, any further attempts to send an outbound message would result in this webhook notification. To discover more about daily limits, please read this guide.

{
   "messageId":"0ca154f7-ebd9-473d-86d6-5b28373b6fced",
   "eventId":"d0bfa5ce-8172-43c1-8ueh-d72a16ea029d",
   "eventType":"message.daily_limit_hit",
   "applicationId":"a95c8wjhe-71b3-2718-958d-1dcf29j1ee1a",
   "conversationId":"959e62739-521a-XXXX-8676-c58XXo986811d",
   "recipient":{
      "channel":"whatsapp",
      "contact":"+XXXXXXXXXXX"
   },
   "timestamp":"2023-06-14T14:23:04.000Z",
   "receivedAt":"2023-06-14T14:23:04.94Z"
}

Phone Number Quality Change

If there is a change in Number Quality, a webhook notification will be sent. Phone number quality is usually negatively affected by end users' activities. i.e. some end users have reported or blocked your whatsapp number. Or other occasions, it is merely because you have reached your daily limit and it is time to cool down your outreach!

The good thing is, phone number quality recovers after a few days of no-activity. To discover more about phone number quality, please read this guide.

{
   "eventId":"229ksi9a-09bb-472d-XX64-b288e7hay3a8",
   "eventType":"message.phone_number_updated",
   "applicationId":"bfa22222-XX91-4XX-be09-40d2LLLLd9f6",
   "timestamp":"2023-05-22T07:41:10.015Z",
   "qualityScore":"GREEN",
   "status":"CONNECTED",
   "verifiedName":"Unifonic Test",
   "messagingLimitTier":"TIER_1K"
}

Template Status Change

Template status may change from time to time. For example, a template status would be pending for approval after submission. A template status may also change if a message was reported multiple times by end users, read this guide to find out more about the various template statuses.

{
   "eventType":"message.template_status_update",
   "applicationId":"imH2878e-7XX7-4XXc-8ca5-6123988334iyea9",
   "status":"APPROVED",
   "messageTemplateId":"126835237630505",
   "messageTemplateReason":"NONE",
   "messageTemplateName":"optin_campaign_ar",
   "wabAccountId":"0998416343264658169",
   "timestamp":"2023-05-17T07:49:09.201Z",
   "receivedAt":"2023-05-17T07:49:09.201707Z",
   "messageId":"None"
}
Possible values - status
APPROVED, IN_APPEAL, PENDING, REJECTED, PENDING_DELETION, DELETED, DISABLED, PAUSED