POST/api/public/widget/message

訪問者のチャットメッセージをチャットボットに送信し、その応答を返す — チャットウィジェットの中心的なエンドポイント。

Auth & Absicherung

Widget-Embed-Token (Header X-Widget-Token) + Origin-Freigabeliste

Idempotent: Nein

Parameter

widget_code(body, string, erforderlich)
message(body, string, erforderlich)
visitor_id(body, string, erforderlich)— クライアント側で生成された永続的な訪問者ID
session_id(body, string)— 新しい会話の最初の呼び出し時にnull

Beispiel-Request

{"widget_code":"...","message":"こんにちは,Zentor Appは何ですか?","visitor_id":"<UUIDまたはクライアント生成ID>"}

Beispiel-Response

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

Fehlercodes

401 WIDGET_TOKEN_MISSING — X-Widget-Token-Header が不足しています。
401 WIDGET_TOKEN_INVALID — トークンが無効、またはOriginがウィジェットの公開リストに含まれていません。
400 VISITOR_ID_REQUIRED — visitor_id が不足しています。

Live-Test-Nachweis

成功（200、実際に生成されたチャットボット応答）と複数のネガティブケース（トークンの欠如/無効、visitor_id の欠如）をライブで検証済み。

← チャットウィジェット