POST/api/global-chatbot/demo

Alimenta o chatbot Demo público em zentor-app.de/demo — pode ser experimentado no browser sem registo. Utiliza o mesmo mecanismo de chatbot global dos widgets reais dos tenants.

Autenticação e segurança

Não é necessária autenticação

Controlo de acesso Block-10 (accessControlGuard, Scope "widget", ZENTOR_MAIN_TENANT_ID) -- atualmente em Dry-Run; consulte a categoria "Segurança" do Centro de ajuda.

Idempotente: Não

Parâmetros

message(body, string, obrigatório)
visitor_id(body, string, obrigatório)— Tem de ser uma UUID válida

Pedido de exemplo

{"message":"O que pode fazer a Zentor App?","visitor_id":"<UUID>"}

Resposta de exemplo

{"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}}

Códigos de erro

400 MESSAGE_REQUIRED — message em falta.
400 INVALID_VISITOR_ID — visitor_id não é uma UUID válida.

Evidência de teste live

Sucesso (200, resposta real do bot incluindo checkout_payload) e dois casos negativos verificados live.

← Chatbot Demo e SSO