POST/api/public/widget/voice-transcribe
Iguqula ukuqoshwa kwezwi kwesivakatshi kube umbhalo (ukufakwa kwezwi), nxa umsebenzi wezwi wewijethi uvuliwe.
Thumelani `widget_code` ledatha yomsindo endaweni ethi `audio` njenge-`multipart/form-data`. Impendulo ilomunqulo owaziwayo, elithumela emva kwalokho nge-`POST /api/public/widget/message`. Ukuthi umsebenzi wezwi uyasebenza kutshengiswa yi-`voice_enabled` ekuhlelweni kwewijethi. Nxa `widget_code` kayikho, iseva iphendula ngo-400 `WIDGET_CODE_REQUIRED`; nxa umsebenzi wezwi kawuvulwa kumbe khathesi kawukho, ngo-503 `VOICE_UNAVAILABLE`. Umsebenzi wezwi ulungiswa yiZentor iwijethi yakho.
Isifinyezo
Ukubiza: POST /api/public/widget/voice-transcribe. Le endpoint ingeyeqembu elithi “Iwijethi yengxoxo” le-API ye-Zentor App. Idinga i-widget embed token esebenzayo. Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: widget_code (body), audio (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: Hatshi
Amapharamitha
widget_code(body, string, kuyadingeka)— Ikhodi yewijethi evela ekhodini yakho yokufakaaudio(body, binary, kuyadingeka)— Ukuqoshwa komsindo njengefayili (`multipart/form-data`)Isibonelo 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-speakIguqula umbhalo kube ulimi olukhulunywayo (ukukhishwa kwezwi ewijethini), nxa umsebenzi wezwi uvuliwe.