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

Skakel teks na gesproke audio om (Text-to-Speech) vir die Demo wanneer Voice aktief is.

`POST /api/global-chatbot/demo/voice-speak` genereer spraakuitset vir die publieke Demo wanneer Voice aktief is. Die endpoint is nie 'n algemene publieke TTS-diens nie en gebruik die vaste Demo-Origin-kontrole vir zentor-app.de. Stuur slegs die teks wat werklik in die Demo gelees moet word. Meervoudige requests kan meervoudige verwerking aktiveer; die UI behoort dubbele afspeelaksies te beheer. Moenie Secrets of sensitiewe data vir spraakuitset gebruik nie. Die Demo is publiek. Hierdie Voice-endpoint is tegnies apart van die Zentor SIP-Voicebot en begin geen telefoonoproepe nie.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Origin-kontrole vas ingestel op https://zentor-app.de / https://www.zentor-app.de (nie konfigureerbaar nie, vervang die Widget-Token op die demo-pad).

Idempotent: Ja

Parameters

visitor_id(body, string, vereis)— Moet 'n geldige UUID wees
text(body, string, vereis)— Teks wat na spraak omgeskakel moet word

Voorbeeldrespons

{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"Sprachfunktion aktuell nicht verfügbar."}}

Foutkodes

400 INVALID_VISITOR_ID — visitor_id ontbreek of is nie 'n geldige UUID nie.
403 ORIGIN_DENIED — Request-Origin is nie zentor-app.de nie.
503 VOICE_UNAVAILABLE — Voice-funksie tans nie beskikbaar nie.

Bewys van live-toets

Negatiewe gevalle (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, elk met die korrekte Origin-header) is live geverifieer. 'n GET-variant van dieselfde pad bestaan ook (native <audio src>-streaming, identiese gedrag). Demo-eweknie van widget.voice_speak.

← Demo Chatbot & SSO