POST/api/public/widget/voice-transcribe
Hubadilisha rekodi ya sauti ya mgeni kuwa maandishi (uwekaji wa sauti), iwapo kipengele cha sauti cha wijeti kimewezeshwa.
Tumeni `widget_code` na data ya sauti katika sehemu `audio` kama `multipart/form-data`. Jibu linajumuisha maandishi yaliyotambuliwa, mnayoyatuma baadaye kupitia `POST /api/public/widget/message`. Iwapo kipengele cha sauti kinafanya kazi huonyeshwa na `voice_enabled` katika usanidi wa wijeti. `widget_code` ikikosekana, seva hujibu kwa 400 `WIDGET_CODE_REQUIRED`; iwapo kipengele cha sauti hakijawezeshwa au hakipatikani kwa sasa, kwa 503 `VOICE_UNAVAILABLE`. Kipengele cha sauti huwekwa na Zentor kwa wijeti yenu.
Muhtasari
Mwito: POST /api/public/widget/voice-transcribe. 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 si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: widget_code (body), audio (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: Hapana
Vigezo
widget_code(body, string, inahitajika)— Msimbo wa wijeti kutoka msimbo wako wa kupachikaaudio(body, binary, inahitajika)— Rekodi ya sauti kama faili (`multipart/form-data`)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-speakHubadilisha maandishi kuwa lugha inayosemwa (matokeo ya sauti kwenye wijeti), iwapo kipengele cha sauti kimewezeshwa.