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

Hubadilisha maandishi kuwa sauti ya kusemwa (Text-to-Speech) kwa utoaji wa sauti kwenye ukurasa wa demo, ikiwa imewashwa.

`POST /api/global-chatbot/demo/voice-speak` hubadilisha maandishi kuwa sauti ya kusemwa, ikiwa kipengele cha sauti kimewashwa kwa demo. Endpoint hii hutumiwa na ukurasa wa demo wa umma na haikusudiwi kuwa API ya jumla ya Text-to-Speech inayoweza kutumika kwa uhuru. Uthibitishaji wa utambulisho wa Dashboard hauhitajiki; badala yake kuna ukaguzi thabiti wa Origin kwa `https://zentor-app.de` na `https://www.zentor-app.de`. Ombi lina maandishi ya kutolewa na chaguo za sauti zilizotolewa katika schema iliyoandikwa. Client anapaswa kutuma tu maandishi yanayopaswa kusemwa kweli katika mazungumzo ya demo. Maingizo tupu, miundo isiyo halali au kipengele cha sauti ambacho hakijawashwa lazima vishughulikiwe kama hitilafu. Kubadilisha Origin kwa ndani au kuita kutoka domain ya nje hakupiti ukaguzi wa upande wa seva. Operesheni hii huzalisha sauti na kwa hiyo haipaswi kuchukuliwa kama operesheni ya kusoma tu iliyo idempotent. Kutuma maandishi yaleyale mara nyingi kunaweza kuanzisha michakato kadhaa ya uchakataji. Kiolesura cha demo kinapaswa kuzima kitufe cha kutoa sauti wakati wa uchakataji na kumaliza vizuri uchezaji unaoendelea kabla ya kuanzisha mpya. Mtiririko halisi huanza na jibu la bot katika demo. Mtumiaji huwasha utoaji wa sauti, ukurasa hutuma maandishi ya jibu kwa `voice-speak`, hupokea data za sauti au jibu la sauti lililoandikwa, na kulicheza kwenye kivinjari. Ombi likishindwa kwa sababu ya Origin isiyoruhusiwa, kiolesura hakipaswi kuita huduma mbadala yoyote, bali kinapaswa kuonyesha kwamba kipengele cha sauti hakipatikani. Manenosiri, tokeni au maudhui ya siri hayapaswi kuwa kwenye ombi. Chaneli ya demo ni ya umma na haikusudiwi kwa data za siri za kampuni. Hata majibu ya sauti hayapaswi kuhifadhiwa kwa kudumu kwenye kumbukumbu (logs) za umma. Endpoint hii imetenganishwa kiufundi na SIP-Voicebot. Huduma ya simu huendeshwa katika instances za SIP zilizotengwa kwa kila mpangaji na huwashwa na Master Admin pekee; `voice-speak` haidhibiti namba yoyote ya simu na haianzishi simu. Kwa ajili ya ufikivu, demo inapaswa kuonyesha kila mara maandishi kamili pamoja na sauti. Sauti haipaswi kuwa na taarifa ambayo haionekani kwa macho. Vivinjari vinaweza kuzuia uchezaji hadi mtumiaji afanye kitendo; kwa hiyo kuanza kunapaswa kuanzishwa kwa makusudi kwa kubofya. Kusimamisha na kucheza tena lazima kuwezekane kwa udhibiti.

Uthibitishaji na ulinzi

Hakuna uthibitishaji unaohitajika

Ukaguzi wa Origin umewekwa kwa kudumu kwa https://zentor-app.de / https://www.zentor-app.de (hauwezi kusanidiwa, ni mbadala wa Widget-Token kwenye njia ya demo).

Idempotent: Ndiyo

Vigezo

visitor_id(body, string, inahitajika)— Lazima iwe UUID halali
text(body, string, inahitajika)— Maandishi ya kubadilishwa kuwa sauti

Mfano wa jibu (response)

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

Misimbo ya hitilafu

400 INVALID_VISITOR_ID — visitor_id haipo au si UUID halali.
403 ORIGIN_DENIED — Asili ya ombi si zentor-app.de.
503 VOICE_UNAVAILABLE — Kipengele cha sauti hakipatikani kwa sasa.

Uthibitisho wa jaribio la moja kwa moja

Kesi hasi (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, kila moja ikiwa na Origin-Header sahihi) zimethibitishwa moja kwa moja (live). Toleo la GET la njia hiyohiyo pia lipo (utiririshaji asilia wa <audio src>, tabia inayofanana). Ni mwenzake wa demo wa widget.voice_speak.

← Chatbot ya demo na SSO