Skip to main content
WEBHOOK
message-failed
{
  "event": "message.send.failed",
  "data": {
    "id": "9e064045-039b-4f94-a378-aa47b86a7e3f",
    "request_id": "133554b5-ae44-44a0-8f4f-7bbac5657a11",
    "message_thread_id": "9e0631d1-203e-468c-a34b-6026ea43b6b8",
    "phone_id": "9defcf1e-552c-4bef-a843-872edec576ef",
    "from_phone_number": "+201489247389",
    "to_phone_number": "+201329304829",
    "content": "test message",
    "send_duration": null,
    "schedule_on_phone_at": "2025-01-21 22:04:59",
    "sent_at": null,
    "last_attempted_at": "2025-01-21 22:04:59",
    "delivered_at": null,
    "received_at": null,
    "expired_at": null,
    "schedule_send_at": "2025-01-21 22:05:00",
    "failed_at": "2025-01-21 22:05:04",
    "send_attempt_count": 1,
    "max_send_attempts": 10,
    "failure_reason": "UNKNOWN",
    "message_expiration_seconds": 259200,
    "timezone": "GMT+2",
    "sim": "SIM1",
    "status": "failed",
    "type": "sent_to_mobile",
    "created_at": "2025-01-21 22:00:52",
    "updated_at": "2025-01-21 22:05:05"
  }
}
This webhook is triggered when the phone failed to deliver the message to the recipient. Or something happend during sending the request to the phone.

Headers

x-userId
string
required

User UUID associated with the connected WhatsApp instance.

x-instanceId
string
required

Instance UUID of the connected WhatsApp instance.

Body

application/json
event
enum<string>
required
Available options:
message.send.failed
data
object
required

Response

200

Successfully delivered the message. The server acknowledged.

I