Message updated

Incoming webhook deliveries are authenticated with HMAC signature headers (X-Chatway-Signature and X-Chatway-Timestamp), not your Chatway API key.

A chat message was edited.

Triggered when message content or attachments change after an edit from the agent or visitor app.

Internal notes and reminders are not included.

Use message.updated to revise a message already stored in your transcript. Find it by data.message.id, inspect data.updated_fields, and use data.previous_values for the earlier values. Read the edited values from data.message. For example, a content change updates the existing message's text rather than creating another transcript entry. To retrieve conversation history, pass data.conversation.id to List Conversation Messages.

For signature verification and retries, see Webhooks overview.

POST webhook: message.updated

Parameters

Request body

Signed JSON envelope for this event.

application/json

• id (string, required) — Stable event ID (`evt_…`). Same across HTTP retries for this notification.
• event (string, required) — Event name. For this webhook, always `message.updated`.
• data (object, required) — Payload for message.updated.
  • message (object, required)
    • id (string (uuid), required) — Message ID.
    • content (string) — Message text. May be omitted when attachments are present.
    • attachments (array<object>, required) — Zero or more attachment objects. Each item has `content` (URL), optional `type`, `mime`, `original_file_name`, and `size` (bytes)—see Webhooks overview → Field reference → Attachment.
      • content (string, required) — Public URL of the file (up to 2048 characters).
      • type (string) — Logical type (for example image, file, video).
      • mime (string) — MIME type when known.
      • original_file_name (string) — Original filename when available.
      • size (integer|null) — Size in bytes when known.
    • created_at (string (date-time), required) — When the message was created.
    • edited_at (string (date-time))
  • conversation (object, required)
    • id (string (uuid), required) — Conversation ID.
    • channel (string, required) — Normalized channel.
    • status (string, required) — Conversation status.
    • widget_name (string) — Present when the conversation is tied to a website widget.
    • identifier (string) — Widget identifier when widget_name is present.
  • visitor (object, required)
    • id (string (uuid), required) — Visitor/contact ID.
    • name (string) — Visitor name. Omitted when empty.
    • email (string|null, required) — Visitor email. Always present; null when unknown.
    • phone (string|null, required) — Visitor phone. Always present; null when unknown.
  • updated_fields (array<string>, required)
  • previous_values (object, required) — Map of changed field names to values before the update.
• occurred_at (string (date-time), required) — When the business event occurred.
• version (string, required) — Payload schema version.

Responses

200

Return any 2xx status to acknowledge receipt.

410

Optional HTTP 410 Gone to signal the endpoint is permanently unavailable. Like every non-2xx response below 500 (including 408 and 429), it is not retried. It does not disable the subscription; turn the webhook off in Chatway Settings if you want deliveries to stop.

Examples

Request body example

{
    "id": "evt_1234567890abcdef1234567890abcdef",
    "event": "message.updated",
    "data": {
        "message": {
            "id": "679f5ba4-3cbf-42eb-86dc-63566cec6b58",
            "content": "Hello, I need help with my order",
            "attachments": [],
            "created_at": "2026-02-04T10:31:12Z",
            "edited_at": "2026-02-04T10:35:00Z"
        },
        "updated_fields": [
            "content"
        ],
        "previous_values": {
            "content": "Hello, I need help"
        },
        "conversation": {
            "id": "0f46c0a1-8938-40e3-b2b5-bb56f569fcab",
            "channel": "website",
            "status": "open",
            "widget_name": "Main site widget",
            "identifier": "eouqtiupanm6uvglwshy"
        },
        "visitor": {
            "id": "9b0c5fe6-35ad-459d-b6ba-4288191f84f1",
            "name": "John Doe",
            "email": "[email protected]",
            "phone": "+1XXXXXXXXXX"
        }
    },
    "occurred_at": "2026-02-04T10:35:00Z",
    "version": "2026-09"
}