POST/api/global-chatbot/demo/poll

Menghantar mesej baru yang tidak selari dari sesi sembang demo (contohnya, jika ejen manusia mengambil alih dalam pentadbir utama) dipanggil secara berkala oleh widget.

`POST /api/global-chatbot/demo/poll` meminta mesej baru atau perubahan status untuk sesi demo yang sedia ada. Badan mengandungi `session_id` dan `visitor_id`. Kedua-dua nilai mesti berasal dari perbualan demo awam yang sama. Jika salah satu parameter tidak lengkap, pelayan menjawab dengan `400 PARAMS_REQUIRED`. Laluan ini tidak memerlukan pendaftaran pengguna dan membaca status sesi demo yang terkini. Ia digunakan apabila jawapan tidak kembali dengan segera dengan permintaan demo sebelumnya atau apabila peranti yang bersangkutan menunjukkan mesej yang datang kemudian. Polling tidak boleh menggantikan hasil panggilan yang datang selepas itu; ia tidak menghasilkan panggilan pengunjung baru. Pelanggan mesti memeriksa kotak mesej yang kekal antara pengunjung yang sedang bermain.

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 dan/atau visitor_id tidak ada.

Live-Test-Nachweis

Kejayaan (200, senarai kosong kerana tiada mesej asynchronous baru sejak demo.chat) dan kes negatif (400) disahkan secara langsung.

Demo Chatbot dan SSO