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 kupachika
text(body, string, inahitajika)— Maandishi yanayopaswa kusomwa

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

Makala zinazohusiana

← Wijeti ya mazungumzo