WordPress Plugin
Adicione chatbots ChatReact AI, formulários de contato e acordéons de FAQ ao seu site WordPress com o nosso plugin oficial.
Download
O plugin está disponível no WordPress Plugin Directory oficial, ou como download direto:
Download ChatReact Plugin v1.2.1
Installation
Method 1: WordPress Plugin Directory (Recommended)
- Vá para Plugins → Add New no seu admin do WordPress
- Pesquise por ChatReact
- Clique em Install Now, depois Ativar
Method 2: Upload via WordPress Admin
- Baixe o arquivo ZIP do plugin acima
- Vá para Plugins → Add New → Upload Plugin
- Escolha o arquivo ZIP e clique em Install Now
- Clique em Activate Plugin
Method 3: Manual Upload via FTP
- Extraia o arquivo ZIP
- Faça upload da pasta
chatreactpara/wp-content/plugins/ - Vá para Plugins no admin do WordPress
- Encontre "ChatReact" e clique em Ativar
Configuration
Após a ativação, abra o menu ChatReact na barra lateral do admin do WordPress para configurações e instruções de uso.
Finding Your Chatbot ID
- Faça login em chatreact.ai
- Abra seu chatbot e vá para a aba Incorporar
- Clique Copiar código para copiar o snippet de embed, ou leia o ID a partir do atributo
data-chatbot-idno código copiado
Finding Your Form ID
- Faça login em chatreact.ai
- Vá para Formulários
- Clique Copiar código de incorporação no seu formulário (ou abra o formulário e mude para a aba Incorporar)
- Seu Form ID é o valor de
data-form-idno código de embed copiado
Usage Options
O plugin oferece várias maneiras de adicionar o ChatReact ao seu site:
1. Shortcodes
Adicione em qualquer página, post ou área de widget:
Chat Widget:
[chatreact id="YOUR_CHATBOT_ID"]
Atributos opcionais: language
Contact Form:
[chatreact_form id="YOUR_FORM_ID"]
Atributos opcionais: language
FAQ Accordion:
[chatreact_faq id="YOUR_CHATBOT_ID"]
Atributos opcionais: categories, container, language
As configurações visuais, como posição, cores e auto-open são gerenciadas centralmente no seu dashboard ChatReact e se aplicam automaticamente ao seu site WordPress. O atributo language é opcional em todos os shortcodes — se você omiti-lo, o idioma da página atual é detectado automaticamente (funciona com sites multilingues).
2. Gutenberg Blocks
No editor de blocos:
- Clique + para adicionar um bloco
- Pesquise por "ChatReact"
- Escolha ChatReact Chat, ChatReact Form, ou ChatReact FAQ
- Insira seu ID nas configurações do bloco
3. Elementor
Se você usa Elementor:
- Edite sua página com o Elementor
- Pesquise por "ChatReact" nos widgets
- Arraste o widget para sua página
- Configure no painel à esquerda
4. Widget Assignments (Plugin Settings)
Mostre um chatbot em páginas específicas — ou em todo o site — sem editar qualquer conteúdo:
- Abra o menu ChatReact na sua barra lateral do admin
- Na aba Chat Widget, encontre Widget Assignments
- Clique em Add Assignment, escolha uma página ou post (ou selecione Everywhere), e insira seu Chatbot ID
- Clique Salvar Alterações
Para atribuições Everywhere você pode excluir URLs específicas — uma por linha, com suporte a curingas (por exemplo /blog/* ou /checkout) — para ocultar o widget em landing pages ou durante checkout.
Por padrão apenas Pages são pesquisáveis ao atribuir. Clique no botão Post Types para tornar outros tipos de conteúdo (ex.: Posts ou custom post types) pesquisáveis também.
5. Page-Level Assignment
Atribua um chatbot a uma única página diretamente do editor:
- Edite qualquer página ou post
- Encontre a caixa meta "ChatReact Widget"
- Marque Enable custom widget for this page
- Insira seu Chatbot ID e opcionalmente escolha uma posição (Default, Bottom Right, Bottom Left)
- Salve a página
A mesma caixa meta também oferece a opção Disable all widgets on this page se você quiser ocultar totalmente o ChatReact em certas páginas.
Shortcode Examples
Basic Chat Widget
[chatreact id="abc123"]
Chat Widget with a Fixed Language
[chatreact id="abc123" language="de"]
FAQ with Category Filter
[chatreact_faq id="abc123" categories="shipping,returns"]
Styled Contact Form
[chatreact_form id="form123" language="en"]
FAQ Widget: SEO & Caching
SEO-Friendly FAQs
Desde a versão 1.1.2, widgets de FAQ são renderizados no servidor: suas FAQs fazem parte do HTML da página e incluem dados estruturados JSON-LD (schema FAQPage). Motores de busca e assistentes de IA podem lê-las sem executar qualquer JavaScript.
llms.txt for AI Crawlers
O plugin pode servir seu conteúdo de FAQ em yoursite.com/llms.txt, um arquivo de descoberta lido por rastreadores de IA. Está habilitado por padrão. Para alterná-lo ou definir um Chatbot ID específico para o arquivo, vá para ChatReact → FAQ Widget → Cache & SEO Settings.
FAQ Caching
Os dados de FAQ são cacheados no seu servidor para carregamentos rápidos de página. Em ChatReact → FAQ Widget → Cache & SEO Settings você pode:
- Definir a Cache Duration — 1, 3, 6 (recomendado), 12, ou 24 horas, ou desabilitar o cache
- Clicar em Clear Cache para atualizar suas FAQs imediatamente
O cache também é limpo automaticamente sempre que suas FAQs mudam no dashboard ChatReact.
Supported Languages
O plugin suporta 24 idiomas da UE:
- Bulgarian, Croatian, Czech, Danish, Dutch, English
- Estonian, Finnish, French, German, Greek, Hungarian
- Irish, Italian, Latvian, Lithuanian, Maltese, Polish
- Portuguese, Romanian, Slovak, Slovenian, Spanish, Swedish
Desde a versão 1.2.0, traduções para todos os 24 idiomas são fornecidas com o plugin. O idioma do widget é detectado automaticamente a partir da página atual, então sites multilíngues funcionam imediatamente — use o atributo de shortcode language apenas se quiser forçar um idioma específico.
Troubleshooting
Widget Not Appearing
- Verifique se seu Chatbot ID está correto
- Verifique se o chatbot está ativo no seu dashboard ChatReact
- Limpe quaisquer plugins de cache de página (veja abaixo)
- Verifique o console do navegador por erros de JavaScript
Caching Plugin Compatibility
O plugin é totalmente compatível com plugins de cache e otimização populares incluindo WP Rocket, LiteSpeed Cache, Autoptimize, e WP Super Cache. O plugin previne automaticamente que essas ferramentas minifiquem ou cacheiem os scripts do ChatReact.
Se você ainda experimentar problemas (ex.: erros 404, widget não carregando para visitantes deslogados):
- Limpe o cache do plugin de cache
- Exclua
chatreactda minificação/combineção de JS nas configurações do seu plugin de cache - O plugin usa atributos
data-api-urlcomo fallback para garantir comunicação correta com a API
FAQs Not Updating
Se seu site mostrar FAQs desatualizadas, vá para ChatReact → FAQ Widget e clique em Clear Cache. O cache também é limpo automaticamente quando você edita suas FAQs no dashboard ChatReact.
Styling Conflicts
Se o widget parecer quebrado:
- O widget usa CSS isolado
- Verifique regras CSS
!importantno seu tema - Tente desativar temporariamente outros plugins de chat
Multiple Widgets
Você pode usar chatbots diferentes em páginas distintas especificando IDs únicos em cada shortcode ou bloco.
CMS Integration (Smart Sitemap)
A partir da versão 1.1.0, o plugin ChatReact para WordPress inclui um recurso Smart Sitemap que fornece ao crawler ChatReact metadados de conteúdo estruturado diretamente do seu site WordPress.
How It Works
- Generate an Integration Key no dashboard ChatReact (Knowledge Base → Websites → CMS Integrations)
- Cole a chave nas configurações do plugin do WordPress na aba Integration
- Selecione os tipos de conteúdo que deseja compartilhar (Pages, Posts, Custom Post Types)
- Defina prioridades (High/Medium/Low) por tipo de conteúdo
- Quando você rastrear seu site, o ChatReact usará automaticamente o smart sitemap em vez da descoberta baseada em links
Benefits
- Faster crawling – Lista direta de URLs em vez de descoberta link a link
- Content type awareness – O crawler sabe se uma URL é Page, Post ou Custom Post Type
- Priority-based indexing – Conteúdo importante (como Pages) pode receber peso maior que posts de blog
- Selective sharing – Compartilhe apenas os tipos de conteúdo que desejar
- Per-post exclusion – Exclua posts/páginas individuais do sitemap via a caixa meta
Priority Levels
| Priority | Default for | Description |
|---|---|---|
| High | Pages | Conteúdo principal do negócio (About, Services, Contact) |
| Medium | Posts | Artigos de blog, atualizações de notícias |
| Low | – | Conteúdo suplementar |
Security
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.
Se um plugin de segurança restringir a REST API do WordPress a usuários autenticados, a versão 1.2.1 e posteriores ainda permitem requisições do ChatReact com uma Integration Key válida para /wp-json/chatreact/v1/ — todas as outras rotas REST permanecem bloqueadas. Se um firewall bloquear o endpoint antes do WordPress carregar, permita /wp-json/chatreact/v1/ nele. Sempre que o smart sitemap não puder ser alcançado, a pré-visualização do scan no dashboard ChatReact mostra o motivo e faz fallback para o sitemap público, que ignora sua seleção de tipos de conteúdo.
Excluding Individual Posts
No editor do WordPress, cada post/página tem uma caixa meta ChatReact Widget com uma opção "Exclude from ChatReact Sitemap". Posts marcados não aparecerão no smart sitemap.
Requirements
- WordPress 5.8 ou superior
- PHP 7.4 ou superior
- Uma conta ChatReact (sign up free)
Changelog
1.2.1
- FIX: Smart sitemap acessível novamente em sites que restringem a REST API a usuários autenticados — requisições com uma Integration Key válida são permitidas, para que os tipos de conteúdo selecionados sejam respeitados durante o scan
1.2.0
- NEW: Traduções inclusas para todos os 24 idiomas oficiais da UE
1.1.3
- FIX: Widgets de FAQ com categoria única não mostram mais um botão de filtro "All" desnecessário nem badges de categoria
1.1.2
- NEW: Renderização no lado servidor para widgets de FAQ — FAQs são visíveis para motores de busca e LLMs sem JavaScript
- NEW: Dados estruturados JSON-LD (schema FAQPage) para SEO e rich results aprimorados
- NEW: Endpoint llms.txt para descoberta por crawlers de IA
- NEW: Purga automática do cache de FAQ quando o conteúdo muda no dashboard ChatReact
1.1.1
- FIX: Melhorias de tradução (Romanian, Dutch)
1.1.0
- NEW: Smart Sitemap (CMS Integration) — compartilhamento de conteúdo estruturado com o crawler ChatReact
- NEW: Aba Integration nas configurações do plugin
- NEW: Seleção de tipos de conteúdo com níveis de prioridade
- NEW: Exclusão por post do sitemap via caixa meta
- NEW: Endpoint REST API protegido para smart sitemap
- FIX: Compatibilidade completa com plugins de cache (WP Rocket, LiteSpeed Cache, Autoptimize, WP Super Cache)
- FIX: Problemas de carregamento do widget para visitantes deslogados com plugins de cache
1.0.24
- Widget Assignments — atribua chatbots a páginas diretamente nas configurações do plugin
- Suporte a blocos Gutenberg
- Integração com Elementor
- Traduções para 24 idiomas
- Atribuição de widget em nível de página
- CHANGED: As configurações do widget agora são gerenciadas centralmente no dashboard ChatReact — removidos os atributos de shortcode
position,primary_color, eauto_open(languageainda é suportado)