Tutoriales

Chatbot en React: agrega un chatbot con IA a tu app de React (Vite, CRA, SPA)

Agrega un chatbot con IA en React JS: un componente <Chatbot /> para copiar o un script. Funciona con Vite, CRA y React Router. Sin npm ni clave de IA.

Actualizado el 12 de noviembre de 2026 8 min de lectura

En resumen

Para agregar un chatbot en React JS, copia en tu app el pequeño componente <Chatbot /> de abajo: agrega el script de Nexoply una sola vez desde un useEffect y no renderiza nada por sí mismo. O pega el script de una línea en index.html, justo antes de </body>. En los dos casos el botón de chat aparece en todas las rutas, sin paquete npm que instalar ni clave de IA que gestionar: el asistente responde con la información del negocio que agregas en el panel.

  • Componente <Chatbot /> listo para copiar: un useEffect que agrega el script una vez. Funciona tal cual con TypeScript, es seguro con StrictMode y no necesita función de limpieza.
  • ¿No necesitas un componente? Una etiqueta script en index.html antes de </body> (Vite: index.html en la raíz del proyecto; Create React App: public/index.html).
  • Se monta en document.body dentro de un Shadow DOM, fuera de tu raíz de React, así que los nuevos renderizados, los cambios de ruta y tu CSS nunca le afectan.
  • Abre el chat desde tu propio botón con window.dispatchEvent(new Event("nexoply:open-chat")).
  • ¿Pruebas en localhost? Agrega tu host de desarrollo con su puerto a los sitios permitidos, o deja esa lista vacía.

Antes de empezar

Necesitas dos cosas antes de tocar el código:

  • Una cuenta de Nexoply y la clave de tu chatbot. Regístrate gratis (el plan Gratis incluye 50 conversaciones al mes, sin tarjeta) y abre Chatbot en el panel. El código de instalación de esa página ya trae tu clave. La clave es pública: no es un secreto y no da acceso a la cuenta, así que puede ir sin problema en el código del lado del cliente.
  • La información del negocio con la que responde el asistente: servicios y precios, preguntas frecuentes, políticas, horarios y zonas de servicio. Lo más rápido es escribir la dirección del sitio y dejar que Nexoply importe las páginas públicas, incluidas las generadas con JavaScript, así que también funciona con un sitio hecho en React. Si te registras con tu sitio web, agrega por sí solo servicios, preguntas frecuentes, horarios, políticas y páginas, sin sobrescribir lo que escribiste tú; un escaneo que inicies después desde el panel se te muestra para revisarlo primero.

Opción 1: Un componente de chatbot para React listo para copiar

Crea src/components/Chatbot.tsx. El componente no renderiza nada por sí mismo: agrega el script de Nexoply a la página una sola vez, y el widget dibuja el botón y la ventana de chat.

// src/components/Chatbot.tsx
import { useEffect } from "react";

type ChatbotProps = { chatbotKey: string };

export function Chatbot({ chatbotKey }: ChatbotProps) {
  useEffect(() => {
    // Sin clave, o el script ya está en la página: no hay nada que hacer.
    if (!chatbotKey || document.querySelector("script[data-chatbot]")) return;
    const s = document.createElement("script");
    s.src = "https://nexoply.com/widget.js";
    s.async = true;
    s.dataset.chatbot = chatbotKey;
    document.body.appendChild(s);
  }, [chatbotKey]);

  return null;
}

Renderízalo una sola vez, en el componente que sigue montado durante toda la visita (normalmente App). En Vite, pon VITE_NEXOPLY_KEY=YOUR-KEY en un archivo .env:

// src/App.tsx
import { Chatbot } from "./components/Chatbot";

export default function App() {
  return (
    <>
      {/* tu layout y tus rutas */}
      <Chatbot chatbotKey={import.meta.env.VITE_NEXOPLY_KEY} />
    </>
  );
}

El componente funciona tal cual en un proyecto TypeScript con Vite o Create React App. Para JavaScript, llama al archivo Chatbot.jsx y quita el tipo ChatbotProps. Create React App no tiene import.meta.env: pasa process.env.REACT_APP_NEXOPLY_KEY en su lugar. Como es un componente normal, también puedes renderizarlo de forma condicional, por ejemplo {hasConsent && <Chatbot chatbotKey={key} />}, para cargar el chat solo después de que el visitante acepte tu aviso de cookies.

  • Por qué no hay función de limpieza. El widget no tiene una API para quitarlo una vez cargado, y vive fuera de tu árbol de React, así que desmontar el componente no necesita deshacer nada.
  • Por qué StrictMode no es un problema. En desarrollo, React StrictMode ejecuta los efectos dos veces. La comprobación con querySelector omite la segunda ejecución, y aunque el script se agregara dos veces, el widget se monta una sola vez por clave de chatbot. Por la misma razón, la recarga en caliente también es segura.
  • Conserva el atributo. El widget lee su configuración de su propia etiqueta script, así que la etiqueta debe conservar el atributo data-chatbot y un src que contenga widget.js. Al asignar s.dataset.chatbot se crea ese atributo.

Opción 2: Una etiqueta script en index.html

Si no necesitas controlar la carga desde el código, sáltate el componente. Toda SPA de React tiene un archivo HTML base: en Vite es index.html en la raíz del proyecto; en Create React App es public/index.html. Pega el código justo antes de la etiqueta de cierre </body>:

<body>
  <div id="root"></div>
  <script type="module" src="/src/main.tsx"></script>

  <!-- Chatbot con IA de Nexoply -->
  <script src="https://nexoply.com/widget.js" data-chatbot="YOUR-KEY" async></script>
</body>

Reemplaza YOUR-KEY por la clave de la página Chatbot. El script carga de forma asíncrona, así que nunca bloquea el renderizado de tu app. Agrega data-open="true" a la etiqueta si quieres que la ventana de chat se abra al cargar. Eso es todo: compila, despliega y el botón aparecerá en todas las rutas.

Biblioteca de chatbot para React o chatbot con IA alojado

Al buscar un chatbot para React aparecen dos tipos de herramientas, y resuelven problemas distintos:

  • Una biblioteca de interfaz de chat te da componentes de React para el chat en sí: una lista de mensajes, un campo de texto, burbujas y, a veces, pasos de conversación predefinidos. Todo lo que hay detrás de la interfaz lo construyes tú: guiones fijos, o un backend que llama a un modelo de IA con tu propia clave de API, además del contenido con el que responde, el almacenamiento de conversaciones y la protección contra abusos. Es la opción adecuada cuando el chat forma parte de tu producto, por ejemplo un asistente que trabaja con los datos de tus usuarios.
  • Un chatbot con IA alojado como Nexoply incluye la interfaz, la IA y el backend. Responde las preguntas de los visitantes solo con la información del negocio que agregas o importas (servicios y precios, preguntas frecuentes, políticas, horarios) y lo dice cuando no sabe algo. No hay clave de IA ni código de servidor; las conversaciones, las preguntas sin respuesta y la protección contra spam se gestionan en el panel. Es la opción adecuada para un sitio web de cara al cliente que necesita responder preguntas sobre el negocio.

Si quieres control total sobre la interfaz y el modelo, empieza con una biblioteca. Si el objetivo es responder las preguntas de los visitantes sin construir ni mantener un backend, el widget alojado da menos trabajo. Mira cómo responde Nexoply con la información de tu negocio.

Cómo se comporta en una aplicación de una sola página (SPA)

  • Queda fuera de tu árbol de React. El widget se monta en document.body, fuera de tu elemento #root, así que los nuevos renderizados y los cambios de ruta nunca lo quitan ni alteran su estilo.
  • Shadow DOM en ambos sentidos. Tu CSS (Tailwind, CSS modules, resets globales) no se filtra al chat, y su CSS no se filtra a tu app.
  • Los cambios de ruta funcionan sin más. Con React Router o cualquier router basado en el historial, los visitantes conservan su conversación mientras navegan, y las reglas de página (como una pestaña lateral solo en /pricing) se vuelven a comprobar cuando cambia la URL. Sin código extra.
  • Sin cookies. Guarda un identificador anónimo del visitante en localStorage y la conversación actual en sessionStorage.

Abre el chat desde tu propio botón

¿Quieres un botón "Chatea con nosotros" en la sección principal de la portada o en la página de precios? Dispara el evento nexoply:open-chat en window:

export function ChatButton() {
  return (
    <button onClick={() => window.dispatchEvent(new Event("nexoply:open-chat"))}>
      Chatea con nosotros
    </button>
  );
}

No necesita ningún import: el widget escucha este evento en window. Si prefieres mostrar solo tu propio botón, configura el botón de mensaje como "Sin botón" con una regla de página en el panel.

Pruebas locales y solución de problemas

Antes de desplegar, revisa estos tres puntos:

  • Sitios permitidos. Si completaste Permitir solo en estos sitios web (panel → Chatbot), agrega tu host de desarrollo con su puerto, como localhost:5173 para Vite o localhost:3000 para Create React App, o deja la lista vacía mientras pruebas.
  • Content-Security-Policy. Si tu app envía una CSP en un encabezado o en una etiqueta meta, permite https://nexoply.com en script-src, connect-src e img-src.
  • Pruébalo de principio a fin. Ejecuta la app, haz clic en el botón de chat, haz una pregunta real y búscala en Conversaciones en el panel.

Si el botón sigue sin aparecer:

  • Clave vacía. El componente no carga nada sin clave. Muestra import.meta.env.VITE_NEXOPLY_KEY en la consola: Vite solo expone las variables que empiezan con VITE_, y tienes que reiniciar el servidor de desarrollo después de editar .env.
  • Solicitud bloqueada. Revisa la consola y la pestaña Red (Network) del navegador en busca de errores de CSP o de un widget.js bloqueado.
  • Chatbot apagado. Comprueba que el interruptor Chatbot activado esté encendido.
  • Bloqueadores de anuncios. En casos raros, una extensión del navegador bloquea los widgets de chat. Prueba en una ventana privada sin extensiones.

Próximos pasos: personalízalo sin volver a desplegar

Una vez instalado el script, no tendrás que volver a tocar el código: los cambios hechos en el panel llegan al sitio en aproximadamente un minuto. En Chatbot → Personalizar puedes darle estilo al botón de mensaje (icono o tu propia imagen o SVG, etiqueta de texto, forma, tamaño, colores, posición) o usar en su lugar una pestaña lateral en el borde de la pantalla. Define un aspecto distinto en celulares y usa reglas de página para cambiarlo en rutas concretas (por ejemplo /pricing o /services/*). La ventana de chat usa tus fuentes, colores y logo, y la pantalla de inicio puede ofrecer botones como Reservar, Llamar o WhatsApp.

¿Usas otro framework? Mira cómo agregar un chatbot a Next.js con next/script o la guía de chatbot para Vue y Nuxt; si tu web comercial está en WordPress, consulta la guía de WordPress. Para el panorama completo, lee cómo aprende el asistente sobre tu negocio o compara los planes y sus límites de conversaciones.

Preguntas frecuentes

¿Hay un componente simple de chatbot para React?

Sí: el componente <Chatbot /> de esta guía, menos de 20 líneas con un useEffect, que copias en tu propio proyecto. No hay un paquete npm oficial ni una biblioteca de componentes que instalar, y no los necesitas. El widget es siempre el script https://nexoply.com/widget.js con un atributo data-chatbot, y toda la configuración está en el panel.

¿Funciona con React Router y con la navegación de otras SPA?

Sí. El widget conserva la conversación mientras los visitantes navegan del lado del cliente y vuelve a comprobar las reglas de página cuando cambia la URL, sin código extra. Vive fuera de tu árbol de React, así que los cambios de ruta nunca lo quitan.

¿Necesito un backend o una clave de API de IA?

No. Nexoply se encarga de la IA y del backend, y nunca se envían claves de IA ni datos privados al navegador. El único valor en tu código es la clave del chatbot, que es pública y no da acceso a tu cuenta.

¿Ralentizará mi app?

No de forma apreciable. El script carga de forma asíncrona y nunca bloquea el renderizado, y funciona dentro de su propio Shadow DOM sin tocar tus componentes.

¿Funciona con Next.js?

Sí, con el componente next/script en tu layout raíz. Mira la guía de Next.js para los fragmentos del App Router y del Pages Router.

¿Cómo lo oculto en algunas rutas?

No hay una API para quitarlo una vez cargado. En su lugar, agrega una regla de página con "Sin botón" (panel → Chatbot → Personalizar → Botón de mensaje → Distinto en algunas páginas), o apaga el chatbot.

Deja que tu sitio web responda las preguntas por ti

Agrega la información de tu negocio, prueba tu asistente y ponlo en tu sitio web, todo con el plan gratuito.