---
title: "WhatsApp Business App Message Echo"
method: POST
path: "whatsappMessageEcho"
tags: ["Callbacks"]
---

# WhatsApp Business App Message Echo

`POST whatsappMessageEcho` (webhook)

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.

## Headers

- `telnyx-timestamp` integer, required — Unix timestamp for replay attack prevention
- `telnyx-signature-ed25519` string, required — Ed25519 signature of timestamp|payload for verification

## Payload

- WhatsappMessageEchoEvent
  - `data` WhatsappMessageEcho, required
    - `record_type` 'event', required
    - `id` string, uuid, required
    - `event_type` 'message.echo', required
    - `occurred_at` string, date-time, required
    - `payload` WhatsappMessageEchoPayload, required
      - `record_type` 'message', required
      - `direction` 'outbound', required — Indicates that the business sent the message to the WhatsApp user.
      - `origin` 'whatsapp_business_app', required — Identifies the WhatsApp Business app as the source of the message.
      - `id` string, uuid, required — Telnyx identifier for the mirrored message.
      - `type` 'WHATSAPP', required
      - `organization_id` string, uuid, required
      - `messaging_profile_id` string, uuid, required
      - `from` object, required
        - `phone_number` string, required — Coexistence-enabled business phone number in E.164 format.
        - `carrier` string
        - `line_type` string
      - `to` string, required — WhatsApp user who received the Business app message.
      - `body` object, required — Mirrored WhatsApp message content. The content property matches the value of `type`.
        - `from` string — WhatsApp user who received the message.
        - `from_user_id` string — Opaque recipient identifier when Meta does not supply a phone number.
        - `id` string, uuid, required — Telnyx identifier for the mirrored message.
        - `foreign_id` string, required — Meta WhatsApp message identifier, also known as a wamid.
        - `timestamp` string, required — Unix timestamp supplied by Meta.
        - `type` string, required — WhatsApp message content type.
      - `tags` string[]
      - `cost` object, required — No charge is created for a Business app message echo.
        - `amount` string, nullable
        - `currency` string, nullable
      - `received_at` string, date-time
      - `webhook_url` string, uri, nullable
      - `webhook_failover_url` string, uri, nullable
      - `errors` MessagingError0b38e7044b[], required
        - `code` string, required
        - `title` string, required
        - `detail` string
        - `source` object
          - `pointer` string, json-pointer — JSON pointer (RFC6901) to the offending entity.
          - `parameter` string — Indicates which query parameter caused the error.
        - `meta` object

## Acknowledgement `200`

Return an HTTP 200 to acknowledge the webhook.

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/673109139443?raw)