POST/api/global-chatbot/demo/voice-speak
Demo பக்கத்தில் குரல் வெளியீட்டுக்காக உரையைப் பேச்சாக மாற்றுகிறது (Text-to-Speech), இயக்கப்பட்டிருந்தால்.
`POST /api/global-chatbot/demo/voice-speak` டெமோவுக்குக் குரல் வசதி இயக்கப்பட்டிருந்தால் உரையைப் பேச்சாக மாற்றுகிறது. இந்த முனைப்புள்ளி பொது டெமோ பக்கத்தால் பயன்படுத்தப்படுகிறது; இது சுதந்திரமாகப் பயன்படுத்தக்கூடிய பொது Text-to-Speech API ஆக உத்தேசிக்கப்படவில்லை. Dashboard அங்கீகாரம் தேவையில்லை; அதற்குப் பதிலாக `https://zentor-app.de` மற்றும் `https://www.zentor-app.de` ஆகியவற்றுக்கு நிலையான Origin சோதனை பொருந்தும். Request-இல் வெளியிட வேண்டிய உரையும், ஆவணப்படுத்தப்பட்ட Schema-வில் உள்ள மொழி விருப்பங்களும் உள்ளன. டெமோ உரையாடலில் உண்மையிலேயே பேசப்பட வேண்டிய உரையை மட்டுமே Client அனுப்ப வேண்டும். காலி உள்ளீடுகள், செல்லாத வடிவங்கள் அல்லது இயக்கப்படாத குரல் வசதி ஆகியவை பிழையாகக் கையாளப்பட வேண்டும். Origin-ஐ உள்ளூரில் மாற்றுவதோ, வேறு டொமைனிலிருந்து அழைப்பதோ சர்வர் பக்கச் சோதனையைத் தவிர்க்காது. இந்தச் செயல்பாடு ஆடியோவை உருவாக்குவதால், இது idempotent ஆன வெறும் வாசிப்புச் செயல்பாடாகக் கருதப்படக்கூடாது. ஒரே உரையை மீண்டும் மீண்டும் அனுப்பினால் பல செயலாக்கங்கள் தூண்டப்படலாம். டெமோ இடைமுகம் செயலாக்கத்தின்போது வெளியீட்டுப் பொத்தானை முடக்க வேண்டும்; புதிய ஒலிபரப்பைத் தொடங்குவதற்கு முன் நடப்பில் உள்ள ஒலிபரப்புகளைச் சீராக நிறுத்த வேண்டும். ஒரு யதார்த்தமான ஓட்டம் டெமோவில் ஒரு பாட் பதிலுடன் தொடங்குகிறது. பயனர் குரல் வெளியீட்டை இயக்குகிறார்; பக்கம் பதில் உரையை `voice-speak`-க்கு அனுப்பி, ஆடியோ தரவை அல்லது ஆவணப்படுத்தப்பட்ட ஆடியோ பதிலைப் பெற்று, உலாவியில் ஒலிபரப்புகிறது. அனுமதிக்கப்படாத Origin காரணமாகக் கோரிக்கை தோல்வியடைந்தால், இடைமுகம் எந்த மாற்றுச் சேவையையும் அழைக்கக்கூடாது; மாறாகக் குரல் வசதியைக் கிடைக்காததாகக் காட்ட வேண்டும். கடவுச்சொற்கள், டோக்கன்கள் அல்லது ரகசிய உள்ளடக்கம் Request-இல் இடம்பெறக்கூடாது. டெமோ சேனல் பொதுவானது; ரகசிய நிறுவனத் தரவுக்கானது அல்ல. ஆடியோ பதில்களும் பொதுப் பதிவுகளில் நீண்ட காலம் சேமிக்கப்படக்கூடாது. இந்த முனைப்புள்ளி தொழில்நுட்ப ரீதியாக SIP-Voicebot-இலிருந்து பிரிக்கப்பட்டது. தொலைபேசி சேவை ஒவ்வொரு குத்தகைதாரருக்கும் தனிமைப்படுத்தப்பட்ட SIP நிகழ்வுகளில் இயங்குகிறது; Master Admin மட்டுமே அதைச் செயல்படுத்த முடியும்; `voice-speak` எந்தத் தொலைபேசி எண்ணையும் கட்டுப்படுத்துவதில்லை, தொலைபேசி அழைப்பையும் தொடங்குவதில்லை. அணுகல்தன்மைக்காக, டெமோ ஆடியோ வெளியீட்டுடன் எப்போதும் முழு உரையையும் காட்ட வேண்டும். குரல் வெளியீடு திரையில் இல்லாத எந்தத் தகவலையும் கொண்டிருக்கக்கூடாது. பயனர் தொடர்பு நிகழும் வரை உலாவிகள் ஒலிபரப்பைத் தடுக்கலாம்; எனவே தொடக்கம் வேண்டுமென்றே ஒரு கிளிக்கால் தூண்டப்பட வேண்டும். நிறுத்துதலும் மீண்டும் ஒலிபரப்புதலும் கட்டுப்பாட்டுடன் சாத்தியமாக இருக்க வேண்டும்.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
Origin சோதனை https://zentor-app.de / https://www.zentor-app.de என நிலையாக அமைக்கப்பட்டுள்ளது (உள்ளமைக்க முடியாது; டெமோ பாதையில் Widget-டோக்கனுக்கு மாற்று).
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): ஆம்
அளவுருக்கள்
visitor_id(body, string, கட்டாயம்)— ஒரு செல்லுபடியாகும் UUID ஆக இருக்க வேண்டும்text(body, string, கட்டாயம்)— பேச்சாக மாற்ற வேண்டிய உரைஎடுத்துக்காட்டுப் பதில்
{"ok":false,"error":{"code":"VOICE_UNAVAILABLE","message":"குரல் வசதி தற்போது கிடைக்கவில்லை."}}பிழைக் குறியீடுகள்
400 INVALID_VISITOR_ID — visitor_id இல்லை அல்லது செல்லுபடியாகாத UUID.403 ORIGIN_DENIED — கோரிக்கையின் Origin zentor-app.de அல்ல.503 VOICE_UNAVAILABLE — குரல் வசதி தற்போது கிடைக்கவில்லை.நேரலைச் சோதனைச் சான்று
எதிர்மறை நிலைகள் (400 INVALID_VISITOR_ID, 503 VOICE_UNAVAILABLE, ஒவ்வொன்றும் சரியான Origin-Header உடன்) நேரடியாகச் சரிபார்க்கப்பட்டன. இதே பாதையின் GET வகையும் உள்ளது (இயல்பான <audio src> ஸ்ட்ரீமிங், ஒரே நடத்தை). widget.voice_speak-இன் டெமோ இணை.