Primeiros passos
Crie um chatbot útil antes de colocá-lo no seu site. A sequência principal é criar → adicionar conteúdo → revisar → testar → personalizar → integrar.
1. Crie uma conta e um projeto
Entre no dashboard do ChattyBox, selecione New Chatbot e dê um nome ao projeto. O projeto será aberto em Content, onde aparecerão as páginas indexadas e os trabalhos de crawling.
Consulte os preços para ver os limites atuais de projetos, páginas e uso.
2. Configure a fonte de conteúdo
Abra Settings e adicione o site que deve fundamentar as respostas do chatbot. Escolha o modo de descoberta, os limites de páginas, as regras de inclusão ou exclusão e o cronograma de atualização adequados; depois, salve a configuração da fonte.
Execute Scrape now. O ChattyBox descobre as páginas selecionadas, extrai o conteúdo legível e o prepara para recuperação. Isso pode levar alguns minutos, dependendo do site e da quantidade de páginas.
Use Adicionar e atualizar conteúdo quando precisar de orientações sobre sitemap, URL manual, crawling, conteúdo multilíngue ou novo crawling.
3. Revise o conteúdo indexado
Volte para Content e confirme se as páginas esperadas foram indexadas com sucesso. Resolva trabalhos que falharam, páginas irrelevantes ou seções ausentes antes de avaliar as respostas. Um chatbot não consegue responder com confiabilidade a informações que não foram indexadas.
4. Teste a qualidade das respostas
Abra o Test Chat e faça perguntas representativas que visitantes reais farão. Verifique se as respostas:
- usam a documentação indexada em vez de suposições sem suporte;
- levam a páginas de origem úteis;
- tratam informações ausentes com o fallback previsto;
- funcionam para idiomas e terminologias importantes.
Melhore o conteúdo de origem ou as regras de indexação e faça o crawling novamente quando uma resposta estiver fraca. Não instale o chatbot apenas porque o primeiro crawling terminou.
5. Ajuste a experiência
Use Persona para ajustar o comportamento do assistente e o texto do fallback. Se você pretende usar o widget hospedado, use Embed para visualizar seu título, mensagem de boas-vindas, cores, ícone, posição e comportamento de idioma.
Essas escolhas vêm depois do teste de conteúdo, para que a configuração visual não esconda problemas de recuperação ou documentação.
6. Escolha uma integração
| Objetivo | Próximo passo |
|---|---|
| Montar a interface gerenciada do ChattyBox a partir do código da aplicação | SDK JavaScript |
| Criar e manter sua própria interface | SDK JavaScript headless |
| Permitir que um assistente de programação com IA integre o pacote npm | Integração assistida por IA |
| Gerenciar a configuração do projeto pelo Git e CI | CLI e implantação da configuração |
| Usar a interface gerenciada sem npm nem uma etapa de build | Script do widget hospedado |
As integrações de navegador precisam de uma chave pública da API do widget. Crie uma em Public Keys, restrinja as origens permitidas aos domínios que devem poder chamar o chatbot e volte ao Embed para selecioná-la e copiar o snippet gerado e a URL da API.
As chaves públicas do widget foram feitas para aparecer no código do navegador. Tokens de implantação da configuração e outras credenciais de gerenciamento são privados e nunca devem ser adicionados a um site.
7. Valide antes do lançamento
Instale a integração escolhida primeiro em um site de prévia ou staging. Teste a origem implantada, a navegação entre rotas, as citações, o comportamento de fallback, o layout para dispositivos móveis e o console do navegador antes de publicar amplamente.
Conclua o checklist de lançamento e use o Analytics e Content Gaps para melhorar a documentação depois que perguntas reais começarem a chegar.