GET/api/global-chatbot/demo/history
Carrega o histórico de mensagens de uma conversa de demonstração para que seja preservado ao reabrir a demonstração.
Transmita `session_id` e `visitor_id` como parâmetros de consulta; ambos devem provir da mesma conversa de demonstração. No objeto `data`, a resposta contém a lista `messages` com `id`, `role`, `text` e `created_at`. A chamada é apenas de leitura e idempotente. Se faltar um dos parâmetros, o servidor responde com 400 `PARAMS_REQUIRED`. Se a sessão já não for conhecida, inicie uma nova conversa de demonstração.
Visão geral
Chamada: GET /api/global-chatbot/demo/history. Este endpoint pertence ao grupo «Chatbot de demonstração e SSO» da API da Zentor App. É de acesso público e não requer autenticação. A chamada é idempotente: chamadas repetidas com os mesmos dados devolvem o mesmo resultado. Parâmetros obrigatórios: session_id (query), visitor_id (query). Casos de erro documentados: 400 PARAMS_REQUIRED. A resposta de exemplo abaixo mostra a estrutura de uma resposta bem-sucedida em formato JSON.
Autenticação e segurança
Não é necessária autenticação
Idempotente: Sim
Parâmetros
session_id(query, string, obrigatório)— ID de sessão da conversa de demonstraçãovisitor_id(query, string, obrigatório)— ID do visitante (UUID) gerado pela página de demonstraçãoResposta de exemplo
{"ok":true,"data":{"messages":[{"id":"f248d929-c9ce-412d-aba8-43808ca1c9f7","role":"user","text":"Olá, quanto custa a Zentor?","created_at":"2026-07-20T17:07:02.240Z"},{"id":"3c26b6a6-4ca6-47a9-9669-a052082007ac","role":"assistant","text":"Posso mostrar-lhe como isso ficaria para o seu caso de utilização — sem compromisso.","created_at":"2026-07-20T17:07:02.329Z"}]}}Códigos de erro
400 PARAMS_REQUIRED — `session_id` ou `visitor_id` está em falta.Comportamento verificado
Uma sessão de demonstração existente devolve 200 com o histórico; parâmetros em falta devolvem 400 `PARAMS_REQUIRED`.
Chatbot de demonstração e SSO
POST /api/global-chatbot/demoEnvia uma mensagem para o chatbot de demonstração público em zentor-app.de/demo e devolve a sua resposta. A demonstração pode ser testada no navegador sem registo.POST /api/global-chatbot/demo/pollObtém novas mensagens de uma conversa de demonstração, por exemplo quando um colaborador da Zentor assumiu a conversa. A página de demonstração chama o endpoint em intervalos.POST /api/global-chatbot/demo/ratingGuarda a avaliação de uma conversa de demonstração (útil ou não útil) com um comentário opcional.POST /api/global-chatbot/demo/trackRegista eventos de utilização anónimos da página de demonstração para as estatísticas de visitantes da Zentor.POST /api/global-chatbot/demo/voice-transcribeConverte uma gravação de voz na página de demonstração em texto (entrada de voz), se a funcionalidade de voz da demonstração estiver ativada.POST /api/global-chatbot/demo/voice-speakConverte texto em voz (saída de voz na página de demonstração), se a funcionalidade de voz da demonstração estiver ativada.GET /api/sso/:tenantSlug/statusVerifica se o início de sessão único (SAML ou OIDC) está configurado para uma conta. A página de autenticação utiliza o resultado para oferecer o início de sessão SSO.GET /api/sso/:tenantSlug/oidc/startInicia o início de sessão via OpenID Connect e redireciona o navegador para o fornecedor de identidade configurado.GET /api/sso/:tenantSlug/oidc/callbackRecebe o redirecionamento do fornecedor de identidade após o início de sessão OIDC e redireciona o navegador de volta para a Zentor App.GET /api/sso/:tenantSlug/saml/startInicia o início de sessão via SAML e redireciona o navegador para o fornecedor de identidade configurado.POST /api/sso/:tenantSlug/saml/acsAssertion Consumer Service (ACS): recebe a resposta SAML assinada do fornecedor de identidade através de um POST de formulário.GET /api/sso/:tenantSlug/saml/metadataDevolve os metadados SAML da Zentor App (XML) para importação no seu fornecedor de identidade.