POST/api/public/widget/voice-speak
Verander teks in gesproke taal (spraakuitvoer in die widget), indien die spraakfunksie geaktiveer is.
Stuur `widget_code` en die teks om voor te lees in `text`. Die antwoord bevat die klankdata vir weergawe in die blaaier. Vir direkte weergawe via 'n `<audio>`-element is dieselfde pad bykomend per GET beskikbaar. Ontbreek `widget_code`, antwoord die bediener met 400 `WIDGET_CODE_REQUIRED`; is die spraakfunksie nie geaktiveer of tans nie beskikbaar nie, met 503 `VOICE_UNAVAILABLE`. Begin 'n nuwe weergawe eers wanneer die vorige een klaar is.
Oorsig
Oproep: POST /api/public/widget/voice-speak. Hierdie eindpunt behoort tot die groep “Chat-widget” van die Zentor App-API. Dit vereis ’n geldige widget-inbedtoken. Die oproep is idempotent: herhaalde oproepe met dieselfde insette lewer dieselfde resultaat. Verpligte parameters: widget_code (body), text (body). Gedokumenteerde foutgevalle: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.
Verifikasie en sekuriteit
Widget-inbedtoken (X-Widget-Token-header) + lys van toegelate origins
Idempotent: Ja
Parameters
widget_code(body, string, vereis)— Widget-kode uit u inbedkodetext(body, string, vereis)— Teks wat voorgelees moet wordVoorbeeldrespons
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Foutkodes
400 WIDGET_CODE_REQUIRED — Die veld `widget_code` ontbreek.503 VOICE_UNAVAILABLE — Die spraakfunksie is nie vir hierdie widget geaktiveer nie of tans nie beskikbaar nie.Gekontroleerde gedrag
'n Ontbrekende `widget_code` lewer 400 `WIDGET_CODE_REQUIRED`, 'n widget sonder spraakfunksie 503 `VOICE_UNAVAILABLE`. Die suksesgeval veronderstel 'n widget met geaktiveerde spraakfunksie.
Chat-widget
GET /api/public/widget/healthEenvoudige bereikbaarheidstoets van die widget-diens.GET /api/public/widget/config/:widget_codeLewer die openbare konfigurasie van 'n widget (vertoonnaam, verwelkomingsteks, ontwerp, taal, spraakfunksie) vir die inisialisering in die blaaier.POST /api/public/widget/messageStuur 'n boodskap van die besoeker aan die kletsbot en lewer sy antwoord – die sentrale endpunt van die kletswidget.GET /api/public/widget/historyLaai die bestaande boodskapgeskiedenis van 'n widget-konversasie, byvoorbeeld na die herlaai van die bladsy.POST /api/public/widget/pollHaal boodskappe op wat ná 'n tydstip ontvang is – byvoorbeeld die antwoord van 'n personeellid wat die gesprek oorgeneem het.POST /api/public/widget/ratingStoor die beoordeling van die besoeker oor 'n konversasie (nuttig of nie nuttig nie).POST /api/public/widget/trackRegistreer 'n anonieme gebruiksgebeurtenis van die widget (bv. „widget geopen“) vir die evaluasies in die kontrolepaneel.POST /api/public/widget/voice-transcribeVerander 'n stemopname van die besoeker in teks (spraakinvoer), indien die spraakfunksie vir die widget geaktiveer is.