POST/api/public/widget/voice-speak

Iguqula umbhalo kube ulimi olukhulunywayo (ukukhiphwa kwezwi ewijethini), uma umsebenzi wezwi uvuliwe.

Thumelani `widget_code` nombhalo wokufundwa ku-`text`. Impendulo iqukethe idatha yomsindo yokudlalwa ebhrawuzeni. Ukuze idlalwe ngqo nge-elementi `<audio>`, indlela efanayo iyatholakala ngokwengeziwe nge-GET. Uma `widget_code` ingekho, iseva isabela ngo-400 `WIDGET_CODE_REQUIRED`; uma umsebenzi wezwi ungavuliwe noma okwamanje ungekho, ngo-503 `VOICE_UNAVAILABLE`. Qalani ukudlalwa okusha kuphela uma okudlule kuphela.

Ukubuka konke

Ukubiza: POST /api/public/widget/voice-speak. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token evumelekile. Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: widget_code (body), text (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: Yebo

Amapharamitha

widget_code(body, string, kuyadingeka)— Ikhodi yewijethi evela ekhodini yakho yokufaka
text(body, string, kuyadingeka)— Umbhalo okufanele ufundwe

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-transcribeIguqula ukuqoshwa kwezwi kwesivakashi kube umbhalo (ukufakwa kwezwi), uma umsebenzi wezwi wewijethi uvuliwe.

Izihloko ezihlobene

← Iwijethi yengxoxo