POST/api/global-chatbot/demo/voice-speak
Konverton tekst në gjuhë të folur (Text-to-Speech) për zërin në faqen e demonstrimit, nëse është aktivizuar.
`POST /api/global-chatbot/demo/voice-speak` e kthen tekstin në të folur, nëse funksioni i zërit është aktivizuar për demon. Pika përfundimtare përdoret nga faqja publike demo dhe nuk është menduar si API e përgjithshme text-to-speech e lirë për përdorim. Nuk kërkohet autentifikim në dashboard, por vlen një kontroll fiks i Origin-it për `https://zentor-app.de` dhe `https://www.zentor-app.de`. Kërkesa përmban tekstin që do të lexohet dhe opsionet e zërit të paraqitura në skemën e dokumentuar. Klienti duhet të dërgojë vetëm tekst që duhet të lexohet realisht në dialogun demo. Hyrjet e zbrazëta, formatet e pavlefshme ose një funksion zëri i paaktivizuar duhet të trajtohen si gabim. Një ndryshim lokal i Origin-it ose një thirrje nga një domen i huaj nuk e anashkalon kontrollin në server. Operacioni gjeneron audio dhe për këtë arsye nuk duhet të konsiderohet një operacion leximi i pastër dhe idempotent. Dërgimi i të njëjtit tekst disa herë mund të shkaktojë disa procese përpunimi. Ndërfaqja demo duhet ta çaktivizojë butonin e daljes gjatë përpunimit dhe t'i ndalojë me rregull riprodhimet në vazhdim përpara se të nisë një i ri. Një rrjedhë realiste fillon me një përgjigje të botit në demo. Përdoruesi aktivizon daljen e zërit, faqja ia dërgon tekstin e përgjigjes `voice-speak`, merr të dhënat audio ose përgjigjen audio të dokumentuar dhe e riprodhon në shfletues. Nëse kërkesa dështon për shkak të një Origin-i të palejuar, ndërfaqja nuk duhet të thërrasë asnjë shërbim zëvendësues të çfarëdo lloji, por duhet ta shfaqë funksionin e zërit si të padisponueshëm. Fjalëkalimet, tokenët ose përmbajtjet konfidenciale nuk i përkasin kërkesës. Kanali demo është publik dhe nuk është menduar për të dhëna të fshehta të kompanisë. As përgjigjet audio nuk duhet të ruhen përgjithmonë në logje publike. Pika përfundimtare është teknikisht e ndarë nga SIP-Voicebot. Telefonia funksionon në instanca të izoluara SIP për çdo tenant dhe aktivizohet ekskluzivisht nga Master Admin; `voice-speak` nuk kontrollon asnjë numër telefoni dhe nuk fillon asnjë thirrje telefonike. Për aksesueshmërinë, demoja duhet të shfaqë gjithmonë tekstin e plotë përveç daljes audio. Dalja e zërit nuk duhet të përmbajë asnjë informacion që mungon vizualisht. Shfletuesit mund ta bllokojnë riprodhimin për sa kohë nuk ka ndërveprim të përdoruesit; prandaj nisja duhet të shkaktohet me vetëdije me një klikim. Ndërprerja dhe riprodhimi i përsëritur duhet të jenë të mundshme në mënyrë të kontrolluar.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Kontrolli i Origin-it është i fiksuar te https://zentor-app.de / https://www.zentor-app.de (jo i konfigurueshëm, zëvendëson token-in e widget-it në rrugën demo).
Idempotent: Po
Parametrat
visitor_id(body, string, i detyrueshëm)— Duhet të jetë një UUID i vlefshëmtext(body, string, i detyrueshëm)— Teksti që do të kthehet në të folurShembull response-i
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Funksioni i zërit aktualisht nuk është i disponueshëm."}}Kodet e gabimeve
400 INVALID_VISITOR_ID — mungon visitor_id ose nuk është një UUID i vlefshëm.403 ORIGIN_DENIED — Origjina e kërkesës nuk është zentor-app.de.503 VOICE_UNAVAILABLE — Funksioni i zërit aktualisht nuk është i disponueshëm.Prova e testit live
Rastet negative (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, secili me header Origin të saktë) u verifikuan live. Ekziston edhe një variant GET i të njëjtës rrugë (streaming natyror <audio src>, sjellje identike). Ekuivalenti demo i widget.voice_speak.