POST/api/global-chatbot/demo/poll

Huuliza ujumbe mpya uliofika bila kulandanishwa (asynchronously) katika kipindi (Session) cha chat ya demo (k.m. pale mhudumu wa binadamu amechukua mazungumzo katika Master-Admin) — huitwa mara kwa mara na wijeti.

`POST /api/global-chatbot/demo/poll` huuliza ujumbe mpya au mabadiliko ya hali kwa kipindi (Session) cha demo kilichopo. Mwili (body) una `session_id` na `visitor_id`. Thamani zote mbili lazima zitoke kwenye mazungumzo yaleyale ya demo ya umma. Ikiwa mojawapo ya vigezo haipo, seva hujibu kwa `400 PARAMS_REQUIRED`. Njia (route) hii haihitaji mtumiaji kuingia kwenye akaunti na husoma hali ya sasa ya kipindi cha demo. Hutumika pale jibu halirudi mara moja pamoja na ombi la awali, au pale kiolesura kinapaswa kuonyesha ujumbe uliofika baadaye. Polling si mbadala wa kutuma ujumbe; yenyewe haizalishi ombi jipya la mgeni. Client lazima azingatie pumziko linalofaa kati ya wito. Mzunguko mkali usio na mwisho huongeza mzigo na unaweza kuanzisha vikomo vya kasi (rate limits) bila kuzalisha jibu kwa haraka zaidi. Ikiwa kipindi kimekamilika, si halali tena au hakipatikani tena, polling inapaswa kusimama na kiolesura kitoe fursa ya kuanza upya. Kurasa zilizofungwa au vichupo vilivyofichwa havipaswi kuacha maombi ya chinichini yanayoendelea kwa kudumu. `session_id` na `visitor_id` si taarifa za jumla za ufikiaji kwa mazungumzo mengine. Hazipaswi kushirikiwa kati ya wageni wala kutumwa pamoja na ujumbe kwa zana za uchambuzi za umma. Demo hubaki imetenganishwa na mazungumzo ya wapangaji na data za kikasha za uzalishaji. Jaribio sahihi huanzisha kipindi cha demo, hutuma ujumbe kisha huita Poll kwa vitambulisho vilevile. Zaidi ya hayo, ombi lisilo na `visitor_id` hukaguliwa. Jaribio hasi lililoandikwa ni uthibitisho wa hitilafu, si ushahidi kwamba mazungumzo kamili ya uzalishaji yamekamilika kwa mafanikio.

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

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