conversation.assigned

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

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

Поля

Assigned

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

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	да

JSON Schema

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