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

உரையை பேச்சாக மாற்றுகிறது (டெமோ பக்கத்தில் குரல் வெளியீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.

`visitor_id` (UUID) மற்றும் படிக்கப்பட வேண்டிய உரையை `text`-இல் அனுப்பவும். பதிலில் பிளேபேக்கிற்கான ஒலித் தரவு அடங்கும்; `<audio>` உறுப்புக்கு அதே பாதை GET மூலமும் கிடைக்கும். இந்த இறுதிப்புள்ளி `POST /api/public/widget/voice-speak`-க்கு ஒப்பானது, ஆனால் zentor-app.de டெமோவுடன் இணைக்கப்பட்டுள்ளது, பொதுவான குரல் வெளியீட்டு இடைமுகமாக அல்ல. பிழைகள்: 400 `INVALID_VISITOR_ID` (இல்லாத அல்லது தவறான UUID), 403 `ORIGIN_DENIED` (zentor-app.de இலிருந்து அழைப்பு அல்ல), 503 `VOICE_UNAVAILABLE` (குரல் வசதி தற்போது கிடைக்கவில்லை).

கண்ணோட்டம்

அழைப்பு: POST /api/global-chatbot/demo/voice-speak. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “டெமோ சாட்பாட் மற்றும் SSO” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent ஆகும்: அதே உள்ளீடுகளுடன் மீண்டும் மீண்டும் அழைத்தால் அதே முடிவு கிடைக்கும். கட்டாய அளவுருக்கள்: visitor_id (பாடி), text (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 INVALID_VISITOR_ID, 403 ORIGIN_DENIED, 503 VOICE_UNAVAILABLE. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.

அங்கீகாரம் & பாதுகாப்பு

அங்கீகாரம் தேவையில்லை

https://zentor-app.de மற்றும் https://www.zentor-app.de இலிருந்து மட்டுமே அழைப்புகளை ஏற்கும்; டெமோவுக்கு உட்பொதிப்பு டோக்கன் தேவையில்லை.

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 — அழைப்பு zentor-app.de இலிருந்து அல்ல.
503 VOICE_UNAVAILABLE — குரல் வசதி தற்போது கிடைக்கவில்லை.

சரிபார்க்கப்பட்ட நடத்தை

தவறான `visitor_id` 400 `INVALID_VISITOR_ID` தரும்; கிடைக்காத குரல் வசதி 503 `VOICE_UNAVAILABLE` தரும். zentor-app.de இலிருந்து மட்டுமே வெற்றி சாத்தியம்.

டெமோ சாட்பாட் மற்றும் SSO

POST /api/global-chatbot/demozentor-app.de/demo-இல் உள்ள பொது டெமோ சாட்பாட்டிற்கு ஒரு செய்தியை அனுப்பி, அதன் பதிலை வழங்குகிறது. பதிவு செய்யாமலேயே உலாவியில் டெமோவை முயற்சிக்கலாம்.GET /api/global-chatbot/demo/historyடெமோ உரையாடலின் முந்தைய செய்தி வரலாற்றை ஏற்றுகிறது, இதனால் டெமோவை மீண்டும் திறக்கும்போது அது பாதுகாக்கப்படும்.POST /api/global-chatbot/demo/pollடெமோ உரையாடலின் புதிய செய்திகளை பெறுகிறது, எடுத்துக்காட்டாக Zentor-இன் ஊழியர் ஒருவர் உரையாடலை எடுத்துக்கொண்டால். டெமோ பக்கம் இந்த இறுதிப்புள்ளியை இடைவெளிகளில் அழைக்கிறது.POST /api/global-chatbot/demo/ratingடெமோ உரையாடலின் மதிப்பீட்டை (பயனுள்ளது அல்லது பயனற்றது) விருப்ப கருத்துடன் சேமிக்கிறது.POST /api/global-chatbot/demo/trackZentor-இன் பார்வையாளர் புள்ளிவிவரங்களுக்காக டெமோ பக்கத்தின் அநாமதேய பயன்பாட்டு நிகழ்வுகளைப் பதிவு செய்கிறது.POST /api/global-chatbot/demo/voice-transcribeடெமோ பக்கத்தில் உள்ள குரல் பதிவை உரையாக மாற்றுகிறது (குரல் உள்ளீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.GET /api/sso/:tenantSlug/statusஒரு கணக்கிற்கு ஒற்றை உள்நுழைவு (SAML அல்லது OIDC) அமைக்கப்பட்டுள்ளதா எனச் சரிபார்க்கிறது. உள்நுழைவு பக்கம் முடிவைப் பயன்படுத்தி SSO உள்நுழைவை வழங்குகிறது.GET /api/sso/:tenantSlug/oidc/startOpenID Connect மூலம் உள்நுழைவைத் தொடங்கி, உலாவியை உள்ளமைக்கப்பட்ட அடையாள வழங்குநருக்குத் திருப்பி விடுகிறது.GET /api/sso/:tenantSlug/oidc/callbackOIDC உள்நுழைவுக்குப் பிறகு அடையாள வழங்குநரின் திருப்பி விடலைப் பெற்று, உலாவியை Zentor App-க்குத் திருப்பி அனுப்புகிறது.GET /api/sso/:tenantSlug/saml/startSAML மூலம் உள்நுழைவைத் தொடங்கி, உலாவியை உள்ளமைக்கப்பட்ட அடையாள வழங்குநருக்குத் திருப்பி விடுகிறது.POST /api/sso/:tenantSlug/saml/acsஉறுதிநிலை நுகர்வோர் சேவை (ACS): அடையாள வழங்குநரின் கையொப்பமிடப்பட்ட SAML பதிலை படிவ POST மூலம் பெறுகிறது.GET /api/sso/:tenantSlug/saml/metadataஉங்கள் அடையாள வழங்குநரில் இறக்குமதி செய்ய Zentor App-இன் SAML மெட்டாடேட்டாவை (XML) வழங்குகிறது.

சார்ந்த கட்டுரைகள்

உள்நுழைவு மற்றும் ஒருங்கிணைப்பு வழிகளைப் புரிந்துகொள்ளுதல்நீங்கள் எவ்வாறு பாதுகாப்பாக உள்நுழைவது - மற்றும் Zentor App-ஐ உங்கள் அமைப்புகளுடன் இணைக்கும் மூன்று வழிகள்.IP, டொமைன் மற்றும் நாட்டு அணுகல் விதிகளை உருவாக்குதல்உங்கள் சொந்த அணுகல் விதிகளை உருவாக்குதல், சோதனை முறையில் கண்காணித்தல், 24 மணி நேரத்திற்குப் பிறகு செயல்படுத்துதல்.
← டெமோ சாட்பாட் மற்றும் SSO