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 kupachika
audio(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.

Makala zinazohusiana

← Wijeti ya mazungumzo