Все разделыСправочник · Тикеты

Тикет и сообщение: поля

Обновлено 23 октября 2026 г. · 2 мин чтения

Тикет и сообщение выглядят одинаково в ответах API и в телах вебхуков — опишите их у себя один раз.

Тикет

{
  "id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
  "number": "T-1042",
  "subject": "Не пришёл заказ №4821",
  "status": "new",
  "priority": null,
  "channel": "API",
  "client_id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
  "assignee_id": null,
  "team_id": null,
  "merged_into_id": null,
  "snoozed_until": null,
  "created_at": "2026-10-21T09:15:04.218Z",
  "updated_at": "2026-10-21T09:15:04.218Z",
  "last_activity_at": "2026-10-21T09:15:04.218Z",
  "closed_at": null,
  "url": "https://app.deskus.ru/tickets/0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10"
}

Поле	Тип	Что в нём
`id`	uuid	Идентификатор
`number`	строка	Номер, как в кабинете: `T-1042`. По нему тоже можно обращаться: `/tickets/T-1042`
`subject`	строка	Тема
`status`	строка	`new` — новый, `open` — в работе, `waiting` — ждёт клиента, `snoozed` — отложен, `closed` — закрыт
`priority`	строка или null	`critical`, `high`, `medium`, `low`; `null` — без приоритета
`channel`	строка	Откуда пришёл: «Email», «Виджет», «Telegram», «API» — подпись канала из кабинета
`client_id`	uuid или null	Клиент (поля клиента)
`assignee_id`	uuid или null	Ответственный сотрудник
`team_id`	uuid или null	Команда
`merged_into_id`	uuid или null	Тикет слит с этим — работа идёт там
`snoozed_until`	время или null	До когда отложен
`created_at`, `updated_at`	время	Создан и изменён
`last_activity_at`	время или null	Последнее действие: сообщение, смена статуса
`closed_at`	время или null	Закрыт
`url`	строка	Ссылка на тикет в кабинете — для сотрудников

Сообщение

{
  "id": "1f9b3d7e-8a2c-4e5f-b6d1-9c0a4e2f7b38",
  "ticket_id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
  "kind": "reply",
  "author": { "name": "Дарья Ветрова", "user_id": "d4e1b7a2-9c3f-4e6d-a5b8-0f2c7e9d1a35" },
  "body": "<p>Мария, посылка уже в пути — <strong>трек</strong> придёт письмом.</p>",
  "text": "Мария, посылка уже в пути — трек придёт письмом.",
  "delivery_status": "sent",
  "created_at": "2026-10-21T09:42:17.031Z"
}

Поле	Что в нём
`kind`	`client` — от клиента, `reply` — ответ клиенту, `note` — заметка для своих (клиент её не видит), `system` — запись Дескуса: «Статус: Новый → В работе»
`author`	Имя и `user_id` сотрудника; у клиента и системы `user_id` — `null`
`body`	Как хранится: у ответов сотрудников — HTML, у клиента — обычно текст
`text`	Без разметки, с переносами строк — для мессенджеров и CRM
`delivery_status`	Доставка ответа в канал клиента: `sent`, `delivered`, `read`, `failed` или `null`

Список значений может дополниться — например, новым каналом в channel. Не падайте на незнакомом значении (версии).

Статья помогла?

Не нашли ответ? Напишите нам

Поддержка ответит в рабочее время.

Вы сотрудник «Дескус»?Изменить статью в Дескусе