Checklist de lançamento

Antes do lançamento, confirme que as páginas privadas são excluídas através da seleção explícita das fontes, e não por robots.txt. Compare as contagens reais, reveja as páginas com Indexação parcial (512 KiB) e confirme a conclusão dos embeddings. Verifique os limites de mensagens e o orçamento mensal de atualização. Análises e Perguntas sem resposta requerem Pro/Business. Análises apresenta até 5.000 interações registadas nos últimos 30 dias, incluindo testes, e não comprova a precisão das respostas.

Use esta checklist antes de apresentar o ChattyBox aos clientes. Identifica as falhas comuns de configuração que fazem um chatbot parecer instalado, mas ainda não estar pronto.

Para uma implementação de suporte, combine esta checklist com o guia de chatbot de IA para suporte ao cliente para que as respostas baseadas em conteúdo público tenham um encaminhamento claro para perguntas específicas da conta, questões sensíveis ou por resolver.

Prontidão do conteúdo

• Foram selecionados conteúdos públicos e acessíveis ao crawler para servirem de base às respostas do chatbot.
• Páginas privadas, páginas de administração, processos de finalização de compra, páginas de conta, rascunhos e conteúdo de pré-produção estão excluídos através da seleção explícita das fontes; não confie apenas em robots.txt, que o crawler não respeita.
• Escolheu a entrada adequada: sitemap, URLs manuais, apenas a página inicial ou crawl. O modo crawl usa sitemaps convencionais detetados antes de recorrer a ligações; não completa um sitemap incompleto seguindo ligações.
• Estão incluídas páginas importantes sobre produtos, preços, políticas, suporte, FAQ, primeiros passos e resolução de problemas.
• Os sites multilingues incluem as versões linguísticas de que espera que o widget responda.

Validação da recolha

• A tarefa terminou, as contagens de páginas guardadas/selecionadas foram comparadas e as páginas esperadas estão presentes. O estado Concluído não garante, por si só, uma cobertura completa.
• A quantidade de páginas indexadas corresponde ao esperado para o seu plano e para o âmbito do lançamento.
• As páginas com Indexação parcial foram verificadas quanto a texto em falta devido ao limite de 512 KiB; divida as páginas longas quando necessário.
• As tarefas de criação de embeddings, que são independentes, foram concluídas e a recuperação de informação foi testada com perguntas representativas.
• As páginas editadas ou migradas recentemente foram recolhidas novamente.
• Nas páginas em falta, foram verificados a autenticação, os desafios anti-bot, os redirecionamentos falhados ou não seguros, os filtros das fontes e o conteúdo disponível apenas por JavaScript. O texto importante está presente no HTML obtido, sem renderização de JavaScript.
• As páginas obsoletas já guardadas foram eliminadas em Conhecimento → Páginas, não apenas removidas do sitemap; ajuste também a fonte para evitar que sejam detetadas novamente.

Utilização e titularidade

• O titular do projeto consegue aceder ao painel e gerir o chatbot; as chaves públicas e a pertença a uma organização não dão acesso ao painel.
• A secção Conta e faturação, em /settings/account, tem mensagens suficientes para os testes e o tráfego de lançamento de todos os chatbots do titular; os testes, incluindo Testar chatbot, consomem esta quota partilhada.
• Foram verificados tanto os limites de páginas guardadas como o orçamento mensal separado de atualização de páginas, partilhado entre os projetos do titular. As reconstruções manuais do índice também consomem trabalho de atualização.
• A frequência de atualização é compatível com o plano: Free permite atualizações no máximo semanais e os planos pagos, no máximo diárias. As novas tentativas manuais de recolha seguem o mesmo período de espera, mesmo após falhas.
• Nos planos Pro/Business, o PAYG está desativado, tem limites definidos por funcionalidade ou foi intencionalmente configurado com Sem limite de despesa (o que pode gerar custos de utilização sem limite); não elimina o período de espera do crawler nem o orçamento mensal de atualização.
• Se utilizar o bloqueio da configuração, compreenda as restrições irreversíveis e o fluxo separado de tokens secretos de implementação.

Qualidade das respostas

• Foram feitas perguntas de teste realistas sobre vendas, suporte, primeiros passos e documentação.
• As respostas representativas baseiam-se no conteúdo indexado e as perguntas não suportadas recebem a resposta de fallback prevista. Reveja as respostas; um teste bem-sucedido não garante todas as respostas futuras.
• Respostas úteis exibem citações de fontes.
• Os links das citações abrem as páginas públicas de origem esperadas.
• As respostas fracas foram corrigidas através da melhoria do conteúdo de origem ou da adição de páginas em falta, seguindo-se uma nova recolha.
• Se a Persona foi alterada, o estado de gravação confirma que foi guardada; os erros de validação foram corrigidos ou as gravações falhadas foram novamente tentadas antes dos testes. A resposta de fallback aplicada foi testada separadamente; o texto da Persona não substitui a resposta configurada para contexto em falta.
• As perguntas de teste incluem o contexto necessário: o gerador recebe, no máximo, as 12 mensagens guardadas mais recentes, cada uma limitada a 2.000 caracteres, e não a conversa completa.

Instalação do widget

• O widget está instalado nas páginas públicas pretendidas.
• O script é carregado apenas uma vez por página.
• O script inclui data-api-key.
• O script inclui data-api-url.
• Detetar automaticamente/Fixo e Permitir substituição através de script estão configurados deliberadamente. data-locale só prevalece quando as substituições são permitidas, mesmo no modo Fixo.
• Foram testados separadamente o idioma da interface do widget, o idioma das perguntas/respostas e as versões linguísticas indexadas.
• O widget abre e envia uma pergunta de teste numa janela anónima.
• Os testes em ecrãs móveis confirmam que o botão de abertura e o painel de chat são utilizáveis.

Verificações da chave de API e das restrições de origem opcionais

• A chave pública pretendida está selecionada em Instalar → Instalação no site; faça a gestão de chaves e origens em Instalar → Chaves e domínios.
• Para concluir a rotação, instale e teste a nova chave antes de eliminar a antiga. Os nomes das chaves, por si só, não separam ambientes.
• Teste a chave nos sites de produção, pré-visualização/staging e localhost previstos. Uma chave preparada para um site pode já estar limitada à respetiva origem; as chaves criadas sem restrições funcionam em todas as origens do navegador.
• Se as restrições opcionais estiverem ativadas, Chaves e domínios → Editar origens inclui as origens exatas pretendidas (esquema, anfitrião e porta). Estas restrições aplicam-se à origem; não autenticam visitantes nem protegem rotas individuais. As chaves públicas do navegador não são segredos.
• O código do frontend, o GTM, o HTML personalizado do CMS e o código-fonte da página não contêm chaves de API privadas do servidor, tokens de administrador ou outros segredos.

Verificações no navegador e em produção

• A consola do navegador não apresenta erros do ChattyBox.
• A Content Security Policy permite o script do widget e o URL da API, caso o site use CSP.
• Bloqueadores de anúncios ou ferramentas de consentimento não bloqueiam o widget nas páginas em que deve aparecer.
• O site final em produção, e não apenas o desenvolvimento local, foi testado.

Após o lançamento

• Consulte Conversas → Histórico em qualquer plano e Análises / Perguntas sem resposta no Pro ou Business.
• Interprete as Análises como até 5.000 interações registadas nos últimos 30 dias, incluindo Testar chatbot; não comprovam a precisão das respostas nem representam apenas o tráfego de visitantes.
• Reveja as lacunas detetadas, volte a testar o conteúdo melhorado e resolva-as manualmente. A lista oculta por predefinição as lacunas resolvidas; Incluir lacunas resolvidas e Desfazer permitem apresentá-las e reabri-las. Uma ocorrência posterior não reabre automaticamente uma lacuna resolvida.
• Se a atribuição à página for importante, verifique Gatilhos populares. O widget envia o contexto da página sem parâmetros de consulta nem fragmento, mas mantém o caminho (pathname). Não carregue nem mantenha o widget em rotas sensíveis ou privadas. Numa SPA, uma regra de carregamento não remove um widget já inicializado: remova explicitamente a instância, por exemplo com window.ChattyBox.destroy() quando a API estiver disponível. O SDK headless sendMessage() não envia contexto da página.
• Adicione documentação, FAQ ou exemplos em falta com base nas perguntas reais dos visitantes.
• Recolha novamente as páginas atualizadas após alterações ao conteúdo.
• Rode as chaves públicas do widget se necessário; atualize as restrições de origem apenas se a restrição opcional estiver ativa e os domínios permitidos mudarem.
• A eliminação de conversas não repõe a utilização nem as Análises; estes registos são independentes.

Se algum item falhar, consulte a resolução de problemas antes do lançamento.