Widget Embedding
Añada su chatbot de IA a cualquier sitio web en segundos con nuestro sencillo código de inserción.
Inicio Rápido
Agregue este código antes del cierre de la etiqueta </body>:
<script
src="https://www.chatreact.ai/embed/widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
async
></script>
¡Eso es todo! Su chatbot ya está activo en su sitio web.
Encontrar el ID de su Chatbot
- Vaya a la configuración de su chatbot
- Navegue a la pestaña Integración
- Copie el código de inserción (incluye su ID)
El ID del chatbot en el código de inserción no es el mismo que el nombre en la URL del panel. Copie siempre el ID desde la pestaña Integración.
Personalización del Widget
La apariencia y el comportamiento del widget se configuran en su panel — no en el código de inserción. Vaya a Dashboard → Chatbots → [your chatbot] → Widget para ajustar:
- Posición — abajo a la derecha, abajo a la izquierda o inline
- Colores — colores principal, de fondo y de texto, además del radio del borde
- Tamaño — ancho y alto del widget
Para abrir el chat automáticamente después de un retraso configurable, habilite Apertura automática en la pestaña Comportamiento de la misma página de configuración. En los planes white-label, la marca de ChatReact está oculta por defecto — la misma pestaña Comportamiento tiene un interruptor Show "Powered by ChatReact" si desea mostrarla en el pie del widget igualmente.
Los cambios se aplican automáticamente a su sitio web — no es necesario actualizar el código de inserción. Vea la guía Widget Customization para todas las opciones disponibles.
El idioma del widget se detecta automáticamente desde el navegador de cada visitante, en función de los idiomas que habilite en la pestaña Idiomas de su chatbot.
Elija la posición Inline para incrustar el chat directamente en la página en el lugar donde se coloque la etiqueta de script. El widget siempre está abierto, sin burbuja ni botón de cierre — ideal para páginas dedicadas al chat o secciones de soporte.
Widget de FAQ
Muestre las FAQ como un acordeón en cualquier 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>
El widget de FAQ muestra las FAQ publicadas de su chatbot. Los colores y el estilo (color principal, de fondo y de texto, radio del borde) se configuran en Panel de control → FAQ → Configuración.
Opciones del Widget de FAQ
| Setting | Description | Where to Configure |
|---|---|---|
| Colors & Styling | Primary, background and text colors, border radius | Dashboard → FAQs → Settings |
| Ancho | Choose between 100% (full width) or a custom pixel width (400–1200px) | Dashboard → FAQs → Settings |
| FAQ Sort Order | Display order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop) | Dashboard → FAQs → Settings → Behavior |
| Filtro por categoría | Show only specific categories in the widget | Embed code data-categories attribute |
| Custom Container | Render the widget inside your own element instead of the default chatreact-faq div | Embed code data-container attribute |
| Idioma | Override the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language) | Embed code data-lang attribute |
| Accordion Behavior | Allow multiple FAQs open at once, or auto-expand the first FAQ | Dashboard → FAQs → Settings → Behavior |
Ejemplo de Filtro por Categoría
<script
src="https://www.chatreact.ai/embed/faq-widget.js"
data-chatbot-id="YOUR_CHATBOT_ID"
data-categories="shipping,returns"
async
></script>
Cuando el widget está filtrado por una sola categoría, el orden propio de esa categoría (configurado en Dashboard → FAQs → Categories) anula la configuración global de orden.
Optimización para Móviles
El widget de chat está totalmente optimizado para dispositivos móviles:
- Diseño de ancho completo en pantallas pequeñas
- Animación de deslizamiento al abrirse
- Manejo del teclado en iOS (el widget se ajusta al teclado en pantalla)
- Soporte de safe-area para la muesca y el indicador de inicio del iPhone
- Objetivos táctiles más grandes para mejor usabilidad
- El tamaño de fuente del campo de entrada evita el auto-zoom en iOS
Guías específicas por plataforma
WordPress
Recomendado: Use el oficial ChatReact WordPress Plugin para la integración más sencilla con bloques de Gutenberg, widgets de Elementor y shortcodes.
Alternativa: Inserción manual mediante un plugin de "Header/Footer Scripts":
- Instale cualquier plugin de "Header/Footer Scripts"
- Añada el código de inserción a la sección de footer
- Guarde y publique
Shopify
Recomendado: ChatReact Shopify App
Instale la app ChatReact desde la Shopify App Store para la integración más sencilla:
- Instale la app ChatReact en su administrador de Shopify
- Introduzca su Chatbot ID en la configuración de la app
- El widget de chat aparece automáticamente en su tienda
- Gestione las asignaciones del widget por página, o actívelo en todas partes
La app también soporta widgets de Form y FAQ como App Blocks en el Theme Editor.
Alternativa: Inserción Manual
- Vaya a Online Store → Themes → Edit Code
- Abra
theme.liquid - Añada el código antes de
</body> - Guarde
Webflow
- Vaya a Project Settings → Custom Code
- Agregue al Footer Code
- Publique el sitio
Next.js / React
Use el 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
Añádalo a su App.vue principal o 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 de JavaScript
Interactúe con el widget programáticamente:
// 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();
Pruebas
Modo de Vista Previa
Antes de insertar en vivo:
- Use la función Vista previa en su panel
- Pruebe diferentes escenarios
- Verifique que las respuestas sean precisas
¿Prueba en un sitio de desarrollo local? Use el código de inserción estándar sin cambios — también funciona en páginas localhost.
Resolución de Problemas
El Widget no Aparece
- Revise la consola del navegador en busca de errores
- Verifique que el ID del chatbot sea correcto
- Asegúrese de que el chatbot esté activo (no deshabilitado)
- Compruebe si los bloqueadores de anuncios interfieren
- Revise el uso de su plan — el widget se pausa cuando se alcanza el límite mensual de su plan
Plugins de Caché y Optimización
Algunos plugins de caché u optimización de scripts reescriben las URLs de los scripts, lo que puede impedir que el widget cargue. Si eso ocurre, agregue una URL de API explícita a la etiqueta 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>
El mismo atributo funciona en los scripts de los widgets de FAQ y formulario.
Conflictos de Estilo
Si el CSS de su sitio entra en conflicto:
- El widget aplica sus estilos al contenedor propio y usa reglas de alta prioridad para resistir conflictos
- Compruebe los valores de z-index de los elementos que se solapan con el widget
- Evite reglas
!importantdemasiado generales en el CSS de su sitio que apunten a elementos genéricos
Rendimiento
El widget está diseñado para tener un impacto mínimo:
- Carga de forma asíncrona — nunca bloquea el renderizado de la página
- Ligero: aproximadamente 30 KB transferidos comprimidos
Próximos Pasos
- Widget Customization →
- WordPress Plugin →
- Shopify Integration →
- FAQ Management →
- Smart Contact Forms → — inserte formularios independientes con el widget de formularios