POST

Webhook Event: message.sent

Outbound Sent

JSON payload schema dispatched immediately when an outbound message initiated via API is successfully transferred by your device to WhatsApp servers.

Outbound Dispatch Verification

This event confirms that your WhatsApp device hardware processed the send command and successfully handed the message over to Meta WhatsApp edge servers.

HTTP Endpoint

POSThttps://api-wa.hidessh.com/your-configured-webhook-url

Authentication

This endpoint requires Bearer authentication via your secret API Key.

Header Key	Value	Required
Content-Type	application/json	Required
X-Wahide-Secret	whsec_live_...	Required

Request Parameters

The request body must be formatted as JSON with the following parameters:

Parameter	Type	Required	Description
`event`	string	Required	Event identifier. Value is always 'message.sent'. example: message.sent
`device_id`	string	Required	Unique WhatsApp device slot ID that dispatched the message. example: 01JPLAN0000000000000000001
`timestamp`	integer	Required	Unix epoch timestamp in seconds when the message was dispatched. example: 1725845010
`data`	object	Required	Container object holding outbound dispatch details.
`data.message_id`	string	Required	WhatsApp message identifier assigned to the sent message. example: 3EB0F9E8D7C6B5A4
`data.recipient`	string	Required	Destination phone number in E.164 format. example: 6289876543210
`data.recipient_jid`	string	Required	Destination WhatsApp Jabber ID. example: 6289876543210@s.whatsapp.net
`data.text`	string	Required	Text content of the dispatched message. example: Hello, your order #INV-1029 is being processed.
`data.status`	string	Required	Status of the dispatch: 'sent'. example: sent
`data.timestamp`	integer	Required	Unix epoch timestamp when sent. example: 1725845009

Code Examples

request.sh

curl -X POST https://api.your-business.com/webhook \
  -H "Content-Type: application/json" \
  -H "X-Wahide-Secret: whsec_live_9f8e7d6c5b4a3210fedcba9876543210" \
  -d '{
    "event": "message.sent",
    "device_id": "01JPLAN0000000000000000001",
    "timestamp": 1725845010,
    "data": {
      "message_id": "3EB0F9E8D7C6B5A4",
      "recipient": "6289876543210",
      "recipient_jid": "6289876543210@s.whatsapp.net",
      "text": "Hello, your order #INV-1029 is being processed.",
      "status": "sent",
      "timestamp": 1725845009
    }
  }'

Response Formats

Acknowledgment confirming receipt of the outbound sent event.

application/json • 200 OK

{\n  "status": "success"\n}

On this page