Automation triggered

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

An automation rule was executed.

Use automation.triggered to record which rule ran for a conversation or to report on rule activity. Group records by data.automation.id; use data.automation.name as the display label and data.automation.trigger_type for the trigger description. If your workflow depends on a specific change, subscribe to its event, such as Agent assigned, Tag assigned, or Conversation resolved. Choose rule activity or the resulting change according to what your integration needs to record.

For signature verification and retries, see Webhooks overview.

POST webhook: automation.triggered

Parameters

Name	In	Required	Type	Description
`X-Chatway-Event`	header	Yes	string	Event name for this delivery. Example: automation.triggered
`X-Chatway-Webhook-Id`	header	Yes	string (uuid)	Unique webhook subscription ID. Example: 9f3c2a1b-4d5e-4f70-8a9b-0c1d2e3f4a5b
`X-Chatway-Delivery-Id`	header	Yes	string	Unique ID for this HTTP delivery attempt (`del_` + 32 hex characters). A new value is sent on each retry. Example: del_1b0279b1f28f12c0b9f2a2fdbf3758ee
`X-Chatway-Delivery-Attempt`	header	Yes	string	Attempt number for this event (`1` on first try). Sent as a decimal string in the header. Example: 1
`X-Chatway-Timestamp`	header	Yes	string	Unix timestamp in seconds when the request was signed. Sent as a decimal string in the header. Example: 1770201001
`X-Chatway-Signature`	header	Yes	string	`sha256=` followed by the lowercase hex HMAC SHA256 of `{X-Chatway-Timestamp}.{raw request body}`, keyed with your webhook secret. The example is computed for the example body serialized as compact JSON, the example timestamp, and the placeholder secret `whsec_exampleSecretForDocsOnly00000000`. Example: sha256=490affb3bafc19ea141001da0e5ff5e3a8cf7f124f1731bb851ab7aad65fb3bc

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 `automation.triggered`.
data (object, required) — Payload for automation.triggered.
- automation (object, required)
  - id (string (uuid), required)
  - name (string, required)
  - trigger_type (string, required)
- 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.
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": "automation.triggered",
    "data": {
        "automation": {
            "id": "c3d327ab-3ef6-4d19-8ee1-11b06c912cd6",
            "name": "Assign Sales Agent",
            "trigger_type": "message_received"
        },
        "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": null
        }
    },
    "occurred_at": "2026-02-04T10:30:00Z",
    "version": "2026-09"
}