API: Сообщения
Справочник
Сообщения
Обновлено 7 сентября 2026 г.
Отправляет сообщение в существующий диалог от имени оператора. Клиент получает его в своём канале: в виджете на сайте или в мессенджере. Так ваша система может писать клиентам автоматически — статусы заказов, напоминания, ответы вашего бота.
POST /messages
| Поле | Тип | Описание |
|---|---|---|
| conversationId | string, обязательное | ID диалога из GET /conversations |
| text | string, обязательное | Текст сообщения, до 10 000 символов |
| author | string | Имя автора, отображается в истории (например, «Бот заказов») |
Пример запроса
curl -X POST https://api.chatva.app/v1/messages \
-H "Authorization: Bearer ch_live_9f3ka2" \
-H "Content-Type: application/json" \
-d '{
"conversationId": "cv_018f3a",
"text": "Ваш заказ 4417 передан курьеру, приедет сегодня до 18:00",
"author": "Бот заказов"
}'Ответ 201
{
"id": "m_5601",
"conversationId": "cv_018f3a",
"from": "operator",
"author": "Бот заказов",
"text": "Ваш заказ 4417 передан курьеру, приедет сегодня до 18:00",
"createdAt": "2026-09-07T12:05:00Z"
}Ограничения
- Нельзя создать новый диалог: клиент всегда пишет первым, API дополняет существующую переписку.
- Закрытый диалог при отправке сообщения остаётся закрытым — клиент увидит ответ при следующем обращении.
- Вложения пока не поддерживаются, только текст.