InícioDocumentação

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)

  1. Vá para Plugins → Add New no seu admin do WordPress
  2. Pesquise por ChatReact
  3. Clique em Install Now, depois Ativar

Method 2: Upload via WordPress Admin

  1. Baixe o arquivo ZIP do plugin acima
  2. Vá para Plugins → Add New → Upload Plugin
  3. Escolha o arquivo ZIP e clique em Install Now
  4. Clique em Activate Plugin

Method 3: Manual Upload via FTP

  1. Extraia o arquivo ZIP
  2. Faça upload da pasta chatreact para /wp-content/plugins/
  3. Vá para Plugins no admin do WordPress
  4. 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

  1. Faça login em chatreact.ai
  2. Abra seu chatbot e vá para a aba Incorporar
  3. Clique Copiar código para copiar o snippet de embed, ou leia o ID a partir do atributo data-chatbot-id no código copiado

Finding Your Form ID

  1. Faça login em chatreact.ai
  2. Vá para Formulários
  3. Clique Copiar código de incorporação no seu formulário (ou abra o formulário e mude para a aba Incorporar)
  4. Seu Form ID é o valor de data-form-id no 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:

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

3. Elementor

Se você usa Elementor:

  1. Edite sua página com o Elementor
  2. Pesquise por "ChatReact" nos widgets
  3. Arraste o widget para sua página
  4. 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:

  1. Abra o menu ChatReact na sua barra lateral do admin
  2. Na aba Chat Widget, encontre Widget Assignments
  3. Clique em Add Assignment, escolha uma página ou post (ou selecione Everywhere), e insira seu Chatbot ID
  4. 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:

  1. Edite qualquer página ou post
  2. Encontre a caixa meta "ChatReact Widget"
  3. Marque Enable custom widget for this page
  4. Insira seu Chatbot ID e opcionalmente escolha uma posição (Default, Bottom Right, Bottom Left)
  5. 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

  1. Verifique se seu Chatbot ID está correto
  2. Verifique se o chatbot está ativo no seu dashboard ChatReact
  3. Limpe quaisquer plugins de cache de página (veja abaixo)
  4. 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):

  1. Limpe o cache do plugin de cache
  2. Exclua chatreact da minificação/combineção de JS nas configurações do seu plugin de cache
  3. O plugin usa atributos data-api-url como 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 !important no 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

  1. Generate an Integration Key no dashboard ChatReact (Knowledge Base → Websites → CMS Integrations)
  2. Cole a chave nas configurações do plugin do WordPress na aba Integration
  3. Selecione os tipos de conteúdo que deseja compartilhar (Pages, Posts, Custom Post Types)
  4. Defina prioridades (High/Medium/Low) por tipo de conteúdo
  5. 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

PriorityDefault forDescription
HighPagesConteúdo principal do negócio (About, Services, Contact)
MediumPostsArtigos 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, e auto_open (language ainda é suportado)

Next Steps