POST/api/public/widget/voice-transcribe

Iguqula ukuqoshwa kwezwi kwesivakashi kube umbhalo (ukufakwa kwezwi), uma umsebenzi wezwi wewijethi uvuliwe.

Thumelani `widget_code` nedatha yomsindo endaweni ethi `audio` njenge-`multipart/form-data`. Impendulo iqukethe umbhalo owaziwayo, eniwuthumele emva kwalokho nge-`POST /api/public/widget/message`. Ukuthi umsebenzi wezwi usebenza yini kuboniswa yi-`voice_enabled` ekuhlelweni kwewijethi. Uma `widget_code` ingekho, iseva isabela ngo-400 `WIDGET_CODE_REQUIRED`; uma umsebenzi wezwi ungavuliwe noma okwamanje ungekho, ngo-503 `VOICE_UNAVAILABLE`. Umsebenzi wezwi ulungiselelwa yi-Zentor iwijethi yakho.

Ukubuka konke

Ukubiza: POST /api/public/widget/voice-transcribe. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token evumelekile. Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: widget_code (body), audio (body). Izimo zamaphutha ezibhaliwe: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

I-widget embed token (i-header X-Widget-Token) + uhlu lwama-origin avunyelwe

I-idempotent: Cha

Amapharamitha

widget_code(body, string, kuyadingeka)— Ikhodi yewijethi evela ekhodini yakho yokufaka
audio(body, binary, kuyadingeka)— Ukuqoshwa komsindo njengefayela (`multipart/form-data`)

Isibonelo se-response

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wezwi awutholakali okwamanje."}}

Amakhodi amaphutha

400 WIDGET_CODE_REQUIRED — Insimu `widget_code` ayikho.
503 VOICE_UNAVAILABLE — Umsebenzi wezwi awuvulwa kule wijethi noma okwamanje awukho.

Ukuziphatha okuhlolwe

I-`widget_code` engekho inikeza 400 `WIDGET_CODE_REQUIRED`, iwijethi engenawo umsebenzi wezwi 503 `VOICE_UNAVAILABLE`. Isimo sempumelelo sidinga iwijethi enomsebenzi wezwi uvuliwe.

Iwijethi yengxoxo

GET /api/public/widget/healthUkuhlolwa okulula kokutholakala kwesevisi yewijethi.GET /api/public/widget/config/:widget_codeInikeza ukuhlelwa komphakathi kwewijethi (igama lokubonisa, umbhalo wokubingelela, idizayini, ulimi, umsebenzi wezwi) wokuqaliswa kwebhrawuza.POST /api/public/widget/messageIthumela umlayezo wesivakashi ku-chatbot futhi inikeze impendulo yayo – isiphetho esimaphakathi sewijethi yengxoxo.GET /api/public/widget/historyIlayisha umlando wemiyalezo eyisekhona wengxoxo yewijethi, isibonelo ngemva kokulayishwa kabusha kwekhasi.POST /api/public/widget/pollIlanda imiyalezo eyamukelwe ngemva kwesikhathi esithile – isibonelo impendulo yesisebenzi esithatha ingxoxo.POST /api/public/widget/ratingIgcina ukulinganiswa kwesivakashi mayelana nengxoxo (kusiza noma akusizi).POST /api/public/widget/trackIrekhoda isenzakalo esingaziwa sokusetshenziswa kwewijethi (isib. „iwijethi ivuliwe“) sokuhlaziywa kwedashboard.POST /api/public/widget/voice-speakIguqula umbhalo kube ulimi olukhulunywayo (ukukhiphwa kwezwi ewijethini), uma umsebenzi wezwi uvuliwe.

Izihloko ezihlobene

← Iwijethi yengxoxo