Primeiros passos

Na próxima versão, as páginas incluídas serão partilhadas entre os projetos do mesmo proprietário; até ao lançamento, o dashboard público poderá continuar a mostrar os limites anteriores por chatbot.

Criar o projeto não inicia scraping. Guarde Website URL em General Settings e, separadamente, modo/páginas em Scraping Configuration. Reveja páginas reais, avisos de indexação parcial e embeddings: Completed não prova cobertura total. Test Chat consome a quota e contribui para Logs/Analytics/Content Gaps.

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
Adicionar o widget mantido ao WordPress sem editar o tema	Plugin WordPress
Adicionar o widget mantido ao Drupal 10 ou 11 com Composer	Módulo Drupal

As integrações de navegador precisam de uma chave pública da API do widget. Por predefinição, as chaves públicas funcionam em produção, pré-visualizações, staging e localhost. Para um reforço opcional de segurança, abra Public Keys > Edit origins, ative Restrict this key to specific origins e adicione cada origem permitida do navegador. As origens restritas têm de corresponder exatamente ao esquema, nome do anfitrião e porta (por exemplo, https://example.com e http://localhost:3000 são origens diferentes). Volte ao Embed para selecionar a chave e copiar o snippet gerado e o 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.