Передача диалога оператору

POST /v1/conversations/handoff

Метод для вашего чат-бота. Когда бот не может ответить или клиент просит живого человека, бот передаёт разговор оператору. В списке чатов WazzaBee у диалога появляется метка «Ждёт менеджера» с причиной, а владельцу кабинета приходит пуш-уведомление. Метка снимается сама, когда оператор ответит клиенту.

URL

POST https://api.wazzabee.com/api-gateway/v1/conversations/handoff

Заголовки

Authorization: Bearer ВАШ_API_КЛЮЧ
Content-Type: application/json

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

* Нужно указать conversationId или chatId.

Пример запроса

curl -X POST "https://api.wazzabee.com/api-gateway/v1/conversations/handoff" \
  -H "Authorization: Bearer ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "chatId": "77071234567",
    "reason": "Клиент спрашивает про возврат, нужен менеджер"
  }'

Успешный ответ (200 OK)

{
  "success": true,
  "conversationId": "uuid",
  "awaitingManager": {
    "since": "2026-09-30T12:00:00.000Z",
    "reason": "Клиент спрашивает про возврат, нужен менеджер"
  },
  "message": "Диалог передан оператору. Метка снимется, когда оператор ответит клиенту."
}

Когда метка снимается

Метку снимает первый ответ человека: из кабинета, из чата в вашей CRM или через POST /v1/messages/send без флага automated. Сообщения бота с "automated": true, автоответы и рассылки метку не снимают. Поэтому бот может сразу написать клиенту «Подключаю менеджера», и оператор всё равно увидит метку.

Возможные ошибки