POST/api/public/widget/message

Dërgon një mesazh chati të vizitorit te chatboti dhe furnizon përgjigjen e tij — pika kryesore përfundimtare e widget-it të chatit.

Autentifikimi dhe siguria

Widget-Embed-Token (header X-Widget-Token) + lista e lejimeve të Origin

Idempotent: Jo

Parametrat

widget_code(body, string, i detyrueshëm)
message(body, string, i detyrueshëm)
visitor_id(body, string, i detyrueshëm)— ID e vizitorit të gjeneruar në klient dhe e qëndrueshme
session_id(body, string)— null në thirrjen e parë të një bisedeje të re

Shembull request-i

{"widget_code":"...","message":"Përshëndetje, çfarë mund të bëjë Zentor App?","visitor_id":"<UUID ose ID e gjeneruar nga klienti>"}

Shembull response-i

{"ok":true,"data":{"session_id":"31b1096c-a366-4418-b4be-bd999ff98134","response":"...","buttons":[],"state":"idle","products":[]}}

Kodet e gabimeve

401 WIDGET_TOKEN_MISSING — Mungon header-i X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Tokeni është i pavlefshëm ose Origin-i nuk është në listën e lejuar të widget-it.
400 VISITOR_ID_REQUIRED — mungon visitor_id.

Prova e testit live

Sukses (200, përgjigje reale e gjeneruar e chatbot-it) dhe disa raste negative (token që mungon/i pavlefshëm, visitor_id që mungon) të verifikuara live.

← Widgeti i chat-it