POST/api/public/widget/voice-speak
Hubadilisha maandishi kuwa lugha inayosemwa (matokeo ya sauti kwenye wijeti), iwapo kipengele cha sauti kimewezeshwa.
Tumeni `widget_code` na maandishi ya kusoma katika `text`. Jibu linajumuisha data ya sauti kwa uchezaji kwenye kivinjari. Kwa uchezaji wa moja kwa moja kupitia kipengele `<audio>`, njia ile ile inapatikana zaidi kwa GET. `widget_code` ikikosekana, seva hujibu kwa 400 `WIDGET_CODE_REQUIRED`; iwapo kipengele cha sauti hakijawezeshwa au hakipatikani kwa sasa, kwa 503 `VOICE_UNAVAILABLE`. Anzisheni uchezaji mpya tu baada ya uliotangulia kukamilika.
Muhtasari
Mwito: POST /api/public/widget/voice-speak. Endpoint hii ni sehemu ya kundi la “Wijeti ya mazungumzo” la API ya Zentor App. Inahitaji tokeni halali ya kupachika wijeti (widget embed token). Mwito huu ni idempotent: miito inayorudiwa yenye data ileile hurudisha matokeo yaleyale. Vigezo vya lazima: widget_code (body), text (body). Hali za hitilafu zilizoandikwa: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Embed token ya widget (header X-Widget-Token) + orodha ya origins zilizoidhinishwa
Idempotent: Ndiyo
Vigezo
widget_code(body, string, inahitajika)— Msimbo wa wijeti kutoka msimbo wako wa kupachikatext(body, string, inahitajika)— Maandishi yanayopaswa kusomwaMfano wa jibu (response)
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}Misimbo ya hitilafu
400 WIDGET_CODE_REQUIRED — Sehemu `widget_code` inakosekana.503 VOICE_UNAVAILABLE — Kipengele cha sauti hakijawezeshwa kwa wijeti hii au hakipatikani kwa sasa.Tabia iliyoangaliwa
`widget_code` inayokosekana hutoa 400 `WIDGET_CODE_REQUIRED`, wijeti isiyo na kipengele cha sauti 503 `VOICE_UNAVAILABLE`. Hali ya ufanisi inahitaji wijeti yenye kipengele cha sauti kilichowezeshwa.
Wijeti ya mazungumzo
GET /api/public/widget/healthUkaguzi rahisi wa upatikanaji wa huduma ya wijeti.GET /api/public/widget/config/:widget_codeHutoa usanidi wa umma wa wijeti (jina linaloonyeshwa, ujumbe wa karibu, mandhari, lugha, kipengele cha sauti) kwa uanzishaji kwenye kivinjari.POST /api/public/widget/messageHutuma ujumbe wa mgeni kwa chatbot na kutoa jibu lake – kipengele kikuu cha wijeti ya gumzo.GET /api/public/widget/historyHupakia historia iliyopo ya ujumbe wa mazungumzo ya wijeti, kwa mfano baada ya kupakia upya ukurasa.POST /api/public/widget/pollInarudisha ujumbe uliopokelewa baada ya wakati fulani – kwa mfano jibu la mfanyakazi aliyechukua mazungumzo.POST /api/public/widget/ratingHuhifadhi tathmini ya mgeni kuhusu mazungumzo (yenye manufaa au bila manufaa).POST /api/public/widget/trackHurekodi tukio la matumizi lisilojulikana la wijeti (mf. „wijeti imefunguliwa“) kwa uchambuzi kwenye dashibodi.POST /api/public/widget/voice-transcribeHubadilisha rekodi ya sauti ya mgeni kuwa maandishi (uwekaji wa sauti), iwapo kipengele cha sauti cha wijeti kimewezeshwa.