Tutoriales

Chatbot en Vue: agrega un chatbot con IA a una app de Vue 3 o Nuxt

Agrega un chatbot con IA a Vue 3 o Nuxt: un componente Chatbot.vue listo para copiar, una etiqueta script en index.html o useHead. Sin npm ni clave de IA.

Actualizado el 1 de noviembre de 2026 8 min de lectura

En resumen

Nexoply es una etiqueta script, no un paquete npm. En una app de Vue 3, copia el pequeño componente Chatbot.vue de abajo, que agrega el script una sola vez en onMounted, y renderízalo en App.vue; o pega la etiqueta en index.html justo antes de </body>. En Nuxt 3, agrégala a app.head.script en nuxt.config.ts con tagPosition: "bodyClose", o con useHead en app.vue. Solo se ejecuta en el navegador, sobrevive a la navegación con Vue Router y mantiene sus estilos separados de los tuyos en un Shadow DOM.

  • Sin plugin ni paquete npm: el widget siempre es https://nexoply.com/widget.js con un atributo data-chatbot que lleva tu clave.
  • Vue 3 (Vite): un componente Chatbot.vue listo para copiar, con <script setup> y onMounted, o una etiqueta en index.html antes de </body>.
  • Nuxt 3: app.head.script en nuxt.config.ts, o useHead en app.vue. Es seguro con SSR porque solo se ejecuta en el navegador.
  • Cargarlo dos veces no causa problemas: se monta una sola vez por clave, así que ni la recarga en caliente ni los montajes repetidos crean un segundo botón.
  • Abre el chat desde tu propio botón con window.dispatchEvent(new Event("nexoply:open-chat")).

Antes de empezar

Necesitas una cuenta de Nexoply y la clave de tu chatbot. Regístrate gratis (el plan Gratis incluye 50 conversaciones al mes, sin tarjeta), agrega la información del negocio o impórtala desde su sitio web, y luego abre Chatbot en el panel y copia el código de instalación. Tiene este aspecto:

<script src="https://nexoply.com/widget.js" data-chatbot="YOUR-KEY" async></script>

El valor de data-chatbot es tu clave. Es pública, no un secreto: solo le indica al widget a qué negocio pertenece, así que puede ir sin problema en el código del lado del cliente y en tu repositorio. Mantén el nombre del atributo y un src que contenga widget.js tal como se muestra, porque el widget lee su configuración desde su propia etiqueta script.

Vue 3: un componente Chatbot.vue listo para copiar

Crea src/components/Chatbot.vue. El componente no renderiza nada por sí mismo: al montarse, 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.vue -->
<script setup lang="ts">
import { onMounted } from "vue";

const props = defineProps<{ chatbotKey: string }>();

onMounted(() => {
  // Sin clave, o el script ya está en la página: no hay nada que hacer.
  if (!props.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 = props.chatbotKey;
  document.body.appendChild(s);
});
</script>

<template><slot /></template>

Renderízalo una sola vez en App.vue, que sigue montado durante toda la visita. Pon la clave en .env como VITE_NEXOPLY_KEY=YOUR-KEY:

<!-- src/App.vue -->
<script setup lang="ts">
import Chatbot from "./components/Chatbot.vue";

const nexoplyKey = import.meta.env.VITE_NEXOPLY_KEY;
</script>

<template>
  <!-- tu layout y tus rutas -->
  <Chatbot :chatbot-key="nexoplyKey" />
</template>

En un proyecto JavaScript, quita lang="ts" y escribe defineProps({ chatbotKey: String }) en lugar del argumento de tipo. Como es un componente normal, también puedes renderizarlo con v-if, por ejemplo v-if="hasConsent", para cargar el chat solo después de que el visitante acepte tu aviso de consentimiento.

¿No necesitas un componente? Lo más simple es pegar la etiqueta en el index.html de la raíz del proyecto, justo antes de </body>. Carga de forma asíncrona y nunca bloquea el renderizado:

<body>
  <div id="app"></div>
  <script type="module" src="/src/main.ts"></script>
  <script src="https://nexoply.com/widget.js" data-chatbot="YOUR-KEY" async></script>
</body>

Nuxt 3: nuxt.config.ts o useHead

En Nuxt no necesitas un componente: agrega el script a todo el sitio en nuxt.config.ts. tagPosition: "bodyClose" lo coloca justo antes de </body>:

export default defineNuxtConfig({
  app: {
    head: {
      script: [
        {
          src: "https://nexoply.com/widget.js",
          async: true,
          "data-chatbot": "YOUR-KEY",
          tagPosition: "bodyClose",
        },
      ],
    },
  },
});

O agrégalo con useHead en app.vue. Si prefieres tener la clave en una variable de entorno, declara runtimeConfig: { public: { nexoplyKey: "" } } en nuxt.config.ts y define NUXT_PUBLIC_NEXOPLY_KEY; si no, escribe la clave directamente:

<script setup lang="ts">
useHead({
  script: [
    {
      src: "https://nexoply.com/widget.js",
      async: true,
      "data-chatbot": useRuntimeConfig().public.nexoplyKey,
      tagPosition: "bodyClose",
    },
  ],
});
</script>

El renderizado en el servidor no es problema: Nuxt incluye la etiqueta en el HTML y el widget solo se ejecuta en el navegador. No toca el marcado de tu app, así que no hay errores de hidratación.

Biblioteca de chatbot para Vue o chatbot con IA alojado

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

  • Una biblioteca de interfaz de chat te da componentes de Vue 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 app de Vue

  • Fuera de tu app. Se monta en document.body, fuera de #app (o de la raíz de Nuxt), así que los nuevos renderizados y los cambios de layout o de ruta nunca lo eliminan.
  • Navegación con Vue Router. La conversación sigue mientras los visitantes cambian de página del lado del cliente, y las reglas de página (como una pestaña lateral solo en /pricing) se vuelven a revisar cuando cambia la URL, sin código extra.
  • Shadow DOM. Tu CSS, las clases de Tailwind o tu biblioteca de componentes no afectan al chat, y sus estilos no afectan a tu app.
  • Ligero. Se carga de forma asíncrona, no usa cookies y solo guarda un identificador anónimo de visitante en localStorage y la conversación actual en sessionStorage.

Abre el chat desde tu propio botón

¿Quieres un botón "¿Dudas? Pregúntanos" en la sección principal de la portada o en la tabla de precios? Dispara el evento nexoply:open-chat desde un manejador de clic:

<script setup lang="ts">
function openChat() {
  window.dispatchEvent(new Event("nexoply:open-chat"));
}
</script>

<template>
  <button type="button" @click="openChat">Pregúntanos</button>
</template>

Para abrir el chat en cuanto carga la página, agrega data-open="true" a la etiqueta script (o "data-open": "true" en Nuxt).

Pruebas locales, sitios permitidos y solución de problemas

  • Sitios permitidos. Si completaste Permitir solo en estos sitios web en la página Chatbot, agrega también tu host de desarrollo con su puerto: localhost:5173 para Vite, localhost:3000 para Nuxt. O deja la lista vacía mientras pruebas.
  • Content-Security-Policy. Si tu app envía un encabezado CSP, permite https://nexoply.com en script-src, connect-src e img-src.
  • Pruébalo. Inicia el servidor de desarrollo, abre la app, haz una pregunta real y comprueba que la conversación aparece en Conversaciones en el panel.

Si el botón no aparece:

  • Revisa la etiqueta. En las herramientas de desarrollo del navegador, busca un script con el atributo data-chatbot y un src que contenga widget.js. Si no está, puede que la clave esté vacía: verifica que VITE_NEXOPLY_KEY o NUXT_PUBLIC_NEXOPLY_KEY estén definidas y reinicia el servidor de desarrollo después de editar .env.
  • Revisa la consola y la pestaña Red (Network). Un error de CSP significa que nexoply.com todavía no está permitido; una solicitud bloqueada también puede venir de un bloqueador de anuncios, así que prueba en una ventana privada sin extensiones.
  • Revisa el panel. Asegúrate de que el interruptor Chatbot activado esté encendido y de que tu dominio (o localhost con su puerto) esté en la lista de permitidos, si usas una.
  • ¿Oculto a propósito? Una regla de página con "Sin botón" lo oculta en las páginas que coinciden.

Próximos pasos: personalízalo sin tocar el código

Con la etiqueta instalada, todo lo demás se hace en el panel, y los cambios llegan al sitio en aproximadamente un minuto, sin volver a desplegar. En Chatbot → Personalizar puedes ajustar el botón de mensaje (icono o tu propia imagen, 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 cambiar u ocultar el botón en páginas concretas (por ejemplo /blog/*). Adapta la ventana de chat a la marca y agrega botones en la pantalla de inicio como Reservar, Llamar o WhatsApp.

Mira cómo aprende el asistente sobre tu negocio y todas las opciones de personalización, o compara los planes y sus límites de conversaciones. ¿Trabajas con otro framework? Mira la guía del componente de chatbot para React y cómo agregar un chatbot a Next.js con next/script.

Preguntas frecuentes

¿Hay un componente simple de chatbot para Vue?

Sí: el componente Chatbot.vue de esta guía, un bloque <script setup> con onMounted que copias en tu propio proyecto. No hay un plugin oficial de Vue ni un paquete npm que instalar, y no los necesitas. El widget es siempre el script https://nexoply.com/widget.js con tu clave en un atributo data-chatbot, y toda la configuración está en el panel.

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

Sí. Se monta fuera de tu app, mantiene la conversación mientras los visitantes navegan del lado del cliente y vuelve a revisar las reglas de página cuando cambia la URL, sin código extra.

¿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.

¿Funciona con el SSR de Nuxt?

Sí. Renderiza la etiqueta script normalmente con nuxt.config.ts o useHead. El widget solo se ejecuta en el navegador y no toca el marcado de Nuxt, así que no hay problemas de hidratación.

¿Puedo mostrarlo solo en algunas páginas?

Sí, con reglas de página: panel → Chatbot → Personalizar → Botón de mensaje → Distinto en algunas páginas. Elige "Sin botón" para las páginas donde debe ocultarse. No hay una API para quitar el widget una vez cargado, así que las reglas de página son la forma de hacerlo.

¿Puedo abrir el chat desde mi propio botón?

Sí. Llama a window.dispatchEvent(new Event("nexoply:open-chat")) desde cualquier manejador de clic.

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.