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": "..."}. Талаа толтурулганда ботуңузга бул диалогдо жооп бербегени оң.