POST/api/global-chatbot/demo/poll
नई, असिंक्रोनस रूप से प्राप्त हुई डेमो चैट सत्र की संदेशों को पूछता है (उदाहरण के लिए, जब एक मानव एजेंट मास्टर-एडमिन में ले लिया हो) — विजेट द्वारा नियमित रूप से कॉल किया जाता है।
`POST /api/global-chatbot/demo/poll` एक मौजूदा डेमो सत्र के लिए नई संदेशों या स्थिति परिवर्तनों को पॉल करता है। बॉडी में `session_id` और `visitor_id` होते हैं। दोनों मान एक ही सार्वजनिक डेमो संवाद से होने चाहिए। यदि कोई भी पैरामीटर अनुपस्थित है, तो सर्वर `400 PARAMS_REQUIRED` के साथ उत्तर देता है। इस राउट के लिए उपयोगकर्ता लॉगिन की आवश्यकता नहीं होती है और यह डेमो सत्र की वर्तमान स्थिति को पढ़ता है। इसका उपयोग तब किया जाता है जब उत्तर तुरंत पिछले अनुरोध के साथ वापस नहीं आता है या जब इंटरफ़ेस बाद में प्राप्त संदेशों को प्रदर्शित करना चाहता है। पॉलिंग संदेश भेजने का विकल्प नहीं है; यह स्वयं कोई नया विज़िटर अनुरण नहीं बनाता है। क्लाइंट को कॉल के बीच उचित विराम रखना चाहिए। एक कसकर बंद लूप लोड बढ़ा सकता है और दर सीमाओं (rate limits) को ट्रिगर कर सकता है, बिना तेज़ी से उत्तर उत्पन्न किए। यदि सत्र समाप्त हो जाता है, अमान्य हो जाता है या अब खोजा नहीं जा सकता है, तो पॉलिंग को रोक देना चाहिए और इंटरफ़ेस को एक नई शुरुआत का विकल्प प्रदान करना चाहिए। रद्द की गई पेज या छिपे हुए टैब को स्थायी रूप से चलने वाले बैकग्राउंड अनुरण नहीं छोड़ने चाहिए। `session_id` और `visitor_id` अन्य संवादों के लिए सामान्य प्रवेश प्रमाण नहीं हैं। इन्हें विज़िटरों के बीच साझा नहीं किया जाना चाहिए या संदेशों के साथ सार्वजनिक विश्लेषण उपकरणों को नहीं भेजा जाना चाहिए। डेमो, टेनेंट संवादों और उत्पादित इनबॉक्स डेटा से अलग रहता है। एक सही परीक्षण एक डेमो सत्र शुरू करता है, एक संदेश भेजता है और फिर उसी पहचानकर्ताओं के साथ पॉल को कॉल करता है। इसके अलावा, एक अनुरण बिना `visitor_id` के भी जाँचा जाता है। दस्तावेज़ीकृत नकारात्मक परीक्षण एक त्रुटि प्रमाण है, यह प्रमाण नहीं है कि एक पूर्ण उत्पादित संवाद सफलतापूर्वक पूरा हुआ है।
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Ja
Parameter
session_id(body, string, erforderlich)visitor_id(body, string, erforderlich)Beispiel-Request
{"session_id":"<UUID>","visitor_id":"<UUID>"}Beispiel-Response
{"ok":true,"data":{"messages":[]}}Fehlercodes
400 PARAMS_REQUIRED — session_id और/या visitor_id अनुपलब्ध हैं।Live-Test-Nachweis
सफलता (200, खाली सूची क्योंकि डेमो.चैट के बाद से कोई नए असिंक्रोनस संदेश नहीं हैं) और नकारात्मक मामला (400) लाइव सत्यापित किया गया।