Primeiros passos
As quotas documentadas de páginas incluídas são partilhadas entre os projetos do mesmo proprietário. Consulte os preços para as quotas dos planos e Conta e faturação no dashboard para a utilização atual e a quota disponível da sua conta.
Crie um chatbot útil antes de o colocar no seu site. A sequência principal é criar → adicionar conteúdo → rever → testar → personalizar → integrar.
1. Crie uma conta e um projeto
Entre no dashboard do ChattyBox, selecione Novo chatbot e atribua um nome ao projeto e, opcionalmente, um URL do site. Após a criação, abre-se Conhecimento → Importar e atualizar. Ao abrir um projeto sem um separador selecionado, a vista predefinida é Visão geral. A criação, por si só, não inicia uma importação.
Consulte os preços para ver os limites atuais de projetos, páginas e uso.
2. Configure a fonte de conteúdo
Em Conhecimento → Importar e atualizar, ligue o site público, reveja as páginas encontradas, ajuste a seleção recomendada ou personalizada e inicie a importação ou atualização apenas das páginas selecionadas. As alterações às definições da fonte são guardadas automaticamente: verifique o estado da gravação e resolva erros de validação ou tente novamente uma gravação falhada antes de continuar. As definições avançadas da fonte também disponibilizam uma ação separada Recolher agora, que utiliza o modo de descoberta configurado. As regras de inclusão/exclusão e a profundidade do crawling estão disponíveis através da configuração como código, não nos controlos do dashboard.
O ChattyBox extrai conteúdo HTML legível e coloca o conteúdo alterado na fila para indexação. A descoberta e a gravação automática não iniciam, por si só, a importação. Não processa JavaScript nem aplica robots.txt: utilize páginas públicas que esteja autorizado a indexar e selecione cuidadosamente o âmbito inicial. A duração depende da descoberta, do número de páginas e do trabalho de indexação.
Use Adicionar e atualizar conteúdo quando precisar de orientações sobre sitemap, URL manual, crawling, conteúdo multilingue ou novo crawling.
3. Revise o conteúdo indexado
Abra Conhecimento → Páginas e compare as páginas efetivamente importadas com as fontes previstas. Consulte o trabalho de scraping para verificar as contagens e os avisos de conteúdo parcial; verifique também o trabalho separado de embeddings antes de avaliar as respostas. A conclusão do scraping não garante que todas as páginas pedidas ou secções tenham sido indexadas. Consulte progresso e indexação parcial.
4. Teste a qualidade das respostas
Abra Testar chatbot e faça perguntas representativas que os visitantes reais colocariam. 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.
Quando uma resposta for fraca, melhore o conteúdo de origem ou a seleção de páginas e volte a atualizar quando o intervalo do plano o permitir: no Free, no máximo semanalmente; nos planos pagos, no máximo diariamente. Testar chatbot utiliza a quota de mensagens do proprietário e guarda conversas. As interações de teste podem surgir em Análises e, quando detetadas como perguntas sem resposta, em Perguntas sem resposta; a faturação e o registo de lacunas dependem do resultado. Não instale o chatbot apenas porque o primeiro scraping terminou.
5. Ajuste a experiência
Utilize Personalizar → Comportamento para escolher Assistente prestável, Representante de vendas, Suporte técnico, Bot sarcástico ou Persona personalizada e editar as instruções. As alterações são guardadas automaticamente; verifique o estado da gravação antes de continuar. Ao editar uma predefinição, o estado passa a Personalizado. Estas instruções complementam as regras incorporadas de fundamentação e formatação do ChattyBox; o conteúdo recuperado é acrescentado automaticamente, por isso não copie a base de conhecimento para o prompt.
O texto da persona não substitui a resposta alternativa obrigatória quando falta contexto ou existem lacunas de conteúdo. A definição separada assistant.fallbackMessage está disponível através da configuração como código, não num campo Persona. Depois de guardar, teste tanto perguntas suportadas como o comportamento da resposta alternativa. Se pretender utilizar o widget alojado, use Personalizar → Aparência para pré-visualizar o título, a mensagem de boas-vindas, as cores, o ícone, a posição e o comportamento do idioma. Estas alterações também são guardadas automaticamente; verifique o estado da gravação. O modo fixo e as substituições do script afetam o idioma da interface do widget, não os idiomas das páginas indexadas; consulte a resolução de problemas de idioma. O plano Free inclui personalização visual, mas exige a marca ChattyBox; os planos Starter e superiores permitem ocultá-la.
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 mantida pelo ChattyBox a partir do código da aplicação | SDK JavaScript |
| Criar e manter a 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 |
| Gerir a configuração do projeto pelo Git e CI | CLI e implementação da configuração |
| Usar a interface mantida pelo ChattyBox sem npm nem uma etapa de build | Script do widget alojado |
| 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. Uma chave preparada para o domínio de um site pode já estar limitada a essa origem; as chaves criadas sem restrições funcionam em origens diferentes. Em Instalar → Chaves e domínios, utilize Editar origens para gerir restrições opcionais e adicionar as origens de produção, pré-visualização, staging e localhost necessárias. Quando ativadas, as restrições exigem correspondência exata do esquema, nome do anfitrião e porta (por exemplo, https://example.com e http://localhost:3000 são origens diferentes). São um reforço de segurança opcional, não um método de autenticação de visitantes. Em Instalar → Instalação no site, selecione a chave e copie o snippet gerado e o URL da API.
As chaves públicas do widget destinam-se a ser incluídas no código do navegador. Os tokens de implementação da configuração e outras credenciais de gestão são privados e nunca devem ser incluídos num site.
Para recuperar uma chave pública existente, introduza um URL de site HTTP(S) em Instalação no site e selecione a chave no snippet. O seletor apresenta chaves não expiradas que não têm restrições ou são permitidas para a origem desse URL. Para selecionar uma chave restrita, introduza uma origem permitida; use Gerir chaves e domínios permitidos para consultar as restrições. Se o formulário não estiver disponível, conclua primeiro o passo de configuração apresentado no dashboard. Para substituir uma chave, crie uma nova, atualize e teste a instalação e depois elimine a antiga: a eliminação interrompe imediatamente as instalações que ainda a utilizem. Uma chave pertence a um único chatbot; chamá-la “staging” ou “production” não separa os ambientes.
7. Valide antes do lançamento
Instale primeiro a integração escolhida num site de pré-visualização ou staging. Teste a origem implementada, a navegação entre rotas, as citações, o comportamento da resposta alternativa, o layout em dispositivos móveis e a consola do navegador antes de publicar de forma generalizada.
Conclua o checklist de lançamento e utilize Conversas → Histórico para consultar as conversas guardadas (disponível em todos os planos) ou Análises e Perguntas sem resposta nos planos Pro/Business para melhorar a documentação quando surgirem perguntas reais.
Mapa do dashboard
Abra um projeto em /chatbot/<projectId>. As vistas são separadores selecionados através do parâmetro de consulta tab, não páginas secundárias separadas:
| Vista da área de trabalho | Valor da consulta | O que fazer |
|---|---|---|
| Visão geral | overview | Rever o progresso da configuração e a atividade recente |
| Conhecimento → Importar e atualizar | settings | Descobrir, selecionar, importar e atualizar páginas; ajustar as definições da fonte |
| Conhecimento → Páginas | content | Rever páginas e trabalhos de scraping, eliminar conteúdo e reconstruir embeddings |
| Testar chatbot | test | Fazer perguntas e consultar conversas guardadas |
| Conversas → Histórico | logs | Ler conversas guardadas e eliminar uma conversa ou todas |
| Conversas → Análises | analytics | Rever os últimos 30 dias de interações registadas, até 5.000; Pro/Business |
| Conversas → Perguntas sem resposta | gaps | Rever e resolver perguntas sem resposta detetadas; Pro/Business |
| Personalizar → Comportamento | prompts | Escolher ou editar as instruções do assistente |
| Personalizar → Aparência | appearance | Pré-visualizar e ajustar a aparência e o idioma do widget alojado |
| Instalar → Chaves e domínios | keys | Criar/eliminar chaves públicas e editar restrições de origem opcionais |
| Instalar → Instalação no site | embed | Preparar uma instalação e copiar o snippet de uma chave |
| Definições do chatbot | manage | Gerir os dados do chatbot, os tokens de implementação e o bloqueio de configuração, ou eliminar o chatbot |
Todos os chatbots regressa a /dashboard. A vista geral da conta está em /dashboard/overview; Conta e faturação está em /settings/account e inclui perfil, plano, utilização de mensagens, portal de faturação e controlos PAYG. /settings e /settings/billing redirecionam para essa página. /settings/keys disponibiliza um seletor de projeto para criar/eliminar chaves públicas; as restrições de origem opcionais são editadas na vista Chaves e domínios do chatbot.
Permissões e bloqueio da configuração
O acesso aos projetos no dashboard é exclusivo do proprietário (ou do utilizador proprietário de um espaço de trabalho legado). Uma chave pública do widget não dá acesso às definições do projeto nem ao histórico de conversas guardadas; a adesão a uma organização, por si só, não concede estas permissões.
Para gerir o projeto através de Git/CI, Definições do chatbot disponibiliza tokens de implementação da configuração com âmbitos de desenvolvimento, pré-visualização e/ou produção, validade opcional e revogação. O valor completo do token só é apresentado no momento da criação; a secção também mostra o histórico de implementações.
A ação Ativar bloqueio da configuração é irreversível. Bloqueia as gravações de configuração no dashboard e as operações manuais de conteúdo, incluindo guardar a persona e Recolher agora, mesmo que um controlo continue visível. A partir daí, implemente a configuração através do fluxo da CLI. A gestão de chaves públicas, a limpeza de conversas e a preferência de marca permitida pelo plano são independentes dos campos de configuração bloqueados. Os âmbitos de ambiente dos tokens autorizam implementações; não criam chatbots separados nem ambientes para chaves de navegador.
A configuração como código também disponibiliza widget.enabled. Defini-lo como false desativa o chat público, incluindo o SDK headless, e não apenas o widget flutuante. A vista Aparência atual não inclui um controlo para ativar/desativar esta opção.
Planos e quotas
| Plano | Chatbots | Páginas incluídas | Mensagens por mês |
|---|---|---|---|
| Free | 1 | 10 | 100 |
| Starter | 3 | 150 | 1.000 |
| Pro | 10 | 5.000 | 10.000 |
| Business | 25 | 25.000 | 50.000 |
As quotas de mensagens e de páginas armazenadas incluídas são partilhadas ao nível do proprietário entre os respetivos chatbots, incluindo Testar chatbot. O trabalho mensal de atualização de páginas e os intervalos entre atualizações são limites distintos; consulte os limites de atualização antes de uma importação ou reconstrução de grande dimensão. Consulte os preços para conhecer as quotas partilhadas documentadas e Conta e faturação para a utilização atual e a quota disponível da sua conta.
O PAYG para mensagens, páginas e sites é opcional nos planos Pro/Business e está desativado por predefinição. Em Conta e faturação, defina orçamentos mensais de excedentes por funcionalidade ou escolha explicitamente Sem limite de despesa. Um orçamento de zero mantém o limite rígido dessa funcionalidade; sem limite de despesa, a utilização pode gerar cobranças sem limite. O PAYG não desbloqueia funcionalidades dos planos Free/Starter nem contorna os intervalos de atualização do crawler. Pode alterar o nome do perfil aqui; o endereço de email é gerido nas definições da conta do fornecedor de início de sessão.