Skip to Content
WhatsAppReceive messages

Receive messages

When someone replies to a WhatsApp message you sent, Retransmit stores the reply and delivers it to your webhook endpoints as a whatsapp.received event. There is nothing to configure on the WhatsApp side: create an endpoint in the dashboard and subscribe it to whatsapp.received.

Every message sent to one of your connected numbers is yours, whether or not you messaged the sender first. When the sender quoted one of your messages, data.replyToMessageId carries that message’s id.

Payload

{ "id": "whd_xxxxxxxxxxxx", "type": "whatsapp.received", "created_at": "2026-09-01T12:05:00.000Z", "data": { "inboundId": "wai_xxxxxxxxxxxx", "accountId": "wab_xxxxxxxxxxxx", "from": "+237670000000", "to": "+237650000000", "profileName": "Amina", "type": "text", "text": "Thanks, on my way", "replyToMessageId": "wa_xxxxxxxxxxxx", "providerMessageId": "wamid.HBgMMjM3Njc...", "receivedAt": "2026-09-01T12:04:58.000Z", "data": { "from": "237670000000", "id": "wamid.HBgMMjM3Njc...", "timestamp": "1788350698", "type": "text", "text": { "body": "Thanks, on my way" } } } }
FieldDescription
accountIdThe connected number’s id, as shown in the dashboard.
fromThe sender, in E.164 format.
toYour connected number that received the message.
typeWhatsApp message type: text, image, document, audio, video, sticker, location, button, interactive, or reaction.
textBest-effort text: the body for text, the caption for media, the selected option for button and interactive, the emoji for reaction, and lat,lng for location. null when there is none.
replyToMessageIdYour message’s id when the sender quoted it, else null.
dataThe raw WhatsApp message object, for anything the fields above do not cover.

Replying

A reply from the customer opens a 24-hour customer service window. Inside it you can answer with free-form text or media through Send WhatsApp without a template.

Last updated on