POST/api/public/widget/message

Надсилає повідомлення відвідувача в чаті чат-боту та повертає його відповідь — центральний ендпоінт віджета чату.

Автентифікація та захист

Widget-Embed-Token (заголовок X-Widget-Token) + список дозволених Origin

Ідемпотентний: Ні

Параметри

widget_code(body, string, обов'язково)
message(body, string, обов'язково)
visitor_id(body, string, обов'язково)— Створений на стороні клієнта постійний ID відвідувача
session_id(body, string)— null при першому виклику нової розмови

Приклад запиту

{"widget_code":"...","message":"Вітаємо, що вміє Zentor App?","visitor_id":"<UUID або ID, згенерований клієнтом>"}

Приклад відповіді

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

Коди помилок

401 WIDGET_TOKEN_MISSING — Відсутній заголовок X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Токен недійсний або Origin не входить до списку дозволених для віджета.
400 VISITOR_ID_REQUIRED — відсутній visitor_id.

Доказ живого тесту

Успіх (200, справжня згенерована відповідь чат-бота) та кілька негативних випадків (відсутній/недійсний токен, відсутня visitor_id) перевірено в режимі реального часу.

← Чат-віджет