Сообщения

Список сообщений

Возвращает сообщения диалога в хронологическом порядке (сначала старые). Внутренние заметки операторов никогда не включаются.

Список сообщений диалога (курсорная пагинация, сначала старые).

Ответ

200Успех

{
  "results": [
    {
      "id": "a1000000-0000-4000-8000-000000000001",
      "conversation_id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
      "thread_id": null,
      "sender_type": "CLIENT",
      "content": "Where is my order?",
      "is_internal_note": false,
      "reply_to_id": null,
      "created_at": "2026-07-01T10:30:00+00:00",
      "attachments": []
    },
    {
      "id": "b2d7e410-3c88-4a15-9f60-7d8e9a0b1c2d",
      "conversation_id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
      "thread_id": null,
      "sender_type": "OPERATOR",
      "content": "It shipped this morning \u2014 tracking below.",
      "is_internal_note": false,
      "reply_to_id": null,
      "created_at": "2026-07-01T10:40:00+00:00",
      "attachments": []
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Объект сообщения

id, conversation_id, thread_id (обычно null).
sender_type — CLIENT (клиент), OPERATOR, AI или SYSTEM.
content — текст сообщения.
is_internal_note — здесь всегда false.
reply_to_id — id сообщения, на которое это ответ, или null.
created_at — ISO-8601.
attachments — массив { id, filename, content_type, size }.

Отправить сообщение

Доставляет сообщение клиенту через канал диалога. Сообщение записывается как OPERATOR с пометкой об отправке через API и появляется в панели оператора в реальном времени.

Отправить сообщение в существующий диалог.

Запрос

Тело

{
  "content": "Your refund of $20.00 has been processed.",
  "reply_to_message_id": null
}

Ответы

201Создано

{
  "id": "b2d7e410-3c88-4a15-9f60-7d8e9a0b1c2d",
  "conversation_id": "3f2b1c9a-7d4e-4b21-9c33-0a1b2c3d4e5f",
  "thread_id": null,
  "sender_type": "OPERATOR",
  "content": "Your refund of $20.00 has been processed.",
  "is_internal_note": false,
  "reply_to_id": null,
  "created_at": "2026-07-01T10:41:00+00:00",
  "attachments": []
}

400Закрыт

{ "detail": "conversation_closed" }

Поля тела

content — обязательно; текст сообщения (до 4096 символов).
reply_to_message_id — необязательно; id сообщения из того же диалога, на которое отвечаем.

Замечания и лимиты

Отправка в CLOSED-диалог возвращает 400 conversation_closed.
Групповые диалоги (группы Telegram) в v1 не поддерживаются (400 group_conversations_not_supported).
Пустой content возвращает 400 content_required.
Лимит: 60 запросов/минуту на API-ключ.