Skip to content

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

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"
}
ПолеТипОбязательноОписание
messagestringдаТекст сообщения
conversationIdstringнетID диалога для продолжения. Если не передать — создаётся новый
userIdstringнетВнешний идентификатор пользователя для группировки диалогов

Ответ

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Сохраните и передавайте в следующих запросах, чтобы продолжить диалог
isPausedtrue если диалог передан оператору — сообщения ассистента не отправляются
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)