Plugin de chatbot para WordPress

O pacote fixo 0.2.0 declara WordPress 5.8+, PHP 7.4+ e testes até WordPress 6.8; teste a versão e tema reais. O plugin começa desativado, o endpoint é integrado e as guardas não classificam todas as páginas privadas. Em auto, o idioma da página precede o navegador; fixed usa o default e o override exige permissão.

Use o plugin WordPress oficial do ChattyBox quando quiser uma instalação sem código que carregue o widget hospedado sem editar os arquivos 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 rastreamento, enquanto a página de apresentação do plugin WordPress oferece uma visão geral do produto.

Antes de instalar

Conclua primeiro o fluxo Primeiros passos: conecte o URL público do WordPress, revise as páginas indexadas e verifique respostas representativas em Test Chat. Em seguida, crie uma chave pública segura para o navegador em Public Keys e copie-a da aba Embed do projeto.

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 da aba Embed do projeto.
5. Ative o chatbot e salve as configurações.

O plugin armazena a chave pública do widget e as configurações de exibição nas opções do WordPress. Nunca cole uma credencial de gerenciamento do ChattyBox no plugin.

Configurar o carregamento

Os padrões de produção são:

• Script do widget: https://chattybox.ai/widget.js
• Endpoint da API: configurado automaticamente pelo plugin
• Localidade: detectada com base no idioma da página e no navegador do visitante

O plugin carrega o widget nas solicitações do frontend público. Ele ignora intencionalmente wp-admin, feeds, solicitações REST e solicitações AJAX, para que respostas administrativas e respostas que não sejam de páginas não recebam o script.

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:

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

Mantenha primeiro o comportamento padrão do plugin ativado e depois adicione somente 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

Use o plugin como caminho padrão. Se sua equipe do WordPress já gerencia scripts por meio de um tema, tema filho, plugin de scripts ou Google Tag Manager, você pode carregar o widget hospedado 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 em uma janela anônima.
• Confirme que o lançador aparece uma vez.
• Faça uma pergunta real de visitante.
• Verifique se a resposta inclui citações de fontes que levam a páginas públicas do WordPress.
• Verifique no console do navegador se há data-api-key, data-api-url ausentes ou erros de chave.
• Teste uma rota checkout, account ou privada se você tiver configurado uma exclusão.

Continue com a lista de verificação do lançamento antes de anunciar o chatbot. Use Analytics e Content Gaps para melhorar o conteúdo do WordPress depois que perguntas reais chegarem.