POST/api/global-chatbot/demo/poll
מבקש הודעות חדשות שהגיעו באופן אסינכרוני של מפגש צ'אט לדוגמה (למשל, כאשר סוכן אנושי לקח אחריות בממשק ניהול ראשי) — נקרא באופן מחזורי על ידי הווידג'ט.
`POST /api/global-chatbot/demo/poll` שואל הודעות חדשות או שינויי סטטוס עבור שיחת הדגמה קיימת. גוף הבקשה מכיל את `session_id` ואת `visitor_id`. שני הערכים חייבים להגיע מאותה שיחת הדגמה ציבורית. אם אחד מהפרמטרים חסר, השרת יחזיר תגובה `400 PARAMS_REQUIRED`. הנתיב אינו דורש התחברות של משתמש וקורא את המצב הנוכחי של שיחת ההדגמה. הוא משמש כאשר תגובה לא חוזרת מיד עם הבקשה הקודמת, או כאשר הממשק צריך להציג הודעות שהגיעו מאוחר יותר. שאילתה חוזרת (Polling) אינה מהווה תחליף לשליחת הודעה; היא לא יוצרת בקשת מבקר חדשה בעצמה. הלקוח חייב להשאיר הפסקה מתאימה בין הפניות. לולאה אינסופית צפופה מגבירה את העומס ועלולה להפעיל מגבלות קצב (Rate-Limits) מבלי לייצר תגובה מהירה יותר. אם השיחה מסתיימת, הופכת לא חוקית או שאינה נמצאת עוד, יש להפסיק את השאילתה החוזרת ולספק לממשק אפשרות להתחלה חדשה. דפדפנים שבוטלו או לשוניות מוסתרות לא צריכות להשאיר בקשות רקע רצות לנצח. `session_id` ו-`visitor_id` אינם פרטי גישה כלליים לשיחות אחרות. אסור לשתף אותם בין מבקרים או לשלוח אותם יחד עם הודעות לכלי ניתוח ציבוריים. ההדגמה נשארת מופרדת משיחות של Tenant ומנתוני תיבת הדואר (Inbox) הפעילים. בדיקה נכונה מתחילה בשיחת הדגמה, שולחת הודעה ואז מבצעת שאילתה חוזרת (Poll) עם אותם מזהים. בנוסף, נבדקת בקשה ללא `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) אומתו בזמן אמת.