05.05.2026 22:15

Get

[POST] .../v1/ticket/get

Возвращает список тикетов CRM с фильтрами и пагинацией.

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

Название Тип данных Обязательность Описание
ids Array of Int64 Необязательный Фильтр по ID тикетов
search String Необязательный Поиск по subject тикета и данным клиента (name, phone)
client_ids Array of Int64 Необязательный Фильтр по клиентам
channel_ids Array of Int64 Необязательный Фильтр по каналам
external_dialog_id String Необязательный Фильтр по внешнему ID диалога
responsible_user_ids Array of Int64 Необязательный Фильтр по ответственным
statuses Array of Enum (TicketStatusEnum) Необязательный Фильтр по статусу (Open, Closed, WaitingClient, WaitingStaff)
direction Enum (TicketDirectionEnum) Необязательный Фильтр по направлению (Inbound, Outbound)
from_date Int64 Необязательный Нижняя граница created_date
to_date Int64 Необязательный Верхняя граница created_date
filters Array of Filter Необязательный Дополнительные фильтры
sort_orders Array of Object Необязательный Сортировки. Формат: [{ "column": "...", "direction": "ASC|DESC" }]
limit Int32 Необязательный Лимит выборки
offset Int32 Необязательный Смещение выборки

Стандартные поля для фильтрации (filters)

client_id, channel_id, responsible_user_id, external_dialog_id,
subject, description, created_date, resolved_date, sla_breached

Поля, доступные для сортировки (sort_orders[].column)

id, created_date, last_update, status, direction, resolved_date,
sla_breached, sla_breached_date, first_response_date, first_response_due_date,
resolve_due_date, rating, channel_id, responsible_user_id, client.name, client.phone

По умолчанию применяется сортировка: id DESC.

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

{
  "client_ids": [501],
  "channel_ids": [3],
  "responsible_user_ids": [15],
  "statuses": ["Open", "WaitingClient"],
  "direction": "Inbound",
  "from_date": 1761955200,
  "to_date": 1764547199,
  "sort_orders": [
    { "column": "created_date", "direction": "DESC" },
    { "column": "client.name", "direction": "ASC" }
  ],
  "limit": 50,
  "offset": 0
}

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

Название Тип данных Описание
result Array of Ticket Массив тикетов. Каждый элемент содержит client_id и вложенный объект client
next_offset Int32 Смещение для следующей страницы
total Int64 Общее количество записей

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

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