POST/api/global-chatbot/demo/poll

Kunin ang mga bagong mensahe na natanggap nang asynchronous mula sa isang demo na session ng chat (halimbawa, kung ang isang human agent ay pinalitan ang master administrator) — ang widget ay regular na tinatawag para dito.

`POST /api/global-chatbot/demo/poll` ay nagtatanong ng mga bagong mensahe o pagbabago ng estado para sa isang umiiral na demo session. Ang body ay naglalaman ng `session_id` at `visitor_id`. Parehong mga halaga ay dapat na mula sa parehong pampublikong demo na pag-uusap. Kung nawawala ang isa sa mga parameter, ang server ay tutugon gamit ang `400 PARAMS_REQUIRED`. Ang ruta ay hindi nangangailangan ng pag-login ng gumagamit at binabasa ang kasalukuyang estado ng demo session. Ito ay ginagamit kapag ang isang tugon ay hindi agad na ibinalik sa nakaraang kahilingan, o kapag ang interface ay dapat ipakita ang mga mensaheng dumating sa ibang pagkakataon. Ang pag-poll ay hindi kapalit ng pagpapadala ng mensahe; hindi ito lumilikha ng bagong kahilingan mula sa bisita. Ang kliyente ay dapat magkaroon ng isang angkop na pagitan sa pagitan ng mga tawag. Ang isang masikip na walang-katapusang loop ay nagdaragdag ng load at maaaring mag-trigger ng mga limitasyon sa rate, nang hindi nagbubunga ng mas mabilis na tugon. Kapag ang session ay natapos, naging hindi wasto, o hindi na mahahanap, dapat itigil ang pag-poll, at ang interface ay dapat mag-alok ng isang bagong pagsisimula. Ang mga pahinang na-abrupto o mga tab na nakatago ay hindi dapat mag-iwan ng anumang patuloy na tumatakbong background na mga kahilingan. Ang `session_id` at `visitor_id` ay hindi pangkalahatang mga kredensyal para sa iba pang mga pag-uusap. Hindi ito dapat ibahagi sa pagitan ng mga bisita o ipadala kasama ng mga mensahe sa mga pampublikong tool sa pagsusuri. Ang demo ay nananatiling hiwalay mula sa mga pag-uusap ng tenant at produktibong data ng inbox. Ang isang wastong pagsubok ay nagsisimula ng isang demo session, nagpapadala ng isang mensahe, at pagkatapos ay tinatawag ang pag-poll gamit ang parehong mga identifier. Bukod pa rito, sinusuri ang isang kahilingan nang walang `visitor_id`. Ang dokumentadong negatibong pagsubok ay isang patunay ng error, hindi isang patunay na ang isang kumpletong produktibong pag-uusap ay matagumpay na nakumpleto.

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

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