Pular para o conteúdo principal

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​

ObjetivoPróximo passo
Montar a interface mantida pelo ChattyBox a partir do código da aplicaçãoSDK JavaScript
Criar e manter a sua própria interfaceSDK JavaScript headless
Permitir que um assistente de programação com IA integre o pacote npmIntegração assistida por IA
Gerir a configuração do projeto pelo Git e CICLI e implementação da configuração
Usar a interface mantida pelo ChattyBox sem npm nem uma etapa de buildScript do widget alojado
Adicionar o widget mantido ao WordPress sem editar o temaPlugin WordPress
Adicionar o widget mantido ao Drupal 10 ou 11 com ComposerMó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 trabalhoValor da consultaO que fazer
Visão geraloverviewRever o progresso da configuração e a atividade recente
Conhecimento → Importar e atualizarsettingsDescobrir, selecionar, importar e atualizar páginas; ajustar as definições da fonte
Conhecimento → PáginascontentRever páginas e trabalhos de scraping, eliminar conteúdo e reconstruir embeddings
Testar chatbottestFazer perguntas e consultar conversas guardadas
Conversas → HistóricologsLer conversas guardadas e eliminar uma conversa ou todas
Conversas → AnálisesanalyticsRever os últimos 30 dias de interações registadas, até 5.000; Pro/Business
Conversas → Perguntas sem respostagapsRever e resolver perguntas sem resposta detetadas; Pro/Business
Personalizar → ComportamentopromptsEscolher ou editar as instruções do assistente
Personalizar → AparênciaappearancePré-visualizar e ajustar a aparência e o idioma do widget alojado
Instalar → Chaves e domínioskeysCriar/eliminar chaves públicas e editar restrições de origem opcionais
Instalar → Instalação no siteembedPreparar uma instalação e copiar o snippet de uma chave
Definições do chatbotmanageGerir 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​

PlanoChatbotsPáginas incluídasMensagens por mês
Free110100
Starter31501.000
Pro105.00010.000
Business2525.00050.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.