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.

WEBHOOK

whatsappMessageEcho

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

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

telnyx-timestamp

integer<int64>

required

Unix timestamp (seconds since epoch) of when the webhook was sent - compatible with webhook-timestamp Unix timestamp for replay attack prevention

telnyx-signature-ed25519

string

required

Base64 encoded Ed25519 signature for webhook verification - compatible with webhook-signature Ed25519 signature of timestamp|payload for verification

Body

application/json

data

object

required

Show child attributes

Response

200

Return an HTTP 200 to acknowledge the webhook.

{
  "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": []
    }
  }
}

Getting Started

Sending Messages

Coexistence

Calling

Management API

Sending API

For AI Agents

Whatsapp business app message echo

Authorizations

Headers

Body

Response