POST/api/global-chatbot/demo/poll
নতুন, অ্যাসিঙ্ক্রোনাসভাবে আগত ডেমো চ্যাট-সেশনের বার্তাগুলি পোল করে (যেমন, যখন মাস্টার-অ্যাডমিনে একজন মানব এজেন্ট দায়িত্ব নিয়েছে) — উইজেট দ্বারা পর্যায়ক্রমে কল করা হয়।
`POST /api/global-chatbot/demo/poll` একটি বিদ্যমান ডেমো সেশনের জন্য নতুন বার্তা বা অবস্থা পরিবর্তন জিজ্ঞাসা করে। বডিতে `session_id` এবং `visitor_id` থাকে। উভয় মান একই পাবলিক ডেমো কথোপকথন থেকে আসতে হবে। কোনো প্যারামিটার অনুপস্থিত থাকলে, সার্ভার `400 PARAMS_REQUIRED` দিয়ে উত্তর দেয়। রুটটির জন্য ব্যবহারকারীর লগইন প্রয়োজন হয় না এবং এটি ডেমো সেশনের বর্তমান অবস্থা পড়ে। এটি ব্যবহার করা হয় যখন একটি উত্তর পূর্ববর্তী অনুরোধের সাথে সাথে ফিরে আসে না বা যখন ইন্টারফেস পরে আসা বার্তাগুলি প্রদর্শন করতে চায়। পোলিং একটি বার্তা পাঠানোর বিকল্প নয়; এটি নিজে কোনো নতুন দর্শকের অনুরোধ তৈরি করে না। ক্লায়েন্টকে কলগুলির মধ্যে একটি উপযুক্ত বিরতি বজায় রাখতে হবে। একটি সংকীর্ণ অসীম লুপ লোড বাড়ায় এবং দ্রুত উত্তর তৈরি না করেই রেট-লিমিট ট্রিগার করতে পারে। সেশনটি শেষ, অবৈধ বা আর খুঁজে না পাওয়া গেলে, পোলিং বন্ধ করা উচিত এবং ইন্টারফেস একটি নতুন শুরু অফার করবে। বাতিল করা পৃষ্ঠা বা লুকানো ট্যাবগুলির পেছনে স্থায়ীভাবে চলমান অনুরোধ থাকা উচিত নয়। `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, খালি তালিকা যেহেতু demo.chat থেকে কোনো নতুন অ্যাসিঙ্ক্রোনাস বার্তা নেই) এবং নেতিবাচক ক্ষেত্রে (400) লাইভ যাচাই করা হয়েছে।