conversation.state

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

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

Поля

StateChanged

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

Conversation

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

Identity

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

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

Operator

Поле	Тип	Обязательное	Описание
id	string (uuid)	да
name	string	да

ConversationStatus

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

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

JSON Schema

{
  "$defs": {
    "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"
    },
    "Operator": {
      "properties": {
        "id": {
          "format": "uuid",
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "id",
        "name"
      ],
      "title": "Operator",
      "type": "object"
    },
    "StateChanged": {
      "properties": {
        "conversation": {
          "$ref": "#/$defs/Conversation"
        },
        "event_id": {
          "format": "uuid",
          "type": "string"
        },
        "occurred_at": {
          "format": "date-time",
          "type": "string"
        },
        "operator": {
          "anyOf": [
            {
              "$ref": "#/$defs/Operator"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "previous_status": {
          "anyOf": [
            {
              "$ref": "#/$defs/ConversationStatus"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "schema_version": {
          "default": 1,
          "type": "integer"
        },
        "status": {
          "$ref": "#/$defs/ConversationStatus"
        },
        "type": {
          "description": "Вид варианта: всегда `conversation.state`.",
          "enum": [
            "conversation.state"
          ]
        }
      },
      "required": [
        "type",
        "event_id",
        "occurred_at",
        "conversation",
        "status"
      ],
      "title": "StateChanged",
      "type": "object"
    }
  },
  "$ref": "#/$defs/StateChanged"
}