POST/api/global-chatbot/demo/poll

Solicită mesajele noi, primite asincron, ale unei sesiuni de chat demo (de exemplu, atunci când un agent uman preia controlul în Master-Admin) — este apelat periodic de widget.

`POST /api/global-chatbot/demo/poll` solicită noi mesaje sau modificări de stare pentru o sesiune demo existentă. Corpul conține `session_id` și `visitor_id`. Ambele valori trebuie să provină din aceeași conversație demo publică. Dacă lipsește unul dintre parametri, serverul răspunde cu `400 PARAMS_REQUIRED`. Ruta nu necesită autentificarea utilizatorului și citește starea curentă a sesiunii demo. Este utilizată atunci când un răspuns nu revine imediat cu cererea anterioară sau când interfața trebuie să afișeze mesaje sosite ulterior. Polling-ul nu este un substitut pentru trimiterea unui mesaj; nu generează el însuși o nouă solicitare din partea vizitatorului. Clientul trebuie să respecte o pauză adecvată între apeluri. O buclă infinită strânsă crește sarcina și poate declanșa limite de rată, fără a genera mai rapid un răspuns. Dacă sesiunea este încheiată, invalidă sau nu mai este găsită, polling-ul trebuie oprit și interfața trebuie să ofere un nou început. Paginile abandonate sau tab-urile ascunse nu trebuie să lase în urmă cereri de fundal care rulează permanent. `session_id` și `visitor_id` nu sunt date de acces generale pentru alte conversații. Nu trebuie partajate între vizitatori sau trimise împreună cu mesajele către instrumente de analiză publice. Demo-ul rămâne separat de conversațiile tenanților și de datele productive din inbox. Un test corect pornește o sesiune demo, trimite un mesaj și apelează apoi Poll cu aceiași identificatori. În plus, se verifică o cerere fără `visitor_id`. Testul negativ documentat este o dovadă a erorii, nu o confirmare a faptului că o conversație productivă completă a fost finalizată cu succes.

Autentificare și securitate

Nu este necesară autentificarea

Idempotent: Da

Parametri

session_id(body, string, obligatoriu)
visitor_id(body, string, obligatoriu)

Exemplu de cerere

{"session_id":"<UUID>","visitor_id":"<UUID>"}

Exemplu de răspuns

{"ok":true,"data":{"messages":[]}}

Coduri de eroare

400 PARAMS_REQUIRED — lipsește session_id și/sau visitor_id.

Dovadă test live

Succes (200, listă goală deoarece nu există mesaje asincrone noi de la demo.chat) și caz negativ (400) verificate live.

← Chatbot demo și SSO