HomeDocumentation

Plugin WordPress

Adicione chatbots de IA ChatReact, formulários de contacto e acordeões de FAQ ao seu site WordPress com o nosso plugin oficial.

Download

Baixar Plugin ChatReact v1.1.0

Instalação

Método 1: Upload via Admin WordPress

  1. Baixe o arquivo ZIP do plugin acima
  2. Vá para Plugins → Adicionar novo → Enviar plugin
  3. Escolha o arquivo ZIP e clique em Instalar agora
  4. Clique em Ativar plugin

Método 2: Upload manual via FTP

  1. Extraia o arquivo ZIP
  2. Carregue a pasta chatreact para /wp-content/plugins/
  3. Vá para Plugins no admin do WordPress
  4. Encontre "ChatReact" e clique em Ativar

Configuração

Após a ativação, vá para Configurações → ChatReact para instruções de uso.

Encontrar o seu ID de Chatbot

  1. Faça login em chatreact.ai
  2. Vá para o Painel do seu chatbot
  3. Clique no botão Copiar ao lado do ID do Chatbot (mostrado no topo)

Opções de uso

O plugin oferece várias formas de adicionar o ChatReact:

1. Shortcodes

Adicione a qualquer página, artigo ou área de widget:

Widget de Chat:

[chatreact id="SEU_ID_CHATBOT"]

Atributos opcionais: position, language, primary_color, auto_open

Formulário de Contacto:

[chatreact_form id="SEU_ID_FORMULARIO"]

Acordeão FAQ:

[chatreact_faq id="SEU_ID_CHATBOT"]

2. Blocos Gutenberg

No editor de blocos:

  1. Clique em + para adicionar um bloco
  2. Pesquise por "ChatReact"
  3. Escolha Chat Widget, Form Widget ou FAQ Widget
  4. Introduza o seu ID nas configurações do bloco

3. Elementor

Se usa Elementor:

  1. Edite a sua página com Elementor
  2. Pesquise por "ChatReact" nos widgets
  3. Arraste o widget para a sua página
  4. Configure no painel esquerdo

Idiomas suportados

O plugin suporta 24 idiomas da UE.

Resolução de problemas

4. Atribuição a Nível de Página

Atribua widgets a páginas específicas sem shortcodes:

  1. Edite qualquer página ou artigo
  2. Encontre o meta box "ChatReact Widget"
  3. Selecione um tipo de widget
  4. Insira seu ID
  5. Salve a página

Exemplos de Shortcodes

Widget de Chat básico

[chatreact id="abc123"]

Widget de Chat com opções

[chatreact id="abc123" position="bottom-left" language="de" auto_open="true"]

FAQ com filtro de categoria

[chatreact_faq id="abc123" categories="shipping,returns"]

Formulário de contato estilizado

[chatreact_form id="form123" language="en"]

Idiomas Suportados

O plugin suporta 24 idiomas da UE:

  • Alemão, Búlgaro, Checo, Croata, Dinamarquês, Eslovaco
  • Esloveno, Espanhol, Estoniano, Finlandês, Francês, Grego
  • Húngaro, Inglês, Irlandês, Italiano, Letão, Lituano
  • Maltês, Neerlandês, Polaco, Português, Romeno, Sueco

Resolução de Problemas

Widget não aparece

  1. Verifique se o seu ID de Chatbot está correto
  2. Verifique se o chatbot está ativo no seu painel ChatReact
  3. Limpe qualquer plugin de cache (veja abaixo)
  4. Verifique a consola do navegador para erros JavaScript

Compatibilidade com Plugins de Cache

O plugin é totalmente compatível com plugins populares de cache e otimização, incluindo WP Rocket, LiteSpeed Cache, Autoptimize e WP Super Cache. O plugin impede automaticamente que essas ferramentas minifiquem ou cacheiem os scripts do ChatReact.

Se ainda tiver problemas (por exemplo, erros 404, widget não carrega para visitantes não autenticados):

  1. Limpe o cache do seu plugin de cache
  2. Exclua chatreact da minificação/combinação de JS nas configurações do seu plugin de cache
  3. O plugin usa atributos data-api-url como fallback para garantir a comunicação correta com a API

Conflitos de Estilo

Se o widget parecer quebrado:

  • O widget usa CSS isolado
  • Verifique regras CSS !important no seu tema
  • Tente desativar outros plugins de chat temporariamente

Múltiplos Widgets

Você pode usar diferentes chatbots em diferentes páginas especificando IDs únicos em cada shortcode ou bloco.

Integração CMS (Smart Sitemap)

A partir da versão 1.1.0, o plugin WordPress do ChatReact inclui um recurso de Smart Sitemap que fornece ao crawler do ChatReact metadados estruturados de conteúdo diretamente do seu site WordPress.

Como Funciona

  1. Gere uma Integration Key no painel do ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Cole a chave nas configurações do plugin WordPress na aba Integration
  3. Selecione os tipos de conteúdo que deseja compartilhar (Páginas, Artigos, Custom Post Types)
  4. Defina prioridades (Alta/Média/Baixa) por tipo de conteúdo
  5. Quando rastrear seu site, o ChatReact usará automaticamente o smart sitemap em vez da descoberta regular baseada em links

Benefícios

  • Rastreamento mais rápido – Lista direta de URLs em vez de descoberta link por link
  • Reconhecimento do tipo de conteúdo – O crawler sabe se um URL é uma Página, Artigo ou Custom Post Type
  • Indexação baseada em prioridade – Conteúdo importante (como Páginas) pode ter maior peso que artigos do blog
  • Compartilhamento seletivo – Compartilhe apenas os tipos de conteúdo que desejar
  • Exclusão por artigo – Exclua artigos/páginas individuais do sitemap via meta box

Níveis de Prioridade

PrioridadePadrão paraDescrição
AltaPáginasConteúdo principal do negócio (Sobre, Serviços, Contato)
MédiaArtigosArtigos do blog, atualizações
BaixaConteúdo complementar

Segurança

O endpoint do smart sitemap (/wp-json/chatreact/v1/sitemap) é protegido pela Integration Key. Não é visível para motores de busca ou outros crawlers — apenas o ChatReact pode acessá-lo com a chave correta.

Excluindo Artigos Individuais

No editor do WordPress, cada artigo/página tem um meta box ChatReact Widget com a opção "Excluir do Sitemap ChatReact". Os artigos marcados não aparecerão no smart sitemap.

Requisitos

Registro de Alterações

1.1.0

  • NOVO: Smart Sitemap (Integração CMS) — compartilhamento estruturado de conteúdo com o crawler do ChatReact
  • NOVO: Aba Integration nas configurações do plugin
  • NOVO: Seleção de tipos de conteúdo com níveis de prioridade
  • NOVO: Exclusão por artigo do sitemap via meta box
  • NOVO: Endpoint REST API protegido para smart sitemap
  • FIX: Compatibilidade total com plugins de cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
  • FIX: Problemas de carregamento do widget para visitantes não autenticados com plugins de cache
  • CHANGED: As configurações do widget agora são gerenciadas centralmente no painel do ChatReact — removidas configurações de posição, idioma, cor primária e abertura automática do plugin

1.0.24

  • Suporte a blocos Gutenberg
  • Integração Elementor
  • Traduções em 24 idiomas
  • Atribuição de widget a nível de página

Próximos passos