Диалоги

Обновлено 7 сентября 2026 г.

Диалог — центральная сущность: клиент, канал, статус, ответственный, теги, оценка и сообщения. Список отдаётся с курсорной пагинацией, карточка — со всей перепиской.

GET /conversations — список диалогов

Параметр	Тип	Описание
status	query	new, open, closed или all (по умолчанию all)
channel	query	site, telegram, max, whatsapp, vk, avito, email
assignee	query	ID оператора; unassigned — без ответственного
department	query	ID отдела
limit	query	1–100, по умолчанию 50
cursor	query	курсор следующей страницы из поля nextCursor

Ответ 200

{
  "items": [
    {
      "id": "cv_018f3a",
      "client": "Кира Мещерякова",
      "channel": "telegram",
      "status": "new",
      "unread": 2,
      "assignee": null,
      "department": "dp_sales",
      "tags": ["доставка"],
      "rating": null,
      "lastMessage": {"from": "client", "text": "Здравствуйте!", "createdAt": "2026-09-07T11:58:00Z"},
      "createdAt": "2026-09-07T11:58:00Z",
      "updatedAt": "2026-09-07T12:01:00Z"
    }
  ],
  "nextCursor": "eyJvZmZzZXQiOjUwfQ"
}

GET /conversations/{id} — карточка диалога

Отдаёт диалог со всеми сообщениями в хронологическом порядке. Используйте для полного бэкапа переписки или показа истории в своей системе.

Ответ 200 (фрагмент)

{
  "id": "cv_018f3a",
  "client": "Кира Мещерякова",
  "channel": "telegram",
  "status": "open",
  "messages": [
    {"id": "m_5521", "from": "client", "author": null, "text": "Здравствуйте!", "createdAt": "2026-09-07T11:58:00Z"},
    {"id": "m_5522", "from": "operator", "author": "Анна Сорокина", "text": "Добрый день! Чем помочь?", "createdAt": "2026-09-07T11:59:10Z"},
    {"id": "m_5523", "from": "note", "author": "Анна Сорокина", "text": "Клиент из Instagram, вести на менеджера", "createdAt": "2026-09-07T11:59:40Z"}
  ]
}

Сообщения типа note — внутренние заметки команды, клиент их не видит.

← Ключи и авторизация →Сообщения