POST/api/public/widget/message

Отправляет сообщение посетителя чат-боту и возвращает его ответ — центральный эндпоинт чат-виджета.

Аутентификация и защита

Токен встраивания виджета (заголовок 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) проверены вживую.

← Виджет чата