Whatsapp business app message echo
Delivers a non-billable mirror of a message sent from the WhatsApp Business app on a coexistence-enabled number. This outbound event does not open or extend the Cloud API customer service window.
This webhook uses Telnyx headers (telnyx-timestamp, telnyx-signature-ed25519) that are compatible with Standard Webhooks specification for SDK generation. Custom validation logic can map these to standard webhook-timestamp and webhook-signature equivalents. See https://github.com/standard-webhooks/standard-webhooks for details.
{
"data": {
"record_type": "event",
"id": "4f923db9-186f-4c6a-9a14-0b6d46e31d77",
"event_type": "message.echo",
"occurred_at": "2026-09-02T10:15:30.000Z",
"payload": {
"record_type": "message",
"direction": "outbound",
"origin": "whatsapp_business_app",
"id": "c7b87bc9-d220-4b2c-916a-83c11ef9821f",
"type": "WHATSAPP",
"organization_id": "7a7f45eb-6670-45fd-a3e3-5b9e4a4f2103",
"messaging_profile_id": "4001799e-1457-4c7f-a96a-735ed44c7de7",
"from": {
"phone_number": "+13125551234",
"carrier": "",
"line_type": ""
},
"to": "+18655550001",
"body": {
"from": "+18655550001",
"id": "c7b87bc9-d220-4b2c-916a-83c11ef9821f",
"foreign_id": "wamid.HBgLMTg2NTU1NTAwMDEFQIAERgSODQ2",
"timestamp": "1788344130",
"type": "text",
"text": {
"body": "Sent from the WhatsApp Business app"
}
},
"tags": [],
"cost": {
"amount": null,
"currency": null
},
"received_at": "2026-09-02T10:15:29.000Z",
"errors": []
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp Unix timestamp for replay attack prevention
Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification
Body
Show child attributes
Show child attributes
Response
Return an HTTP 200 to acknowledge the webhook.
Was this page helpful?
{
"data": {
"record_type": "event",
"id": "4f923db9-186f-4c6a-9a14-0b6d46e31d77",
"event_type": "message.echo",
"occurred_at": "2026-09-02T10:15:30.000Z",
"payload": {
"record_type": "message",
"direction": "outbound",
"origin": "whatsapp_business_app",
"id": "c7b87bc9-d220-4b2c-916a-83c11ef9821f",
"type": "WHATSAPP",
"organization_id": "7a7f45eb-6670-45fd-a3e3-5b9e4a4f2103",
"messaging_profile_id": "4001799e-1457-4c7f-a96a-735ed44c7de7",
"from": {
"phone_number": "+13125551234",
"carrier": "",
"line_type": ""
},
"to": "+18655550001",
"body": {
"from": "+18655550001",
"id": "c7b87bc9-d220-4b2c-916a-83c11ef9821f",
"foreign_id": "wamid.HBgLMTg2NTU1NTAwMDEFQIAERgSODQ2",
"timestamp": "1788344130",
"type": "text",
"text": {
"body": "Sent from the WhatsApp Business app"
}
},
"tags": [],
"cost": {
"amount": null,
"currency": null
},
"received_at": "2026-09-02T10:15:29.000Z",
"errors": []
}
}
}