InícioDocumentação

Widget Embedding

Adicione seu chatbot de IA a qualquer site em segundos com nosso código de incorporação simples.

Início Rápido

Adicione este código antes da tag de fechamento </body>:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID" 
  async
></script>

Pronto! Seu chatbot já está ativo no seu site.

Encontrando o ID do Seu Chatbot

  1. Vá para as configurações do seu chatbot
  2. Navegue até a aba Incorporar
  3. Copie o código de incorporação (inclui seu ID)

O ID do chatbot no código de incorporação não é o mesmo que o nome na URL do seu painel. Sempre copie o ID da aba Incorporar.

Personalizando o Widget

A aparência e o comportamento do widget são configurados no seu painel — não no código de incorporação. Acesse Dashboard → Chatbots → [seu chatbot] → Widget para ajustar:

  • Position — canto inferior direito, canto inferior esquerdo ou inline
  • Colors — cores primária, de fundo e do texto, além do raio da borda
  • Tamanho — largura e altura do widget

Para abrir o chat automaticamente após um atraso configurável, ative Abrir automaticamente na aba Comportamento da mesma página de configurações. Em planos white-label, a marca ChatReact é ocultada por padrão — a mesma aba Comportamento possui um alternador Show "Powered by ChatReact" caso deseje exibi-la no rodapé do widget.

As alterações são aplicadas automaticamente ao seu site — não é necessário atualizar o código de incorporação. Veja o guia Widget Customization para todas as opções disponíveis.

O idioma do widget é detectado automaticamente a partir do navegador de cada visitante, com base nos idiomas que você habilita na aba Idiomas do seu chatbot.

Escolha a posição Inline para incorporar o chat diretamente na página no local onde a tag de script é colocada. O widget fica sempre aberto, sem bolha ou botão de fechar — ideal para páginas dedicadas de chat ou seções de suporte.

Widget de FAQ

Exiba FAQs como um acordeão em qualquer página:

<div id="chatreact-faq"></div>
<script 
  src="https://www.chatreact.ai/embed/faq-widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  async
></script>

O widget de FAQ mostra FAQs publicadas do seu chatbot. Cores e estilos (cores primária, de fundo e do texto, raio da borda) são configurados em Painel → FAQs → Configurações.

Opções do Widget de FAQ

ConfiguraçãoDescriçãoOnde Configurar
Cores & EstiloCores primária, de fundo e do texto, raio da bordaDashboard → FAQs → Settings
LarguraEscolha entre 100% (largura total) ou uma largura personalizada em pixels (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderOrdem de exibição: Data (mais recent e primeiro), Nome (alfabética) ou Custom (arrastar e soltar manualmente)Dashboard → FAQs → Settings → Behavior
Filtro por categoriaExibir apenas categorias específicas no widgetAtributo data-categories no código de incorporação
Contêiner PersonalizadoRenderizar o widget dentro do seu próprio elemento em vez da div padrão chatreact-faqAtributo data-container no código de incorporação
IdiomaSubstituir o idioma do widget (padrão para o atributo <html lang> da sua página, depois o idioma do navegador do visitante)Atributo data-lang no código de incorporação
Comportamento do AcordeãoPermitir múltiplas FAQs abertas ao mesmo tempo, ou expandir automaticamente a primeira FAQDashboard → FAQs → Settings → Behavior

Exemplo de Filtro por Categoria

<script
  src="https://www.chatreact.ai/embed/faq-widget.js"
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-categories="shipping,returns"
  async
></script>

Quando o widget é filtrado para uma única categoria, a ordem dessa categoria (definida em Dashboard → FAQs → Categories) substitui a configuração global de ordenação.

Otimização para Mobile

O widget de chat é totalmente otimizado para dispositivos móveis:

  • Layout em largura total em telas pequenas
  • Animação de deslize ao abrir
  • Tratamento do teclado no iOS (o widget ajusta-se ao teclado na tela)
  • Suporte a safe-area para notch e indicador inicial do iPhone
  • Alvos de toque maiores para melhor usabilidade
  • Tamanho da fonte do input evita o auto-zoom no iOS

Guias Específicos por Plataforma

WordPress

Recomendado: Use o ChatReact WordPress Plugin oficial para a integração mais fácil com blocos Gutenberg, widgets do Elementor e shortcodes.

Alternativa: Incorporação manual via plugin "Header/Footer Scripts":

  1. Instale qualquer plugin "Header/Footer Scripts"
  2. Adicione o código de incorporação na seção de footer
  3. Salve e publique

Shopify

Recomendado: ChatReact Shopify App

Instale o app ChatReact na Shopify App Store para a integração mais simples:

  1. Instale o app ChatReact no seu admin do Shopify
  2. Insira seu Chatbot ID nas configurações do app
  3. O widget de chat aparece automaticamente na sua vitrine
  4. Gerencie atribuições do widget por página, ou habilite-o em todo o site

O app também dá suporte a widgets de Form e FAQ como App Blocks no Theme Editor.

Alternativa: Incorporação Manual

  1. Vá para Online Store → Themes → Edit Code
  2. Abra theme.liquid
  3. Adicione o código antes de </body>
  4. Salve

Webflow

  1. Vá para Project Settings → Custom Code
  2. Adicione no Footer Code
  3. Publique o site

Next.js / React

Use o componente Script:

import Script from 'next/script';

export default function Layout({ children }) {
  return (
    <>
      {children}
      <Script 
        src="https://www.chatreact.ai/embed/widget.js"
        data-chatbot-id="YOUR_CHATBOT_ID"
        strategy="lazyOnload"
      />
    </>
  );
}

Vue.js

Adicione ao seu App.vue principal ou ao layout:

<script setup>
import { onMounted } from 'vue';

onMounted(() => {
  const script = document.createElement('script');
  script.src = 'https://www.chatreact.ai/embed/widget.js';
  script.dataset.chatbotId = 'YOUR_CHATBOT_ID';
  script.async = true;
  document.body.appendChild(script);
});
</script>

API JavaScript

Interaja programaticamente com o widget:

// Open the chat
ChatReact.open();

// Close the chat
ChatReact.close();

// Toggle open/closed
ChatReact.toggle();

// Start a fresh conversation
ChatReact.newChat();

// Remove the widget from the page entirely
// (useful in single-page apps, e.g. on route changes)
ChatReact.destroy();

Testes

Modo de Pré-visualização

Antes de incorporar ao vivo:

  1. Use o recurso Visualizar no seu painel
  2. Teste diferentes cenários
  3. Verifique se as respostas estão corretas

Testando em um site de desenvolvimento local? Use o código de incorporação padrão sem alterações — ele também funciona em páginas localhost.

Solução de Problemas

Widget Não Aparece

  1. Verifique o console do navegador em busca de erros
  2. Confirme se o ID do chatbot está correto
  3. Certifique-se de que o chatbot está ativo (não desabilitado)
  4. Verifique se bloqueadores de anúncios não estão interferindo
  5. Verifique o uso do seu plano — o widget é pausado quando o limite mensal do plano é atingido

Plugins de Cache & Otimização

Alguns plugins de cache ou de otimização de scripts reescrevem URLs de script, o que pode impedir o carregamento do widget. Se isso ocorrer, adicione uma URL de API explícita à tag de script:

<script 
  src="https://www.chatreact.ai/embed/widget.js" 
  data-chatbot-id="YOUR_CHATBOT_ID"
  data-api-url="https://www.chatreact.ai"
  async
></script>

O mesmo atributo funciona nos scripts dos widgets de FAQ e formulário.

Conflitos de Estilo

Se o CSS do seu site conflitar:

  • O widget isola seus estilos no próprio contêiner e usa regras de alta prioridade para resistir a conflitos
  • Verifique os valores de z-index dos elementos que se sobrepõem ao widget
  • Evite regras !important amplas no CSS do seu site que atinjam elementos genéricos

Performance

O widget é projetado para impacto mínimo:

  • Carrega de forma assíncrona — nunca bloqueia a renderização da página
  • Leve: aproximadamente 30 KB em transferência comprimida

Próximos Passos