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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.hypersender.com/llms.txt

Use this file to discover all available pages before exploring further.

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.