WhatsApp: message delivered, read, edited or deleted

A message delivered (message_delivered), read (message_read, with read_by), edited (message_edited, with the new message) or deleted (message_deleted, with deleted_for).

Header Parameters

X-LG-Signature*string

base64url(HMAC-SHA256(raw body, your webhook's signing secret)), the secret being the whsec_… shown in the console. Verify it over the raw bytes before parsing, and refuse the event when it does not match.

X-LG-Event-Id*string

The event id, also event_id in the body: the same on every retry of the event. Deduplicate on it.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

event*string

The event's name: message_received, message_delivered, message_read, message_edited, message_deleted, message_reaction or gateway.message_failed.

Value in

"message_delivered"
"message_read"
"message_edited"
"message_deleted"

account_id*string

The WhatsApp number (wa_…).

account_type?string

Always WHATSAPP.

account_info?

The number itself.

chat_id*string

The chat (wac_…), as GET /whatsapp/api/v1/chats/{id} takes it.

timestamp?|

When the message was sent (UTC, ISO 8601); null when WhatsApp gave no time.

Formatdate-time

message_id*string

The message (wam_…), as GET /whatsapp/api/v1/messages/{id} takes it: the same id on all of a message's events.

provider_chat_id?string

The chat's WhatsApp JID: …@s.whatsapp.net or …@lid for a person, …@g.us for a group.

provider_message_id?string

WhatsApp's own id for the message.

is_group?boolean

true when the chat is a group.

is_sender?boolean

true when the number itself sent the message (through the API or from any of its devices).

read_by?string

message_read only: the JID of who read it; in a group, one event per reader.

message?|

message_edited: the new text.

deleted_for?string

message_deleted only: everyone (deleted for the whole chat) or me (only on this number's side).

Value in

"everyone"
"me"

event_id*string

The event's id, also in the X-LG-Event-Id header: the same on every retry of the event, so deduplicate on it. A random UUID, or ev_… for an event about one thing (a message, a connection) noticed twice.

emitted_at*string

When Swarmhit wrote the event (UTC, ISO 8601), not when it was delivered. A retry keeps it: for statuses, keep the one with the newest emitted_at.

Formatdate-time

livemode?boolean

true for an event of a live account, false for a sandbox account's (sent to your sandbox webhook).

Response Body

Example Requests

POST/WhatsappMessageChanged

Header Parameters

Request Body

Response Body

200

Request Bodyapplication/json

Header Parameters