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 yekuisa
text(body, string, zvinodiwa)— Zvinyorwa zvinofanira kuverengwa

Muenzaniso 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.

Zvinyorwa zvine hukama

← Chat widget