InicioDocumentación

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

  1. Vaya a la configuración de su chatbot
  2. Navegue a la pestaña Integración
  3. 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

SettingDescriptionWhere to Configure
Colors & StylingPrimary, background and text colors, border radiusDashboard → FAQs → Settings
AnchoChoose between 100% (full width) or a custom pixel width (400–1200px)Dashboard → FAQs → Settings
FAQ Sort OrderDisplay order: Date (newest first), Name (alphabetical), or Custom (manual drag & drop)Dashboard → FAQs → Settings → Behavior
Filtro por categoríaShow only specific categories in the widgetEmbed code data-categories attribute
Custom ContainerRender the widget inside your own element instead of the default chatreact-faq divEmbed code data-container attribute
IdiomaOverride the widget language (defaults to your page's <html lang> attribute, then the visitor's browser language)Embed code data-lang attribute
Accordion BehaviorAllow multiple FAQs open at once, or auto-expand the first FAQDashboard → 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":

  1. Instale cualquier plugin de "Header/Footer Scripts"
  2. Añada el código de inserción a la sección de footer
  3. Guarde y publique

Shopify

Recomendado: ChatReact Shopify App

Instale la app ChatReact desde la Shopify App Store para la integración más sencilla:

  1. Instale la app ChatReact en su administrador de Shopify
  2. Introduzca su Chatbot ID en la configuración de la app
  3. El widget de chat aparece automáticamente en su tienda
  4. 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

  1. Vaya a Online Store → Themes → Edit Code
  2. Abra theme.liquid
  3. Añada el código antes de </body>
  4. Guarde

Webflow

  1. Vaya a Project Settings → Custom Code
  2. Agregue al Footer Code
  3. 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:

  1. Use la función Vista previa en su panel
  2. Pruebe diferentes escenarios
  3. 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

  1. Revise la consola del navegador en busca de errores
  2. Verifique que el ID del chatbot sea correcto
  3. Asegúrese de que el chatbot esté activo (no deshabilitado)
  4. Compruebe si los bloqueadores de anuncios interfieren
  5. 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 !important demasiado 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