Receive Updates about Messaging Limits using Webhooks

WhatsApp webhook

You can receive information about any changes to your WhatsApp number rating by means of Webhook generated by Kaleyra. Whenever there is a change in the status (messaging limit) of your Whatsapp number, a webhook is sent from Kaleyra to your system.
The webhook is sent by means of HTTP call using GET method to the incoming URL you have set for receiving incoming messages.

The messaging limit of a phone number depends on the 'quality rating' of a phone number.

📘

Note:

In order to get notified about the message limit status change of a phone number through a webhook, contact the Kaleyra support team. Refer to the page Contact Kaleyra Support Team for more details.

Webhook URL

The following example gives a notification about a phone number getting into 'flagged' status (quality rating) and is currently in the messaging limit of 10k customers for business initiated conversations.

The table below describes the parameters passed in the GET URL used for notifying the phone number current limit.

https://${client_url}?display_phone_number=16505551111&event=FLAGGED&current_limit=TIER_10K

📘

Note:

If you do not have a URL already set for receiving incoming messages, as soon as you set one (even if you are not expecting any incoming message), you will start receiving webhooks about your phone number quality rating.

The table below describes the parameters passed in the HTTP call used for notifying the phone number current limit.