06.04.2026 21:45

Add

[POST] .../v1/ticket/add

Создает тикет CRM.

Входные параметры

Название Тип данных Обязательность Описание
client_id Int64 Обязательный ID клиента
channel_id Int64 Обязательный ID канала
direction Enum (TicketDirectionEnum) Необязательный Направление (Inbound, Outbound), по умолчанию Inbound
external_dialog_id String Необязательный Внешний ID диалога
subject String Необязательный Тема обращения
description String Необязательный Описание обращения
responsible_user_id Int64 Необязательный ID ответственного пользователя
participant_user_ids Array of Int64 Необязательный Участники тикета (сотрудники)
fields Array of FieldValueAdd Необязательный Значения дополнительных полей

SLA-поля (first_response_*, resolve_due_date, sla_breached*) управляются сервером и в запросе не передаются.

Ограничения и проверки

  • В рамках пары client_id + channel_id допускается только один открытый тикет (status = Open).
  • Если открытый тикет для этой пары уже существует, новый тикет не создается: метод возвращает ID существующего открытого тикета.
  • Для повторного обращения переиспользуется тот же тикетный чат (1 Ticket = 1 Chat).
  • created_user не добавляется в participant_user_ids автоматически.
  • responsible_user_id, если задан, всегда включается в participant_user_ids (даже если не передан в массиве).

Пример запроса

{}

Выходные параметры

Название Тип данных Описание
result.new_id Int64 ID созданного тикета или существующего открытого тикета (dedupe)

Пример ответа

{
  "ok": true,
  "result": {}
}