POST/api/global-chatbot/demo/poll
Mengambil pesan baru yang masuk secara asinkron dari sesi demo chat (misalnya, ketika agen manusia telah diambil alih di Master-Admin) — dipanggil secara berkala oleh widget.
`POST /api/global-chatbot/demo/poll` mengambil pesan baru atau perubahan status untuk sesi demo yang sudah ada. Body berisi `session_id` dan `visitor_id`. Kedua nilai tersebut harus berasal dari percakapan demo publik yang sama. Jika salah satu parameter hilang, server akan merespons dengan `400 PARAMS_REQUIRED`. Rute ini tidak memerlukan autentikasi pengguna dan membaca status terkini dari sesi demo. Rute ini digunakan ketika jawaban tidak segera dikembalikan bersama permintaan sebelumnya, atau ketika antarmuka perlu menampilkan pesan yang masuk kemudian. Polling bukan pengganti pengiriman pesan; polling itu sendiri tidak membuat permintaan pengunjung baru. Klien harus jeda secara wajar di antara panggilan. Loop tak terbatas yang terlalu rapat dapat meningkatkan beban dan memicu batas laju (rate limits) tanpa menghasilkan jawaban lebih cepat. Jika sesi berakhir, tidak valid, atau tidak dapat ditemukan lagi, polling harus dihentikan dan antarmuka harus menawarkan opsi untuk memulai ulang. Halaman yang dibatalkan atau tab yang tersembunyi tidak boleh meninggalkan permintaan latar belakang yang berjalan terus-menerus. `session_id` dan `visitor_id` bukan kredensial akses umum untuk percakapan lain. Kredensial tersebut tidak boleh dibagikan antar pengunjung atau dikirim bersama pesan ke alat analisis publik. Demo tetap terpisah dari percakapan tenant dan data inbox produksi. Pengujian yang benar dimulai dengan memulai sesi demo, mengirim pesan, dan kemudian memanggil polling dengan identifikator yang sama. Selain itu, dilakukan pemeriksaan permintaan tanpa `visitor_id`. Pengujian negatif yang didokumentasikan adalah bukti kesalahan, bukan bukti bahwa percakapan produksi lengkap telah berhasil diselesaikan.
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 dan/atau visitor_id tidak ada.Live-Test-Nachweis
Keberhasilan (200, daftar kosong karena tidak ada pesan asinkron baru sejak demo.chat) dan kasus negatif (400) telah diverifikasi secara langsung.