Pular para o conteúdo principal

Plugin de chatbot para WordPress

O pacote fixo 0.2.0 declara WordPress 5.8+ e PHP 7.4+, com testes até WordPress 6.8; teste as versões efetivas do WordPress e do PHP e o tema, pois estes metadados não garantem compatibilidade com versões posteriores. O plugin começa desativado, tem o endpoint da API integrado nesta versão e as verificações não detetam todas as páginas privadas. No código-fonte atual do widget alojado, o modo de deteção automática tenta primeiro o idioma suportado da página, seguido dos idiomas suportados do navegador, da localidade predefinida configurada e do inglês; no modo fixo, é utilizada a localidade predefinida do projeto. A substituição por script só prevalece se for permitida.

Utilize o plugin WordPress oficial do ChattyBox quando quiser uma instalação sem código que carregue o widget alojado sem editar os ficheiros do tema. Este guia aborda a configuração operacional. A página do chatbot de IA para WordPress explica a estratégia de conteúdo e rastreio, enquanto a página de apresentação do plugin WordPress oferece uma visão geral do produto.

Posso usar o ChattyBox no WordPress sem a marca?​

Sim. O plugin oficial carrega o widget alojado do ChattyBox no seu site WordPress. O plano Free mantém o rodapé “Powered by ChattyBox”. Starter, Pro e Business permitem removê-lo desativando Mostrar a marca ChattyBox em Personalizar → Marca ChattyBox. Consulte a personalização do widget para encontrar a opção e os preços para comparar os planos.

Antes de instalar​

Conclua primeiro o fluxo Primeiros passos: ligue o URL público do WordPress, reveja as páginas indexadas e verifique respostas representativas em Testar chatbot. Em Instalar → Chaves e domínios, consulte ou crie uma chave pública do widget e verifique as definições de origem. Em Instalar → Instalação no site, selecione uma chave adequada e copie-a do excerto de instalação.

Instalar o plugin​

O plugin não tem dependência de Composer, npm ou uma etapa de build.

O plugin é atualmente distribuído a partir do repositório público do ChattyBox no GitHub, não do Diretório de Plugins do WordPress.org, pelo que deve usar o fluxo Upload Plugin do WordPress em vez da pesquisa no diretório. As atualizações automáticas geridas pelo diretório ainda não estão disponíveis.

  1. Transfira o ZIP fixo do plugin WordPress 0.2.0 do ChattyBox ou consulte o repositório público do código-fonte.
  2. No WordPress, abra Plugins > Add New > Upload Plugin, envie o ZIP e ative ChattyBox AI Chatbot. Para uma instalação manual no servidor, copie primeiro o diretório do plugin para wp-content/plugins/.
  3. Abra Settings > ChattyBox.
  4. Cole a chave API pública do widget a partir do snippet de instalação.
  5. Ative o chatbot e guarde as definições.

O plugin guarda a chave pública do widget e as definições de apresentação nas opções do WordPress. Nunca cole uma credencial de gestão do ChattyBox no plugin.

Configurar o carregamento​

As predefinições de produção são:

  • Script do widget: https://chattybox.ai/widget.js
  • Endpoint da API: configurado automaticamente pelo plugin
  • Ativado: não, até ativar o chatbot com uma chave pública não vazia
  • Substituição da localidade: vazia; o widget alojado segue a política de localidade do projeto, com Detetar automaticamente como opção predefinida

No código-fonte atual do widget alojado, o modo Detetar automaticamente tenta primeiro um idioma suportado em <html lang> da página, depois os idiomas suportados do navegador, a localidade predefinida configurada e o inglês. No modo Fixo, utiliza-se a localidade predefinida do projeto. A substituição de idioma opcional do plugin passa a ser data-locale e só prevalece se o projeto permitir substituições de script. Utilize um código de localidade suportado em minúsculas; o cabeçalho e a mensagem de boas-vindas personalizados não são traduzidos automaticamente. Se depender deste comportamento, verifique a versão do loader, que é implementado separadamente.

O endpoint da API está integrado nesta versão do plugin e não é obtido a partir da chave. Alterar Widget script URL não altera esse endpoint. Se o snippet de instalação no site apontar para outra implementação da API, utilize a integração manual por script. Os URLs remotos do loader têm de usar HTTPS; HTTP só é permitido para hosts locais de desenvolvimento (localhost, 127.0.0.1 e ::1).

O plugin regista o widget nos pedidos de enfileiramento de scripts do frontend do WordPress e ignora explicitamente feeds, pedidos REST e pedidos AJAX. Estas verificações não analisam todos os tipos de resposta nem garantem que todas as páginas do frontend são públicas.

Estas guardas de pedidos não verificam a privacidade nem o estado de associação de todas as páginas do frontend. Se necessário, exclua explicitamente páginas de checkout, conta, protegidas por palavra-passe ou reservadas a membros. Confirme também que o tema executa os scripts de rodapé do WordPress. O plugin não rastreia nem sincroniza artigos; a indexação e a atualização do conteúdo são feitas no ChattyBox.

As chaves criadas sem restrições funcionam a partir de diferentes origens do navegador; uma chave preparada para um site pode já estar limitada à origem desse site. As restrições opcionais em Instalar → Chaves e domínios exigem cada combinação pretendida de esquema, nome do anfitrião e porta. Para chaves com restrições, uma origem efetiva do pedido em falta ou não permitida resulta em 401 Invalid API key; quando o cabeçalho Origin está ausente, o servidor pode determinar a origem a partir de um Referer válido. As restrições de origem são uma proteção adicional, não um método de autenticação dos visitantes. Teste a página de produção, não apenas o painel.

Excluir rotas adicionais​

Use o filtro chattybox_load_widget de um plugin específico do site ou de um tema filho quando uma rota pública não deve exibir o widget:

O filtro é aplicado a cada pedido do WordPress no servidor; não desmonta um widget já inicializado durante a navegação do lado do cliente.

add_filter(
    'chattybox_load_widget',
    static function ( $should_load ) {
        return $should_load && ! is_page( array( 'checkout', 'account' ) );
    }
);

Mantenha primeiro o comportamento predefinido do plugin ativado e depois adicione apenas as exclusões de rotas necessárias para o seu site. Após alterar o filtro, teste uma rota excluída e uma página pública normal.

Fallback de script manual​

Utilize o plugin como opção predefinida. Se a sua equipa de WordPress já gerir scripts através de um tema, tema filho, plugin de scripts ou Google Tag Manager, pode carregar o widget alojado manualmente:

<script
  src="https://chattybox.ai/widget.js"
  data-api-key="YOUR_API_KEY"
  data-api-url="YOUR_WIDGET_API_URL"
  async
></script>

Não ative o plugin e adicione o mesmo snippet do widget ao mesmo tempo. Escolha um único loader para que os visitantes não recebam lançadores duplicados.

Verificar a instalação​

Depois de configurar o plugin:

  • Abra uma página pública do WordPress numa janela anónima.
  • Confirme que o lançador aparece uma vez.
  • Faça uma pergunta real de visitante.
  • Verifique se uma resposta suportada cita páginas públicas indexadas do WordPress e se uma pergunta não suportada apresenta a resposta alternativa, que pode não ter fontes.
  • Verifique na consola do navegador se faltam data-api-key ou data-api-url ou se existem erros de chave.
  • Teste uma rota de checkout, de conta ou privada se tiver configurado uma exclusão.
  • Limpe as caches de página relevantes do WordPress/CDN depois de alterar as definições ou exclusões e teste um novo pedido da página. As exclusões do lado do servidor não removem um widget já inicializado durante a navegação do lado do cliente. Em rotas sensíveis ou após a revogação do consentimento, confirme a versão do loader implementada e desmonte ativamente o widget através de uma integração suportada; remover apenas o script ou ocultar o widget com CSS não constitui uma desmontagem completa. A desmontagem não pode anular pedidos já processados pelo servidor.
  • O loader automático do plugin não verifica o consentimento do visitante antes de enfileirar o widget. Se for necessário obter consentimento, utilize uma integração que impeça o carregamento até que este seja concedido e verifique o comportamento após a revogação com o loader implementado.

Continue com a lista de verificação do lançamento antes de anunciar o chatbot. Consulte Conversas → Histórico, disponível em todos os planos, para rever as conversas. Nos planos Pro e Business, utilize Conversas → Análises e Conversas → Perguntas sem resposta para identificar oportunidades de melhoria depois de receber perguntas reais.