Análises
Perceba o que os seus visitantes perguntam e melhore os seus conteúdos com base em dados reais.
:::info Acesso aos planos
Abra um chatbot em /dashboard e escolha Conversas. As vistas Análises e Perguntas sem resposta estão incluídas nos planos Pro e Business; as vistas indisponíveis apresentam uma opção de atualização do plano. Histórico e Testar chatbot estão disponíveis em todos os planos. Estas são vistas do projeto, não métricas da Visão geral do espaço de trabalho.
:::
Use a checklist de lançamento para validar a implementação e compare os planos e limites antes de escolher como avaliar os resultados.
Visão geral do painel
Abra Conversas → Análises (/chatbot/<projectId>?tab=analytics). O painel usa os últimos 30 dias e inclui, no máximo, as 5.000 interações registadas mais recentes nesse período. Não existe seletor de intervalo de datas nem exportação de todo o histórico. Este intervalo é um filtro do relatório, não uma garantia de retenção. Em situações de elevado volume, os resultados podem estar limitados e não representar todo o tráfego do período.
- Total de perguntas - Interações registadas no período, sujeitas ao limite
- Respondidas - Interações cuja geração foi concluída com sucesso e que não foram sinalizadas pelo detetor automático de lacunas
- Sem resposta - Outras interações registadas, incluindo respostas de fallback por falta de contexto e falhas de geração
- Taxa de resposta - Interações respondidas divididas pelo total de interações registadas
Estas são métricas de classificação automática, não medidas da exatidão verificada das respostas, da satisfação dos clientes, de visitantes únicos ou de pedidos de suporte evitados. As lacunas de conteúdo são um subconjunto das interações sem resposta: as falhas de geração podem ser contabilizadas como sem resposta sem criarem uma lacuna. O detetor analisa o contexto das fontes, formulações semelhantes a respostas de fallback e alguns termos específicos das perguntas; pode classificar respostas incorretamente. Testar chatbot contribui para estas métricas e consome a quota de mensagens do proprietário. Este não é um relatório exclusivo dos visitantes nem o registo de utilização para faturação; os pedidos falhados não têm necessariamente um registo nas análises.
Conversas e histórico
Abra Conversas → Histórico (?tab=logs) para percorrer as conversas guardadas do projeto. Selecione uma linha para ler as mensagens e os respetivos horários numa vista separada apenas de leitura; selecione-a novamente ou utilize Histórico nessa vista para regressar à lista. Pode eliminar uma conversa ou todas após confirmação. O histórico reúne os testes feitos no painel e as conversas públicas; não é um registo interno dos pedidos/erros da API. A vista carrega as primeiras 100 mensagens guardadas, pelo que o total pode ser superior ao número apresentado.
Testar chatbot (?tab=test) também permite selecionar conversas guardadas, iniciar um novo chat, copiar respostas e eliminar o histórico. Abra Conversas na interface de teste para selecionar uma conversa guardada ou pesquisar as pré-visualizações. A pesquisa filtra a página atualmente carregada, não todas as mensagens do projeto. Novo chat inicia uma conversa nova sem eliminar o histórico guardado; Limpar é uma ação destrutiva separada. Quando um pedido reutiliza o mesmo conversationId, o gerador de respostas recebe até 12 mensagens guardadas recentes, cada uma limitada a 2.000 caracteres. Trata-se de contexto limitado, não da transcrição completa; inclua detalhes anteriores quando forem necessários e mantenha os IDs de conversa separados entre visitantes sem relação entre si.
Eliminar uma conversa em Histórico ou Testar chatbot remove as mensagens guardadas, mas não os registos de análises, os registos de lacunas de conteúdo, a utilização de mensagens já consumida ou os registos de repetição idempotente. Nos pedidos HTTP do widget com uma chave de idempotência, um registo de repetição separado guarda o fingerprint do pedido (que inclui a mensagem) e, se o pedido for concluído, também a resposta. O registo tem um prazo de expiração de 24 horas, mas é eliminado por um processo de limpeza separado, pelo que a eliminação pode ocorrer mais tarde.
Perguntas mais frequentes
Consulte os 10 textos de perguntas mais frequentes dentro do intervalo e do limite das análises. Antes do agrupamento, o texto é limpo de espaços nas extremidades, convertido em minúsculas e truncado a 500 caracteres; não há agrupamento semântico de perguntas formuladas de forma diferente. Utilize esta lista para:
- Compreender o que mais importa aos visitantes
- Dar prioridade às melhorias de conteúdo
- Identificar oportunidades para perguntas frequentes
Deteção de lacunas de conteúdo
Abra Conversas → Perguntas sem resposta (?tab=gaps) para rever as perguntas sinalizadas pelo detetor de lacunas de conteúdo. O detetor não depende de uma frase exata: pode sinalizar falta de contexto da fonte, formulações de recusa reconhecidas e algumas respostas demasiado genéricas face a termos específicos da pergunta. Uma lacuna é um indício para analisar, não uma prova de que falta uma página. A vista apresenta:
- Pergunta - O que o visitante perguntou
- Contagem - Número de vezes que foi perguntado
- Última vez perguntada - Data em que foi perguntada mais recentemente
Use estes dados como candidatos a revisão. Verifique primeiro a seleção de fontes, a recuperação de informação, a formulação e a resposta efetiva. Depois de acrescentar conteúdo, recolha-o novamente dentro da quota de atualização e teste a resposta; em seguida, selecione Resolver. Esta é uma marcação manual: não treina o chatbot nem confirma a qualidade da nova resposta. Eliminar remove o registo da lacuna.
Por predefinição, Perguntas sem resposta apresenta apenas as lacunas por resolver. A opção Incluir lacunas resolvidas. inclui também as resolvidas; numa lacuna resolvida, pode selecionar Desfazer para voltar a marcá-la como por resolver. Em ambos os casos, são apresentados os 100 registos correspondentes mais recentes, ordenados depois por contagem. O contador de lacunas por resolver está limitado a 500, um limite distinto do máximo de 100 registos apresentados na lista. Se a mesma pergunta normalizada voltar a ocorrer, a contagem aumenta, mas o registo não é reaberto automaticamente. Estes registos são independentes do intervalo de 30 dias de Análises.
Use estas lacunas com o guia para medir a redução dos pedidos de suporte para testar a cobertura de perguntas repetidas e comparar qualquer impacto no suporte com a sua própria referência, em vez de presumir um resultado.
Horas de maior tráfego
Consulte as cinco faixas horárias com mais interações no mesmo período de análise. As horas são registadas no backend e apresentadas sem conversão para o fuso horário dos visitantes; não permitem identificar o fuso horário do público. Utilize-as para:
- Agendar atualizações de conteúdo em períodos de menor tráfego
- Comparar períodos de maior e menor tráfego com uma base de análise consistente
- Planear a capacidade se estiver perto dos limites
Gatilhos populares
O painel Gatilhos populares mostra as 10 URLs das páginas de onde vieram as perguntas registadas, não as páginas mais citadas nem as visualizações de página. O widget.js alojado, incluindo o widget montado com Chattybox.mountWidget(), envia automaticamente o contexto da página sem cadeias de consulta nem fragmentos.
Privacidade: em páginas HTTP(S), o widget alojado inclui o caminho da página atual em cada pedido de chat; remove cadeias de consulta, fragmentos e credenciais, mas não o caminho. Não carregue nem mantenha o widget ativo em páginas sensíveis ou privadas. Numa SPA, excluir o loader numa rota posterior não remove um widget já inicializado. Quando for apropriado removê-lo, faça explicitamente o teardown com window.ChattyBox.destroy() após a inicialização ou remova todos os handles do SDK com remove().
O SDK headless publicado 0.1.4 aceita message, conversationId e idempotencyKey em sendMessage(). O código-fonte atual também suporta uiLocale. Nem a versão publicada nem o código-fonte atual suportam sourceUrl ou sourcePath; não acrescente uma opção não suportada ao SDK para obter atribuição da página. Testar chatbot também não tem um URL da página de origem, pelo que as perguntas podem ser contabilizadas mesmo quando o painel Gatilhos populares está vazio.
Uma integração HTTP direta pode enviar opcionalmente sourceUrl e/ou sourcePath para POST /chat. É necessária uma origem HTTP(S) do pedido, obtida do cabeçalho Origin quando presente ou da origem do Referer apenas quando Origin está ausente; sourceUrl tem de corresponder a essa origem e não pode conter credenciais. O caminho fornecido tem de começar por / (não //), não pode conter uma cadeia de consulta nem um fragmento e, se ambos forem enviados, tem de corresponder ao pathname do URL. O servidor remove cadeias de consulta e fragmentos e normaliza o URL antes de o registar. Nunca envie caminhos privados ou dados sensíveis dos visitantes como contexto da página.
O contexto da página é utilizado para análises, incluindo telemetria de interações; não altera as fontes indexadas que o assistente procura.
Citações de origem
As respostas podem incluir ligações clicáveis para páginas utilizadas como contexto recuperado. Estas ligações podem ajudar os visitantes a consultar conteúdo relevante, mas não verificam se todas as afirmações são fundamentadas ou exatas. Compare as afirmações importantes com as páginas de origem. As ligações de origem podem:
- Ajudar os visitantes a avaliar a resposta
- Permitir que os utilizadores comparem as informações com as páginas relevantes
- Encaminhar os visitantes para essas páginas
O widget apresenta as citações numa secção expansível nativa. Os visitantes podem abrir Fontes para consultar as ligações citadas sem interromper a resposta.
Como melhorar a taxa de resposta
Sugestões para responder a mais perguntas:
- Reveja regularmente as lacunas de conteúdo - Acrescente ao seu site as informações em falta
- Recolha conteúdo de mais páginas - Inclua páginas de perguntas frequentes, documentação de ajuda e artigos do blogue
- Utilize títulos claros - O conteúdo bem estruturado é mais fácil de pesquisar
- Mantenha o conteúdo atualizado - Ative a recolha automática de conteúdo e respeite a periodicidade do seu plano e o orçamento mensal de atualizações
- Volte a testar antes de resolver - Confirme a resposta e as citações, em vez de considerar que uma taxa de resposta mais elevada prova a exatidão