conversation.closed

Тело запроса POST на адрес подписки. Заголовки, подпись и повторы описаны в гайде «Вебхуки».

Схема conversation.closed.v1 собрана из src/backend/contracts/integrations/webhooks/conversation.closed.v1.json при сборке портала.

Поля

Closed

Поле	Тип	Обязательное	Описание
conversation	Conversation	да
cycle	integer	да
event_id	string (uuid)	да
occurred_at	string (date-time)	да
resolution	string	да
schema_version	integer	нет	По умолчанию 1.
status	ConversationStatus	да
type	"conversation.closed"	да	Вид варианта: всегда conversation.closed.

Conversation

Поле	Тип	Обязательное	Описание
customer_id	string (uuid)	да
id	string (uuid)	да
identities	массив Identity	да
number	string	да
queue_id	string (uuid) или null	нет	По умолчанию null.

Identity

Подтверждённая личность клиента: по ней система находит его у себя.

Поле	Тип	Обязательное	Описание
external_id	string	да
namespace	string	да

ConversationStatus

Состояние обращения, как его видит организация: без внутренних оттенков очереди.

Значения: "assigned", "at_bot", "closed", "on_hold", "resolved", "waiting".

JSON Schema

{
  "$defs": {
    "Closed": {
      "properties": {
        "conversation": {
          "$ref": "#/$defs/Conversation"
        },
        "cycle": {
          "type": "integer"
        },
        "event_id": {
          "format": "uuid",
          "type": "string"
        },
        "occurred_at": {
          "format": "date-time",
          "type": "string"
        },
        "resolution": {
          "type": "string"
        },
        "schema_version": {
          "default": 1,
          "type": "integer"
        },
        "status": {
          "$ref": "#/$defs/ConversationStatus"
        },
        "type": {
          "description": "Вид варианта: всегда `conversation.closed`.",
          "enum": [
            "conversation.closed"
          ]
        }
      },
      "required": [
        "type",
        "event_id",
        "occurred_at",
        "conversation",
        "status",
        "resolution",
        "cycle"
      ],
      "title": "Closed",
      "type": "object"
    },
    "Conversation": {
      "properties": {
        "customer_id": {
          "format": "uuid",
          "type": "string"
        },
        "id": {
          "format": "uuid",
          "type": "string"
        },
        "identities": {
          "items": {
            "$ref": "#/$defs/Identity"
          },
          "type": "array"
        },
        "number": {
          "type": "string"
        },
        "queue_id": {
          "anyOf": [
            {
              "format": "uuid",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "id",
        "number",
        "customer_id",
        "identities"
      ],
      "title": "Conversation",
      "type": "object"
    },
    "ConversationStatus": {
      "description": "Состояние обращения, как его видит организация: без внутренних оттенков очереди.",
      "enum": [
        "assigned",
        "at_bot",
        "closed",
        "on_hold",
        "resolved",
        "waiting"
      ],
      "title": "ConversationStatus"
    },
    "Identity": {
      "description": "Подтверждённая личность клиента: по ней система находит его у себя.",
      "properties": {
        "external_id": {
          "type": "string"
        },
        "namespace": {
          "type": "string"
        }
      },
      "required": [
        "namespace",
        "external_id"
      ],
      "title": "Identity",
      "type": "object"
    }
  },
  "$ref": "#/$defs/Closed"
}