ChatReact
InícioDocumentação

Plugin do WordPress

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

Download

O plugin está disponível no WordPress Plugin Directory, ou como download direto:

Download ChatReact Plugin v1.2.0

Instalação

Método 1: Diretório de Plugins do WordPress (Recomendado)

  1. Vá para Plugins → Adicionar Novo no administrador do WordPress
  2. Pesquise por ChatReact
  3. Clique em Instalar agora, depois em Ativar

Método 2: Envio via administrador do 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 3: Upload manual via FTP

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

Configuração

Após a ativação, abra o menu ChatReact na barra lateral do administrador do WordPress para configurações e instruções de uso.

Encontrando o ID do Seu Chatbot

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

Encontrando o ID do Seu Formulário

  1. Faça login em chatreact.ai
  2. Vá para Forms
  3. Clique em Copy embed code no seu formulário (ou abra o formulário e mude para a aba Embed)
  4. O seu Form ID é o valor de data-form-id no código de embed copiado

Opções de Uso

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 abertura automática, são gerenciadas centralmente no seu dashboard do ChatReact e se aplicam automaticamente ao seu site WordPress. O atributo language é opcional em todos os shortcodes — se você omiti-lo, a língua da página atual é detectada automaticamente (funciona em sites multilíngues).

2. Blocos Gutenberg

No editor de blocos:

  1. Clique em + 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 a sua página
  4. Configure no painel esquerdo

4. Atribuições de Widget (Configurações do Plugin)

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 administrador
  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 em Save Changes

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 o checkout.

Por padrão, apenas Páginas são pesquisáveis ao atribuir. Clique no botão Post Types para tornar outros tipos de conteúdo (por exemplo Posts ou tipos de post personalizados) pesquisáveis também.

5. Atribuição por Página

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 caso você queira ocultar o ChatReact totalmente em determinadas páginas.

Exemplos de Shortcode

Chat Widget Básico

[chatreact id="abc123"]

Chat Widget com Idioma Fixo

[chatreact id="abc123" language="de"]

FAQ com Filtro de Categoria

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

Formulário de Contato Estilizado

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

Widget de FAQ: SEO & Cache

FAQs Amigáveis para SEO

Desde a versão 1.1.2, os widgets de FAQ são renderizados no servidor: suas FAQs fazem parte do HTML da página e incluem dados estruturados JSON-LD (esquema FAQPage). Motores de busca e assistentes de IA podem lê-las sem executar qualquer JavaScript.

llms.txt para Crawlers de IA

O plugin pode servir seu conteúdo de FAQ em yoursite.com/llms.txt, um arquivo de descoberta lido por crawlers de IA. Ele está habilitado por padrão. Para alternar ou definir um Chatbot ID específico para o arquivo, vá para ChatReact → FAQ Widget → Cache & SEO Settings.

Cache de FAQ

Os dados de FAQ são armazenados em cache no seu servidor para carregamentos de página rápidos. Em ChatReact → FAQ Widget → Cache & SEO Settings você pode:

  • Definir a Cache Duration — 1, 3, 6 (recomendado), 12, ou 24 horas, ou desativar o cache
  • Clicar em Clear Cache para atualizar suas FAQs imediatamente

O cache também é limpo automaticamente sempre que suas FAQs são alteradas no dashboard do ChatReact.

Idiomas Suportados

O plugin suporta 24 idiomas da UE:

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

Desde a versão 1.2.0, traduções para todos os 24 idiomas estão inclusas no plugin. A língua do widget é detectada automaticamente pela página atual, portanto sites multilíngues funcionam imediatamente — use o atributo language do shortcode apenas se desejar forçar um idioma específico.

Solução de Problemas

Widget não aparece

  1. Verifique se o seu Chatbot ID está correto
  2. Verifique se o chatbot está ativo no seu dashboard do ChatReact
  3. Limpe qualquer plugin de cache de página (veja abaixo)
  4. Verifique o console do navegador por erros de 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 armazenem em cache os scripts do ChatReact.

Se você ainda enfrentar problemas (por exemplo, erros 404, widget não carregando para visitantes desconectados):

  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

FAQs não atualizando

Se o seu site mostra 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 do ChatReact.

Conflitos de Estilo

Se o widget parecer quebrado:

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

Múltiplos Widgets

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

Integração com CMS (Smart Sitemap)

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

Como Funciona

  1. Gere uma Integration Key no dashboard do 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. Ao rastrear seu site, o ChatReact usará automaticamente o smart sitemap em vez da descoberta por links tradicionais

Benefícios

  • Rastreamento mais rápido – Lista direta de URLs em vez de descoberta link-a-link
  • Consciência do tipo de conteúdo – O crawler sabe se uma URL é Page, Post ou Custom Post Type
  • Indexação por prioridade – Conteúdo importante (como Pages) pode ter peso maior que posts de blog
  • Compartilhamento seletivo – Compartilhe apenas os tipos de conteúdo que desejar
  • Exclusão por post – Exclua posts/páginas individuais do sitemap via caixa meta

Níveis de Prioridade

PriorityDefault forDescription
HighPagesConteúdo central do negócio (Sobre, Serviços, Contato)
MediumPostsArtigos de blog, atualizações de notícias
Low–Conteúdo suplementar

Segurança

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

Excluindo Posts Individuais

No editor do WordPress, cada post/página tem uma caixa meta ChatReact Widget com uma opção para "Exclude from ChatReact Sitemap". Posts marcados não aparecerão no smart sitemap.

Requisitos

  • WordPress 5.8 ou superior
  • PHP 7.4 ou superior
  • Uma conta ChatReact (sign up free)

Changelog

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 exibem mais um botão de filtro "All" desnecessário nem badges de categoria

1.1.2

  • NEW: Renderização no servidor para widgets de FAQ — FAQs são visíveis para motores de busca e LLMs sem JavaScript
  • NEW: Dados estruturados JSON-LD (esquema FAQPage) para SEO e resultados enriquecidos
  • 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 do ChatReact

1.1.1

  • FIX: Melhorias de tradução (Romeno, Holandês)

1.1.0

  • NEW: Smart Sitemap (CMS Integration) — compartilhamento estruturado de conteúdo com o crawler do 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 o 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 desconectados 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 a nível de página
  • CHANGED: As configurações do widget agora são gerenciadas centralmente no dashboard do ChatReact — removidos os atributos de shortcode position, primary_color, e auto_open (language ainda é suportado)

Próximos Passos

Anterior
Programa de Parceiros
Seguinte
Integração com Shopify