POST /v1/conversations/handoff
Чат-ботыңызға арналған әдіс. Бот жауап бере алмаса немесе клиент тірі адамды сұраса, бот әңгімені операторға береді. WazzaBee чаттар тізімінде диалогта себебімен бірге «Менеджерді күтуде» белгісі пайда болады, ал кабинет иесіне push-хабарлама келеді. Оператор клиентке жауап бергенде белгі өздігінен алынады.
URL
POST https://api.wazzabee.com/api-gateway/v1/conversations/handoffСұраныс денесінің параметрлері
| Параметр | Түрі | Міндетті | Сипаттамасы |
|---|---|---|---|
conversationId | string (UUID) | ✅* | Диалог ID. Вебхуктерде және GET /v1/messages ішінде келеді |
chatId | string | ✅* | Клиенттің телефон нөмірі немесе chat_id, егер conversationId белгісіз болса. Осы клиентпен соңғы диалог алынады |
channelId | string (UUID) | Жоқ | Клиент бірнеше желіге жазса, желі |
reason | string | Жоқ | Беру себебі, 300 таңбаға дейін. Оператор оны белгі кеңесінде және push-хабарламада көреді |
* 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": "Клиент қайтару туралы сұрайды"}'Белгі қашан алынады
Белгіні адамның алғашқы жауабы алады: кабинеттен, CRM-дегі чаттан немесе automated белгісінсіз POST /v1/messages/send арқылы. "automated": true деп жіберілген бот хабарламалары, автожауаптар мен таратулар белгіні алмайды.
GET /v1/conversations жауабында awaitingManager өрісі бар: null немесе {"since": "...", "reason": "..."}. Өріс толтырылғанда ботыңызға бұл диалогта жауап бермеген жөн.