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 yokufakatext(body, string, kuyadingeka)— Umbhalo okufanele ufundweIsibonelo 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.