Conversation resolved
Incoming webhook deliveries are authenticated with HMAC signature headers (X-Chatway-Signature and X-Chatway-Timestamp), not your Chatway API key.
A conversation was resolved by an agent, automation, or system.
resolved_by uses the same object shape as assigned_by on tag.assigned and agent.assigned: agent, automation, or system.
POST webhook: conversation.resolvedParameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
X-Chatway-Event | header | Yes | string | Event name for this delivery. Example: conversation.resolved |
X-Chatway-Webhook-Id | header | Yes | string (uuid) | Unique webhook subscription ID. Example: 9f3c2a1b-4d5e-6f70-8a9b-0c1d2e3f4a5b |
X-Chatway-Delivery-Id | header | Yes | string | Unique ID for this HTTP delivery attempt (`del_…`). Example: del_456 |
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: 1785933000 |
X-Chatway-Signature | header | Yes | string | HMAC SHA256 signature prefixed with `sha256=`. Example: sha256=3c9f5e2b1a0d4c8f7e6a5b4c3d2e1f0a9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4 |
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 `conversation.resolved`.data (object, required)— Payload for conversation.resolved.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.resolved_at (string (date-time))
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.
agent (object, required)id (string (uuid), required)— Agent ID.name (string, required)— Agent display name.email (string)— Agent email when available.
resolved_by (object, required)— Who performed the action. Contains exactly one of: agent, automation, or system.agent (object)id (string (uuid), required)— Agent ID.name (string, required)— Agent display name.email (string)— Agent email when available.
automation (object)id (string (uuid), required)name (string, required)
system (object)
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. This delivery is not retried (same as other `4xx` responses). Disable the subscription in Chatway Settings if you want deliveries to stop.
Examples
Request body example
{
"id": "evt_1234567890abcdef1234567890abcdef",
"event": "conversation.resolved",
"data": {
"conversation": {
"id": "conv_123",
"channel": "website",
"status": "resolved",
"widget_name": "Main site widget",
"identifier": "wdg_abc123",
"resolved_at": "2026-02-04T11:00:00Z"
},
"visitor": {
"id": "vis_456",
"name": "John Doe",
"email": "[email protected]",
"phone": null
},
"agent": {
"id": "agent_789",
"name": "Sarah",
"email": "[email protected]"
},
"resolved_by": {
"agent": {
"id": "agent_789",
"name": "Sarah",
"email": "[email protected]"
}
}
},
"occurred_at": "2026-02-04T11:00:00Z",
"version": "2026-09"
}