POST/api/public/widget/message

Wysyła wiadomość czatu odwiedzającego do chatbota i zwraca jego odpowiedź — główny punkt końcowy widżetu czatu.

Uwierzytelnianie i zabezpieczenia

Token osadzenia widżetu (nagłówek X-Widget-Token) + lista dozwolonych originów

Idempotentny: Nie

Parametry

widget_code(body, string, wymagane)
message(body, string, wymagane)
visitor_id(body, string, wymagane)— Generowany po stronie klienta, trwały identyfikator odwiedzającego
session_id(body, string)— null przy pierwszym wywołaniu nowej rozmowy

Przykładowe żądanie

{"widget_code":"...","message":"Cześć, co potrafi Zentor App?","visitor_id":"<UUID lub ID wygenerowany przez klienta>"}

Przykładowa odpowiedź

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

Kody błędów

401 WIDGET_TOKEN_MISSING — Brakuje nagłówka X-Widget-Token.
401 WIDGET_TOKEN_INVALID — Token nieprawidłowy lub Origin nie znajduje się na liście zatwierdzonych dla widżetu.
400 VISITOR_ID_REQUIRED — Brakuje visitor_id.

Dowód z testu na żywo

Pomyślnie (200, rzeczywista generowana odpowiedź chatbota) oraz wiele przypadków negatywnych (brakujący/nieważny token, brak visitor_id) zweryfikowano na żywo.

← Widget czatu