Appearance
Отправка сообщений
POST /chat/message
Отправляет сообщение ассистенту и ждёт полного ответа.
http
POST /chat/message
X-API-Key: ak_your_api_key
Content-Type: application/jsonТело запроса
json
{
"message": "Сколько стоит доставка?",
"conversationId": "uuid",
"userId": "user-123"
}| Поле | Тип | Обязательно | Описание |
|---|---|---|---|
message | string | да | Текст сообщения |
conversationId | string | нет | ID диалога для продолжения. Если не передать — создаётся новый |
userId | string | нет | Внешний идентификатор пользователя для группировки диалогов |
Ответ
json
{
"conversationId": "550e8400-e29b-41d4-a716-446655440000",
"isPaused": false,
"suggestions": [],
"message": {
"id": "uuid",
"role": "assistant",
"content": "Доставка по городу бесплатна при заказе от 2000 ₽...",
"createdAt": "2024-01-01T12:00:00.000Z"
}
}| Поле | Описание |
|---|---|
conversationId | Сохраните и передавайте в следующих запросах, чтобы продолжить диалог |
isPaused | true если диалог передан оператору — сообщения ассистента не отправляются |
suggestions | Быстрые кнопки-подсказки (если включены в настройках) |
message | Ответ ассистента. null если диалог на паузе |
Пример (curl)
bash
curl -X POST https://app.agent512.ru/api/chat/message \
-H "X-API-Key: ak_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"message": "Привет! Какой у вас режим работы?",
"userId": "user-42"
}'Пример (JavaScript)
js
async function sendMessage(text, conversationId) {
const res = await fetch('https://app.agent512.ru/api/chat/message', {
method: 'POST',
headers: {
'X-API-Key': 'ak_your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({ message: text, conversationId }),
})
return res.json()
}
// Первое сообщение
const first = await sendMessage('Привет!')
console.log(first.message.content)
// Продолжение диалога
const second = await sendMessage('А доставка есть?', first.conversationId)
console.log(second.message.content)