POST/api/public/widget/voice-transcribe

Shndërron një regjistrim zanor të vizitorit në tekst (hyrje me zë), nëse funksioni i zërit është aktivizuar për widget-in.

Dërgoni `widget_code` dhe të dhënat audio në fushën `audio` si `multipart/form-data`. Përgjigja përmban tekstin e njohur, që më pas e dërgoni përmes `POST /api/public/widget/message`. Nëse funksioni i zërit është aktiv, tregohet nga `voice_enabled` në konfigurimin e widget-it. Nëse `widget_code` mungon, serveri përgjigjet me 400 `WIDGET_CODE_REQUIRED`; nëse funksioni i zërit nuk është aktivizuar ose momentalisht nuk është i disponueshëm, me 503 `VOICE_UNAVAILABLE`. Funksionin e zërit për widget-in tuaj e konfiguron Zentor.

Përmbledhje

Thirrja: POST /api/public/widget/voice-transcribe. Ky endpoint i përket grupit “Widget-i i bisedës” të API-së së Zentor App. Kërkon një token të vlefshëm për ngulitjen e widget-it (widget embed token). Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: widget_code (body), audio (body). Rastet e dokumentuara të gabimeve: 400 WIDGET_CODE_REQUIRED, 503 VOICE_UNAVAILABLE. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.

Autentifikimi dhe siguria

Widget-Embed-Token (header X-Widget-Token) + lista e lejimeve të Origin

Idempotent: Jo

Parametrat

widget_code(body, string, i detyrueshëm)— Kodi i widget-it nga kodi juaj i integrimit
audio(body, binary, i detyrueshëm)— Regjistrim audio si skedar (`multipart/form-data`)

Shembull response-i

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funksioni i zërit aktualisht nuk është i disponueshëm."}}

Kodet e gabimeve

400 WIDGET_CODE_REQUIRED — Mungon fusha `widget_code`.
503 VOICE_UNAVAILABLE — Funksioni i zërit nuk është aktivizuar për këtë widget ose momentalisht nuk është i disponueshëm.

Sjellja e verifikuar

Një `widget_code` që mungon kthen 400 `WIDGET_CODE_REQUIRED`, një widget pa funksion zëri 503 `VOICE_UNAVAILABLE`. Rasti i suksesit kërkon një widget me funksionin e zërit aktivizuar.

Widget-i i bisedës

GET /api/public/widget/healthKontroll i thjeshtë i disponueshmërisë së shërbimit të widget-it.GET /api/public/widget/config/:widget_codeKthen konfigurimin publik të një widget-i (emri i shfaqjes, mesazhi i mirëseardhjes, dizajni, gjuha, funksioni i zërit) për inicializim në shfletues.POST /api/public/widget/messageDërgon një mesazh të vizitorit te chatbot-i dhe kthen përgjigjen e tij – endpoint-i qendror i widget-it të bisedës.GET /api/public/widget/historyNgarkon historinë e mëparshme të mesazheve të një bisede widget-i, për shembull pas rifreskimit të faqes.POST /api/public/widget/pollMerr mesazhet e marra pas një momenti të caktuar – për shembull përgjigjen e një punonjësi që ka marrë përsipër bisedën.POST /api/public/widget/ratingRuan vlerësimin e vizitorit për një bisedë (e dobishme ose jo e dobishme).POST /api/public/widget/trackRegjistron një ngjarje anonime përdorimi të widget-it (p.sh. „widget-i u hap“) për analizat në panelin e kontrollit.POST /api/public/widget/voice-speakShndërron tekstin në të folur (dalje me zë në widget), nëse funksioni i zërit është aktivizuar.

Artikuj të lidhur

← Widget-i i bisedës