Диалоги

Список диалогов

Возвращает диалоги проекта, сначала с самой недавней активностью, с курсорной пагинацией.

{
  "results": [
    {
      "id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
      "status": "PROCESSING",
      "channel_type": "TELEGRAM",
      "ticket_number": 1042,
      "message_count": 7,
      "contact": { "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e", "display_name": "Jane Doe" },
      "updated_at": "2026-07-01T10:40:00+00:00"
    }
  ],
  "next_cursor": "MjAyNi0wNy0wMVQxMDo0MDowMHwzZjJi",
  "has_more": true
}

Параметры запроса

• status — фильтр по статусу: NEW, ESCALATING, PROCESSING, WAITING, RESOLVED, CLOSED.
• channel_id — UUID канала для фильтрации.
• updated_since — метка времени ISO-8601; только диалоги, обновлённые в это время или позже.
• cursor — непрозрачный курсор из поля next_cursor предыдущего ответа.
• limit — размер страницы, по умолчанию 50, максимум 100.

Как работает курсорная пагинация — см. статью Ошибки, лимиты и пагинация.

Получить диалог

{
  "id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
  "status": "PROCESSING",
  "priority": "HIGH",
  "subject": "Refund request",
  "source": "CHANNEL",
  "channel_id": "9a1c5f30-2b6d-4c71-8e42-1a2b3c4d5e6f",
  "channel_type": "TELEGRAM",
  "ticket_number": 1042,
  "detected_language": "en",
  "message_count": 7,
  "contact": { "id": "7c4e9b02-1a55-4e88-b0d1-2f3a4b5c6d7e", "display_name": "Jane Doe" },
  "created_at": "2026-07-01T10:12:00+00:00",
  "updated_at": "2026-07-01T10:40:00+00:00",
  "last_message_at": "2026-07-01T10:40:00+00:00"
}

{ "detail": "conversation_not_found" }

Объект диалога

• id — UUID.
• status — один из шести статусов выше.
• priority — LOW / MEDIUM / HIGH / URGENT или null.
• subject, source (CHANNEL/PORTAL/OPERATOR), ticket_number, detected_language, message_count.
• channel_id, channel_type (TELEGRAM, WEB, EMAIL, HELPDESK, …).
• contact — { id, display_name }.
• created_at, updated_at, last_message_at — ISO-8601.

Статусы диалога

• NEW — обрабатывается ИИ, оператора пока нет.
• ESCALATING — передан человеку; операторы уведомлены.
• PROCESSING — оператор подключился.
• WAITING — оператор ждёт ответа клиента.
• RESOLVED — решён; ответ клиента может открыть заново.
• CLOSED — закрыт.