POST/api/global-chatbot/demo

Powers the public demo chatbot at zentor-app.de/demo — usable in the browser without registration. Uses the same underlying global chatbot mechanism as real tenant widgets.

Auth & Security

No authentication required

Block-10 access control (accessControlGuard, Scope "widget", ZENTOR_MAIN_TENANT_ID) -- currently in Dry-Run; see the Help Center category "Security".

Idempotent: No

Parameters

message(body, string, required)
visitor_id(body, string, required)— Must be a valid UUID

Example Request

{"message":"What can the Zentor app do?","visitor_id":"<UUID>"}

Example Response

{"ok":true,"data":{"response":"Zentor Plattform Übersicht\nWas Zentor ist und wofür es verwendet wird.","buttons":[],"state_after":"idle","checkout_payload":{"plan_code":"zentor_demo_start","display_name":"Zentor Demo Start","checkout_url":"https://zentor.app/onboarding/demo","ready":false,"missing_slots":["name","email","phone"]},"session_id":"c8e9762b-d4e2-437b-8331-48a82fd6eb0e","blocked_by_agent":false}}

Error Codes

400 MESSAGE_REQUIRED — message is missing.
400 INVALID_VISITOR_ID — visitor_id is not a valid UUID.

Live Test Proof

Success (200, real bot response incl. checkout_payload) and two negative cases live-verified.

← Demo Chatbot and SSO