POST/api/global-chatbot/demo/voice-speak

I-convert ang teksto sa sinasalitang wika (Text-to-Speech) para sa pagpapahayag ng audio sa pahina ng demo, kung naka-activate.

`POST /api/global-chatbot/demo/voice-speak` ay nagko-convert ng teksto sa sinasalitang anyo, basta't naka-activate ang feature ng pagsasalita para sa demo. Ang endpoint na ito ay ginagamit ng pampublikong demo page at hindi inilaan bilang isang pangkalahatang text-to-speech API na maaaring gamitin ng lahat. Hindi kinakailangan ang authentication sa dashboard, ngunit mayroong fixed na pag-verify ng origin para sa `https://zentor-app.de` at `https://www.zentor-app.de`.. Ang request ay naglalaman ng tekstong ipapasalita at ang mga opsyon sa wika na nakasaad sa dokumentasyon. Dapat lamang magpadala ang client ng tekstong talagang gustong ipasabi sa demo. Ang mga walang laman na input, hindi wastong format, o hindi naka-activate na feature ng pagsasalita ay dapat ituring na mga error. Ang lokal na pagbabago sa origin o ang pagtawag mula sa isang hindi kilalang domain ay hindi maiiwasan ang server-side na pag-verify. Ang operasyon ay lumilikha ng audio, kaya hindi ito dapat ituring na isang idempotent na operasyon na puro pagbabasa lamang. Ang paulit-ulit na pagpapadala ng parehong teksto ay maaaring magdulot ng maraming proseso. Dapat i-disable ng demo interface ang button ng paglabas habang nagpo-proseso, at dapat itigil nang maayos ang anumang kasalukuyang pag-playback bago magsimula ng bago. Ang isang tipikal na daloy ay nagsisimula sa isang tugon mula sa bot sa demo. Ina-activate ng gumagamit ang pagsasalita, ipinapadala ng pahina ang tekstong tugon sa ``voice-speak`, tumatanggap ng data ng audio o ang dokumentadong tugon ng audio, at pinapatugtog ito sa browser. Kung nabigo ang request dahil sa isang hindi pinahihintulutang origin, hindi dapat tumawag ang interface ng anumang kapalit na serbisyo, ngunit dapat ipakita ang feature ng pagsasalita bilang hindi magagamit. Ang mga password, token, o sensitibong impormasyon ay hindi dapat ilagay sa request. Ang demo channel ay pampubliko at hindi inilaan para sa mga lihim na data ng kumpanya. Hindi rin dapat permanenteng i-save ang mga tugon ng audio sa mga pampublikong log. Ang endpoint na ito ay teknikal na hiwalay sa SIP voicebot. Ang telephony ay tumatakbo sa mga nakahiwalay na SIP instance para sa bawat kliyente at ina-activate lamang ng Master Admin; ang ``voice-speak` ay hindi kumokontrol ng numero ng telepono o nagsisimula ng tawag sa telepono. Para sa accessibility, dapat ipakita ng demo ang buong teksto kasabay ng audio output. Ang pagsasalita ay hindi dapat maglaman ng anumang impormasyong nawawala sa visual na presentasyon. Maaaring i-block ng mga browser ang pag-playback hangga't walang interaksyon ng gumagamit; samakatuwid, dapat simulan ang pag-playback nang may layunin sa pamamagitan ng pag-click. Dapat na posible ang pag-pause at pag-uulit ng pag-playback.

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Ang feature na ito ay kasalukuyang hindi magagamit."}}