POST/api/public/widget/rating
Records a simple thumbs up/down rating from the visitor for a conversation.
Auth & Security
Widget embed token (X-Widget-Token header) + origin allowlist
Idempotent: Yes
Parameters
widget_code(body, string, required)session_id(body, string, required)visitor_id(body, string, required)helpful(body, boolean, required)Example Request
{"widget_code":"...","session_id":"...","visitor_id":"...","helpful":true}Example Response
{"ok":true}Error Codes
400 VISITOR_REQUIRED — visitor_id is missing.400 HELPFUL_REQUIRED — helpful is missing.Live Test Proof
Success (200) and negative cases (400, each with a missing required field) verified live.