POST/api/global-chatbot/demo/poll

Demo-чат сессиясының асинхрон түрде келген жаңа хабарламаларын сұраңыз (мысалы, егер адам агенті Master-Admin-да қабылдаған болса) — виджет кезең-кезеңімен шақырады.

`POST /api/global-chatbot/demo/poll` әдемі сессияға арналған жаңа хабарламаларды немесе жағдай өзгерістерін сұрау үшін қолданылады. Тән (body) `session_id` және `visitor_id` мәндерін қамтиды. Екі мән де бірдей ашық әдемі сөйлесуден алынған болуы кері. Егер параметрлердің бірі болмаса, сервер `400 PARAMS_REQUIRED` жауабын қайтарады. Бұл маршрут пайдаланушының кіруін талап етпейді және әдемі сессияның ағымдағы күйін оқиды. Ол жауап алдыңғы сұраныспен бірден қайтпағанда немесе интерфейс кейінірек келген хабарламаларды көрсетуі қажет болғанда қолданылады. Polling хабарлама жіберудің орнын баспайды; ол өз бетінше жаңа қонақ сұранысын тудырмайды. Клиент сұраныстар арасында тиісті үзіліс жасауы кері. Тар циклдік шексіз цикл жүктемені арттырады және жауапты тезірек алуға мүмкіндік бермей, rate-шектелулерді тудыруы мүмкін. Сессия аяқталса, жарамсыз болса немесе табылмаса, polling тоқтатылуы кері және интерфейс жаңа бастауды ұсынуы кері. Аяқталған беттер немесе жасырын вкладкалар тұрақты фондық сұраныстарды қалдырмауы кері. `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_REQUIREDsession_id және/немесе visitor_id жоқ.

Live-Test-Nachweis

Сәттілік (200, demo.chat-тен бері жаңа асинхронды хабарламалар болмағандықтан, бос тізім) және теріс жағдай (400) тірі режимде тексерілді.

Демо-чатбот және SSO