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
- Vá para as configurações do seu chatbot
- Navegue até a aba Incorporar
- 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ção | Descrição | Onde Configurar |
|---|---|---|
| Cores & Estilo | Cores primária, de fundo e do texto, raio da borda | Dashboard → FAQs → Settings |
| Largura | Escolha entre 100% (largura total) ou uma largura personalizada em pixels (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Ordem de exibição: Data (mais recent e primeiro), Nome (alfabética) ou Custom (arrastar e soltar manualmente) | Dashboard → FAQs → Settings → Behavior |
| Filtro por categoria | Exibir apenas categorias específicas no widget | Atributo data-categories no código de incorporação |
| Contêiner Personalizado | Renderizar o widget dentro do seu próprio elemento em vez da div padrão chatreact-faq | Atributo data-container no código de incorporação |
| Idioma | Substituir 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ão | Permitir múltiplas FAQs abertas ao mesmo tempo, ou expandir automaticamente a primeira FAQ | Dashboard → 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":
- Instale qualquer plugin "Header/Footer Scripts"
- Adicione o código de incorporação na seção de footer
- Salve e publique
Shopify
Recomendado: ChatReact Shopify App
Instale o app ChatReact na Shopify App Store para a integração mais simples:
- Instale o app ChatReact no seu admin do Shopify
- Insira seu Chatbot ID nas configurações do app
- O widget de chat aparece automaticamente na sua vitrine
- 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
- Vá para Online Store → Themes → Edit Code
- Abra
theme.liquid - Adicione o código antes de
</body> - Salve
Webflow
- Vá para Project Settings → Custom Code
- Adicione no Footer Code
- 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:
- Use o recurso Visualizar no seu painel
- Teste diferentes cenários
- 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
- Verifique o console do navegador em busca de erros
- Confirme se o ID do chatbot está correto
- Certifique-se de que o chatbot está ativo (não desabilitado)
- Verifique se bloqueadores de anúncios não estão interferindo
- 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
!importantamplas 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
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — incorpore formulários independentes com o widget de formulário