POST/api/public/widget/voice-speak
Inoshandura zvinyorwa kuita mutauro unotaurwa (kubuda kwezwi muwidget), kana basa rezwi rakavhurwa.
Tumirai `widget_code` nezvinyorwa zvekuverengwa mu`text`. Mhinduro ine data yezwi yekuridza mubhurauza. Kuti zvidzidzwe zvakananga kuburikidza ne-elementi `<audio>`, nzira imwe chete inowanikwa zvakare ne-GET. Kana `widget_code` isipo, seva inopindura ne400 `WIDGET_CODE_REQUIRED`; kana basa rezwi risina kuvhurwa kana risipo parizvino, ne503 `VOICE_UNAVAILABLE`. Tangai kuridza kutsva kana kwekare kwapera chete.
Pfupiso
Kudana: POST /api/public/widget/voice-speak. Endpoint iyi ndeyeboka re“Chat widget” reAPI yeZentor App. Inoda widget embed token inoshanda. Kudana uku idempotent: kudana kakawanda neruzivo rumwe chete kunodzosa mhedzisiro imwe chete. Maparameter anodiwa: widget_code (body), text (body). Zviitiko zvezvikanganiso zvakanyorwa: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.
Kusimbiswa nekuchengetedza
Widget embed token (header X-Widget-Token) + rondedzero yeOrigin dzakabvumidzwa
Idempotent: Hongu
Maparameter
widget_code(body, string, zvinodiwa)— Kodhi yewidget inobva mukodhi yenyu yekuisatext(body, string, zvinodiwa)— Zvinyorwa zvinofanira kuverengwaMuenzaniso wemhinduro
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Makodhi ekukanganisa
400 WIDGET_CODE_REQUIRED — Fiyedhi `widget_code` isipo.503 VOICE_UNAVAILABLE — Basa rezwi harisi kuvhurwa pawidget iyi kana parizvino harisipo.Mafambiro akaongororwa
`widget_code` isipo inopa 400 `WIDGET_CODE_REQUIRED`, widget isina basa rezwi 503 `VOICE_UNAVAILABLE`. Mamiriro ebudiriro anoda widget ine basa rezwi rakavhurwa.
Chat widget
GET /api/public/widget/healthKuongorora kuwanikwa kwakareruka kwesevhisi yewidget.GET /api/public/widget/config/:widget_codeInopa kugadzirwa kweveruzhinji kwewidget (zita rinoratidzwa, mashoko ekugamuchira, dhizaini, mutauro, basa revhoiza) rekutanga mubhurauza.POST /api/public/widget/messageInotumira meseji yemushanyi kuchatbot uye inopa mhinduro yayo – endpoint yepakati yewidget yehurukuro.GET /api/public/widget/historyInorodha nhoroondo yemashoko ariko yehurukuro yewidget, semuenzaniso mushure mekureloadwa kwepeji.POST /api/public/widget/pollInotora mameseji akagamuchirwa mushure menguva yakati – semuenzaniso mhinduro yemushandi akatora hurukuro.POST /api/public/widget/ratingInochengetedza kuongorora kwemushanyi pamusoro pehurukuro (kunobatsira kana hakubatsiri).POST /api/public/widget/trackInonyora chiitiko chekushandiswa chisingazivikanwi chewidget (semuenzaniso „widget yavhurwa“) kuongororo yedashboard.POST /api/public/widget/voice-transcribeInoshandura rekodhi yezwi remushanyi kuita zvinyorwa (kuisa nezwi), kana basa rezwi rewidget rakavhurwa.