POST/api/public/widget/voice-speak
Iguqula umbhalo kube ulimi olukhulunywayo (ukukhishwa kwezwi ewijethini), nxa umsebenzi wezwi uvuliwe.
Thumelani `widget_code` lombhalo wokufundwa ku-`text`. Impendulo ilidatha yomsindo yokudlalwa ebhrawuzeni. Ukuze kudlalwe ngqo nge-elementi `<audio>`, indlela efananayo iyatholakala ngokwengezelelweyo nge-GET. Nxa `widget_code` kayikho, iseva iphendula ngo-400 `WIDGET_CODE_REQUIRED`; nxa umsebenzi wezwi kawuvulwa kumbe khathesi kawukho, ngo-503 `VOICE_UNAVAILABLE`. Qalani ukudlalwa okutsha nxa okwandulelayo kuphela.
Isifinyezo
Ukubiza: POST /api/public/widget/voice-speak. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token esebenzayo. Ukubiza kuyi-idempotent: ukubiza kanengi ngemininingwane efananayo kubuyisela umphumela ofananayo. Amapharamitha adingekayo: widget_code (body), text (body). Izimo zamaphutha ezibhaliweyo: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubuwena lokuvikeleka
I-Embed-Token ye-widget (i-header X-Widget-Token) + uhlu lwama-Origin avunyelweyo
I-idempotent: Yebo
Amapharamitha
widget_code(body, string, kuyadingeka)— Ikhodi yewijethi evela ekhodini yakho yokufakatext(body, string, kuyadingeka)— Umbhalo okumele ufundweIsibonelo sempendulo (response)
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Umsebenzi wezwi awutholakali okwamanje."}}Amakhodi amaphutha
400 WIDGET_CODE_REQUIRED — Insimu `widget_code` kayikho.503 VOICE_UNAVAILABLE — Umsebenzi wezwi kawuvulwa kulewijethi kumbe khathesi kawukho.Ukuziphatha okuhlolwe
I-`widget_code` kayikho inikeza 400 `WIDGET_CODE_REQUIRED`, iwijethi engelamsebenzi wezwi 503 `VOICE_UNAVAILABLE`. Isimo sempumelelo sidinga iwijethi elomsebenzi wezwi uvuliwe.
Iwijethi yengxoxo
GET /api/public/widget/healthUkuhlolwa okulula kokutholakala kwesevisi yewijethi.GET /api/public/widget/config/:widget_codeInikeza ukuhlelwa komphakathi kwewijethi (ibizo elibonakalayo, umbhalo wokwamukela, idizayini, ulimi, umsebenzi wezwi) wokuqaliswa kubhrawuza.POST /api/public/widget/messageIthumela umlayezo wesivakatshi ku-chatbot njalo inikeze impendulo yayo – isiphetho esimaphakathi sewijethi yengxoxo.GET /api/public/widget/historyIlayitsha umlando wemilayezo esekhona wengxoxo yewijethi, isibonelo ngemva kokuphindwa kulayishwe ikhasi.POST /api/public/widget/pollIthatha imilayezo etholwe ngemva kwesikhathi esithile – isibonelo impendulo yesisebenzi esithatha ingxoxo.POST /api/public/widget/ratingIgcina isilinganiso sesivakatshi ngengxoxo (kuyasiza kumbe kakusizi).POST /api/public/widget/trackIbhala izenzakalo yokusetshenziswa engaziwa yewijethi (isib. „iwijethi ivuliwe“) yokuhlaziywa kwedashboard.POST /api/public/widget/voice-transcribeIguqula ukuqoshwa kwezwi kwesivakatshi kube umbhalo (ukufakwa kwezwi), nxa umsebenzi wezwi wewijethi uvuliwe.