GET/api/global-chatbot/demo/history
டெமோ உரையாடலின் முந்தைய செய்தி வரலாற்றை ஏற்றுகிறது, இதனால் டெமோவை மீண்டும் திறக்கும்போது அது பாதுகாக்கப்படும்.
`session_id` மற்றும் `visitor_id`-ஐ வினவல் அளவுருக்களாக அனுப்பவும்; இரண்டும் அதே டெமோ உரையாடலில் இருந்து இருக்க வேண்டும். பதிலில் `data` பொருளில் `id`, `role`, `text`, `created_at` உடன் `messages` பட்டியல் அடங்கும். இந்த அழைப்பு படிக்க மட்டும், idempotent. ஒரு அளவுரு இல்லாவிட்டால், சர்வர் 400 `PARAMS_REQUIRED` உடன் பதிலளிக்கும். அமர்வு இனி அறியப்படாவிட்டால், புதிய டெமோ உரையாடலைத் தொடங்கவும்.
கண்ணோட்டம்
அழைப்பு: GET /api/global-chatbot/demo/history. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “டெமோ சாட்பாட் மற்றும் SSO” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent ஆகும்: அதே உள்ளீடுகளுடன் மீண்டும் மீண்டும் அழைத்தால் அதே முடிவு கிடைக்கும். கட்டாய அளவுருக்கள்: session_id (குவெரி), visitor_id (குவெரி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 400 PARAMS_REQUIRED. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): ஆம்
அளவுருக்கள்
session_id(query, string, கட்டாயம்)— டெமோ உரையாடலின் அமர்வு ஐடிvisitor_id(query, string, கட்டாயம்)— டெமோ பக்கம் உருவாக்கும் பார்வையாளர் ஐடி (UUID)எடுத்துக்காட்டுப் பதில்
{"ok": true, "data": {"messages": [{"id": "f248d929-c9ce-412d-aba8-43808ca1c9f7", "role": "user", "text": "வணக்கம், Zentor-ன் விலை என்ன?", "created_at": "2026-07-20T17:07:02.240Z"}, {"id": "3c26b6a6-4ca6-47a9-9669-a052082007ac", "role": "assistant", "text": "நான் உங்கள் பயன்பாட்டுக்கு ஏற்ப இது எப்படி இருக்கலாம் என்பதைக் காட்டலாம் — எந்தவொரு கட்டாயமும் இன்றி.", "created_at": "2026-07-20T17:07:02.329Z"}]}}பிழைக் குறியீடுகள்
400 PARAMS_REQUIRED — `session_id` அல்லது `visitor_id` இல்லை.சரிபார்க்கப்பட்ட நடத்தை
ஏற்கனவே உள்ள டெமோ அமர்வு 200 உடன் வரலாற்றைத் தரும்; இல்லாத அளவுருக்கள் 400 `PARAMS_REQUIRED` தரும்.
டெமோ சாட்பாட் மற்றும் SSO
POST /api/global-chatbot/demozentor-app.de/demo-இல் உள்ள பொது டெமோ சாட்பாட்டிற்கு ஒரு செய்தியை அனுப்பி, அதன் பதிலை வழங்குகிறது. பதிவு செய்யாமலேயே உலாவியில் டெமோவை முயற்சிக்கலாம்.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டெமோ பக்கத்தில் உள்ள குரல் பதிவை உரையாக மாற்றுகிறது (குரல் உள்ளீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.POST /api/global-chatbot/demo/voice-speakஉரையை பேச்சாக மாற்றுகிறது (டெமோ பக்கத்தில் குரல் வெளியீடு), டெமோவின் குரல் வசதி செயலில் இருந்தால்.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) வழங்குகிறது.