POST/api/global-chatbot/demo/voice-speak
Muuntaa tekstin puheeksi (teksti-puheeksi) ja toistaa sen demo-sivulla, jos tämä toiminto on käytössä.
`POST /api/global-chatbot/demo/voice-speak` muuntaa tekstin puheeksi, jos kielitoiminto on aktivoitu demoversiolle. Tämä päätepiste on tarkoitettu julkisen demo-sivun käyttöön, eikä sitä ole tarkoitettu yleiseksi, vapaasti käytettäväksi tekstistä puheeksi -rajapinnaksi. Käyttöliittymän tunnistautumista ei vaadita, vaan käytössä on kiinteä alkuperätarkistus osoitteille `https://zentor-app.de` ja `https://www.zentor-app.de`.. Pyynnössä on mukana luettava teksti ja dokumentoidut kielivaihtoehdot. Asiakkaan tulee lähettää vain tekstiä, joka todella on tarkoitus lukea demo-dialogissa. Tyhjät syötteet, virheelliset muodot tai ei-aktivoidut kielitoiminnot on käsiteltävä virheinä. Paikallinen alkuperän muutos tai kutsu ulkoiselta verkkotunnukselta ei ohita palvelinpuolen tarkistusta. Operaatio tuottaa ääntä, joten sitä ei voida pitää idempotenttina, eli toistuvasti luettavana operaationa. Saman tekstin toistuva lähettäminen voi käynnistää useita käsittelyjä. Käyttöliittymän tulisi poistaa toiston painike käytöstä käsittelyn aikana ja lopettaa käynnissä olevat toistot siististi ennen uuden toiston aloittamista. Tyypillinen prosessi alkaa botin vastauksella demossa. Käyttäjä aktivoi puhetoiminnon, sivusto lähettää vastauksen tekstin osoitteeseen `voice-speak`, vastaanottaa äänidataa tai dokumentoidun äänivastauksen ja toistaa sen selaimessa. Jos pyyntö epäonnistuu, koska alkuperä ei ole sallittu, käyttöliittymän ei tule kutsua mitään korvaavaa palvelua, vaan sen tulee näyttää puhetoiminto ei-käytettävänä. Salasanat, tunnukset tai luottamuksellinen sisältö eivät saa olla pyynnössä. Demo-kanava on julkinen, eikä sitä ole tarkoitettu yrityksen salaisiin tietoihin. Myös äänivastauksia ei tule tallentaa pysyvästi julkisiin lokitiedostoihin. Tämä päätepiste on teknisesti erillinen SIP-äänibotista. Puhelinliikenne tapahtuu erillisissä SIP-instansseissa asiakkaittain, ja se aktivoidaan ainoastaan pääkäyttäjän toimesta; `voice-speak` ei hallitse puhelinnumeroita eikä aloita puheluita. Esteettömyyden vuoksi demon tulee näyttää aina koko teksti lisäksi äänitoiston lisäksi. Puhetoiminnon ei tule sisältää tietoja, jotka puuttuvat visuaalisesti. Selain voi estää toiston, jos käyttäjän toimintaa ei ole tapahtunut; siksi toiston tulisi alkaa tietoisesti käyttäjän napsautuksen seurauksena. Keskeytys ja uudelleen toisto on oltava hallittuja toimintoja.
Auth & Absicherung
Keine Authentifizierung erforderlich
Alkuperäisyystarkistus on kiinteästi asetettu https://zentor-app.de / https://www.zentor-app.de (ei konfiguroitavissa, korvaa widget-tunnisteen demopolulla).
Idempotent: Ja
Parameter
visitor_id(body, string, erforderlich)— Sen täytyy olla kelvollinen UUID.text(body, string, erforderlich)— Teksti, joka muunnetaan puheeksi.Beispiel-Response
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Puhetoiminto ei ole tällä hetkellä käytettävissä."}}Fehlercodes
400 INVALID_VISITOR_ID — visitor_id-tunnus puuttuu tai se ei ole kelvollinen UUID.403 ORIGIN_DENIED — Pyynnön alkuperä ei ole zentor-app.de.503 VOICE_UNAVAILABLE — Kielitoiminto ei ole tällä hetkellä käytettävissä.Live-Test-Nachweis
Negatiiviset tapaukset (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, joissa kummassakin on oikea Origin-otsake) on vahvistettu reaaliajassa. Samaa polkua on myös GET-versio (natiivi <audio src>-suoratoisto, sama käyttäytyminen). Demo-versio vastaa widget.voice_speak -toimintoa.