POST/api/global-chatbot/demo/poll

Faigh na sonraí de na teachtanna sonraí nua, asincronacha de seisiún chat taispeána (e.g., nuair a ghlac agént daonna an rialú ó mháistir-rialtóir) – déantar an widget a ghairm go periodacha.

`POST /api/global-chatbot/demo/poll` faigheann teachtaireachtaí nua nó athruithe stáit le haghaidh seisiún taispeána atá ann cheana. Tá an corp le linn na n-eintí `session_id` agus `visitor_id`. Caithfear go dtiocfaidh an dá luach ón gcomhrá faispeóis phoiblí céanna. Má tá aon cheann de na paraiméadair ar iarraidh, freaglaíonn an freastaraí le `400 PARAMS_REQUIRED`. Ní gá do úinéir an t-úsáideoir chun logáil isteach don bhfíora, agus léann sé an staid reatha an tseisiúin taispeána. Úsáidtear é nuair nach dtéann freagra ar ais láithis leis an gcéimhníriú roimhe seo, nó nuair gur gá don ghrinnspéiceáil a chinntí go léiríonn sé teachtaireachtaí nua níos déanaí. Ní hionstáid é an pollchláir in ionad seoladh teachtaireachta; ní chruthíonn sé féin iarrataí nua ó úinéir. Caithfear go gcoinneoidh an cliant stad réasúnta idir na glaonna. Méadódh caisleán fadtéireach ar bith an t-ualach agus féadfaidh sé teorainneacha ráta a spreagadh, gan freagra a tháirgeadh níos tapa. Má críochnaíonn an seisiún, go bréagach, nó nach féidir é a aimsiú a thuilleadh, ba cheart go ndéanfaí stad ar an bpóllchláir agus gur thairgteann an grinnspéiceáil tosú nua. Ní féidir le leathanaigh a scartha nó tapaí cláir a bhunaithe ar fhadhnaíocht ar bith iarrataí cúlra a fheidhmeáil go leanúnach. Ní hionann `session_id` agus `visitor_id` le sonraí isteach ginearálta le haghaidh comhrá eile. Ní féidir iad a roinnt idir úinéirí ná a sheoladh le haghaidh uirlisí anailís phoiblí in éineacht le teachtaireachtaí. Tá an taispeáint scartha ó chomhráí faoin gcomhúsáideoir agus ó sonraí bosca isteach atá i dtáirge. Toscaíonn tástáil ceart seisiún taispeána, seolann teachtaireacht, agus ansin glaoitear ar an bpóllchláir ag úsáid na heintí céanna. Chomh maith leis sin, déantar seiceáil ar iarratas gan `visitor_id`. Is cruthúnas ar locht an tástáil diúltach a luaite, ní tá sé mar fhíorú go ndearnadh comhrá atá i dtáirge go dtí deireadh.

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_REQUIREDTá an session_id agus/nó an visitor_id caillte.

Live-Test-Nachweis

Cruthaíodh an t-am atá le teacht (200, liosta folaithe mar níl aon teachtaireachtaí nua asíncrónacha ón demo.chat) agus deimhníodh an t-am neamhfhiuchta (400) go díreach.

Breatnach-chatbot agus SSO.