POST`/api/public/widget/message`

방문자의 채팅 메시지를 봇에 보내고 봇의 응답을 반환합니다. 이는 채팅 위젯의 핵심 엔드포인트입니다.

Auth & Absicherung

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

Idempotent: Nein

widget_code(body, string, erforderlich)

message(body, string, erforderlich)

visitor_id(body, string, erforderlich)— 클라이언트 측에서 생성된 영구 방문자 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-Header가 누락되었습니다.

401 WIDGET_TOKEN_INVALID — 토큰이 유효하지 않거나 원본이 위젯의 허용 목록에 없습니다.

400 VISITOR_ID_REQUIRED — visitor_id가 누락되었습니다.

성공(200, 실제 생성된 챗봇 응답) 및 여러 부정적 사례(누락/유효하지 않은 토큰, 누락된 visitor_id)가 실시간으로 검증되었습니다.