Message Status Webhook
Webhook Request Method
Webhook Payload
| Parameter |
type |
Mandatory |
Description |
| event |
string |
Yes |
This is set to "message_status_update" |
| business_phone |
string |
No |
Business phone number |
| message_id |
string |
Yes |
Message ID |
| message_status |
string |
Yes |
Message status, one of "sent", "failed", "delivered", "read" |
| error |
object|null |
Yes |
Error details，default is set to null. |
| error.title |
string |
No |
Service provider-defined error title. |
| error.code |
int |
No |
Service provider-defined error code. |
| received_at |
timestamp |
Yes |
Webhook received timestamp. |
Webhook Sample
{
"event": "message_status_update",
"business_phone": "6281519236680",
"message_id": "wamid.HBgNNjI4OTY1MjQ1NjU0OBUCABEYEkYxNTY4NkNBRUY...",
"message_status": "failed",
"error": {
"code": 131049,
"title": "This message was not delivered to maintain healthy ecosystem engagement."
},
"received_at": 1754466101
},
