Tutoriais

Chatbot em Vue: adicione um chatbot com IA a um app Vue 3 ou Nuxt

Adicione um chatbot com IA ao Vue 3 ou Nuxt: componente Chatbot.vue pronto para copiar, uma tag script no index.html ou useHead. Sem npm nem chave de IA.

Atualizado em 1 de novembro de 2026 7 min de leitura

Em resumo

O Nexoply é uma tag script, não um pacote npm. Em um app Vue 3, copie o pequeno componente Chatbot.vue abaixo, que adiciona o script uma única vez no onMounted, e renderize-o no App.vue; ou cole a tag no index.html logo antes de </body>. No Nuxt 3, adicione em app.head.script no nuxt.config.ts com tagPosition: "bodyClose", ou com useHead no app.vue. O widget só roda no navegador, continua funcionando na navegação com Vue Router e mantém os estilos separados dos seus em um Shadow DOM.

  • Sem plugin nem pacote npm: o widget é sempre https://nexoply.com/widget.js com um atributo data-chatbot com sua chave.
  • Vue 3 (Vite): um componente Chatbot.vue pronto para copiar, com <script setup> e onMounted, ou uma tag no index.html antes de </body>.
  • Nuxt 3: app.head.script no nuxt.config.ts, ou useHead no app.vue. É seguro com SSR porque só roda no navegador.
  • Carregá-lo duas vezes não causa problema: ele é montado uma única vez por chave, então hot reload e montagens repetidas não criam um segundo botão.
  • Abra o chat pelo seu próprio botão com window.dispatchEvent(new Event("nexoply:open-chat")).

Antes de começar

Você precisa de uma conta no Nexoply e da chave do seu chatbot. Cadastre-se grátis (o plano Grátis inclui 50 conversas por mês, sem cartão), adicione as informações do negócio ou importe-as do site, depois abra Chatbot no painel e copie o código de instalação. Ele é assim:

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

O valor de data-chatbot é sua chave. Ela é pública, não um segredo: só diz ao widget a qual negócio ele pertence, então pode ficar no código que roda no navegador e no seu repositório. Mantenha o nome do atributo e um src que contenha widget.js exatamente como mostrado, porque o widget lê as configurações da própria tag script.

Vue 3: um componente Chatbot.vue pronto para copiar

Crie src/components/Chatbot.vue. O componente não renderiza nada sozinho: ao ser montado, ele adiciona o script do Nexoply à página uma única vez, e o widget desenha o botão e a janela de chat.

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

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

onMounted(() => {
  // No key, or the script is already on the page: nothing to do.
  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>

Renderize-o uma única vez no App.vue, que fica montado durante toda a visita. Coloque a chave no .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>
  <!-- your layout and routes -->
  <Chatbot :chatbot-key="nexoplyKey" />
</template>

Em um projeto JavaScript, tire o lang="ts" e escreva defineProps({ chatbotKey: String }) no lugar do argumento de tipo. Como é um componente comum, você também pode renderizá-lo com v-if, por exemplo v-if="hasConsent", para carregar o chat só depois que o visitante aceitar seu aviso de consentimento.

Não precisa de componente? O jeito mais simples é colar a tag no index.html da raiz do projeto, logo antes de </body>. Ela carrega de forma assíncrona e nunca bloqueia a renderização:

<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 ou useHead

No Nuxt você não precisa de um componente: adicione o script ao site inteiro no nuxt.config.ts. tagPosition: "bodyClose" coloca a tag logo antes de </body>:

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

Ou adicione com useHead no app.vue. Se preferir manter a chave em uma variável de ambiente, declare runtimeConfig: { public: { nexoplyKey: "" } } no nuxt.config.ts e defina NUXT_PUBLIC_NEXOPLY_KEY; caso contrário, escreva a chave diretamente:

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

A renderização no servidor não é problema: o Nuxt coloca a tag no HTML e o widget só roda no navegador. Ele não mexe na marcação do seu app, então não há erros de hidratação.

Biblioteca de chatbot para Vue ou chatbot com IA hospedado

Quem procura um chatbot para Vue encontra dois tipos de ferramenta, e elas resolvem problemas diferentes:

  • Uma biblioteca de interface de chat oferece componentes Vue para o chat em si: lista de mensagens, campo de texto, balões e, às vezes, etapas de conversa predefinidas. Tudo o que fica por trás da interface é com você: roteiros fixos, ou um backend que chama um modelo de IA com a sua própria chave de API, além do conteúdo usado nas respostas, do armazenamento das conversas e da proteção contra abusos. Faz sentido quando o chat é parte do seu produto, por exemplo um assistente que trabalha com os dados dos seus usuários.
  • Um chatbot com IA hospedado como o Nexoply já traz a interface, a IA e o backend. Ele responde às perguntas dos visitantes só com as informações do negócio que você adiciona ou importa (serviços e preços, perguntas frequentes, políticas, horários) e avisa quando não sabe. Não há chave de IA nem código de servidor; as conversas, as perguntas sem resposta e a proteção contra spam ficam no painel. Faz sentido para um site voltado a clientes que precisa responder perguntas sobre o negócio.

Se você quer controle total sobre a interface e o modelo, comece com uma biblioteca. Se o objetivo é responder às perguntas dos visitantes sem construir nem manter um backend, o widget hospedado dá menos trabalho. Veja como o Nexoply responde com as informações do seu negócio.

Como ele se comporta em um app Vue

  • Fora do seu app. Ele é montado no document.body, fora do #app (ou da raiz do Nuxt), então re-renderizações, mudanças de layout e de rota nunca o removem.
  • Navegação com Vue Router. A conversa continua enquanto os visitantes trocam de página no lado do cliente, e as regras de página (como uma aba lateral só em /pricing) são verificadas de novo quando a URL muda, sem código extra.
  • Shadow DOM. Seu CSS, as classes do Tailwind ou sua biblioteca de componentes não afetam o chat, e os estilos dele não afetam seu app.
  • Leve. Carrega de forma assíncrona, não usa cookies e só guarda um identificador anônimo de visitante no localStorage e a conversa atual no sessionStorage.

Abra o chat pelo seu próprio botão

Quer um botão "Dúvidas? Pergunte para a gente" no topo da página inicial ou na tabela de preços? Dispare o evento nexoply:open-chat em um handler de clique:

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

<template>
  <button type="button" @click="openChat">Ask us a question</button>
</template>

Para abrir o chat assim que a página carregar, adicione data-open="true" à tag script (ou "data-open": "true" no Nuxt).

Testes locais, sites permitidos e solução de problemas

  • Sites permitidos. Se você preencheu Permitir apenas nestes sites na página Chatbot, adicione também seu host de desenvolvimento com a porta: localhost:5173 para Vite, localhost:3000 para Nuxt. Ou deixe a lista vazia enquanto testa.
  • Content-Security-Policy. Se seu app envia um cabeçalho CSP, permita https://nexoply.com em script-src, connect-src e img-src.
  • Teste. Inicie o servidor de desenvolvimento, abra o app, faça uma pergunta real e confira se a conversa aparece em Conversas no painel.

Se o botão não aparecer:

  • Confira a tag. Nas ferramentas de desenvolvedor do navegador, procure um script com o atributo data-chatbot e um src que contenha widget.js. Se não estiver lá, a chave pode estar vazia: confira se VITE_NEXOPLY_KEY ou NUXT_PUBLIC_NEXOPLY_KEY estão definidas e reinicie o servidor de desenvolvimento depois de editar o .env.
  • Confira o console e a aba de rede. Um erro de CSP significa que nexoply.com ainda não está permitido; uma requisição bloqueada também pode vir de um bloqueador de anúncios, então teste em uma janela anônima sem extensões.
  • Confira o painel. Verifique se a chave Chatbot ativado está ligada e se seu domínio (ou localhost com a porta) está na lista de permitidos, se você usa uma.
  • Escondido de propósito? Uma regra de página com "Sem botão" o esconde nas páginas correspondentes.

Próximos passos: personalize sem mexer no código

Com a tag instalada, todo o resto é feito no painel, e as alterações chegam ao site em cerca de um minuto, sem novo deploy. Em Chatbot → Personalizar você ajusta o botão de mensagem (ícone ou imagem própria, texto, formato, tamanho, cores, posição) ou usa uma aba lateral na borda da tela. Defina um visual diferente no celular e use regras de página para mudar ou esconder o botão em páginas específicas (por exemplo /blog/*). Adapte a janela de chat à marca e adicione botões na tela inicial como Agendar, Ligar ou WhatsApp.

Veja como o assistente aprende sobre seu negócio e todas as opções de personalização, ou compare os planos e os limites de conversas. Trabalha com outro framework? Veja o guia do componente de chatbot para React e como adicionar um chatbot ao Next.js com next/script.

Perguntas frequentes

Existe um componente simples de chatbot para Vue?

Sim: o componente Chatbot.vue deste guia, um bloco <script setup> com onMounted que você copia para seu próprio projeto. Não há plugin oficial do Vue nem pacote npm para instalar, e você não precisa deles. O widget é sempre o script https://nexoply.com/widget.js com sua chave em um atributo data-chatbot, e todas as configurações ficam no painel.

Funciona com o Vue Router e outras navegações de SPA?

Sim. Ele é montado fora do seu app, mantém a conversa enquanto os visitantes navegam no lado do cliente e verifica de novo as regras de página quando a URL muda, sem código extra.

Preciso de um backend ou de uma chave de API de IA?

Não. O Nexoply cuida da IA e do backend, e nenhuma chave de IA ou dado privado é enviado ao navegador. O único valor no seu código é a chave do chatbot, que é pública e não dá acesso à sua conta.

Funciona com o SSR do Nuxt?

Sim. Renderize a tag script normalmente com o nuxt.config.ts ou useHead. O widget só roda no navegador e não mexe na marcação do Nuxt, então não há problemas de hidratação.

Posso mostrar o chat só em algumas páginas?

Sim, com regras de página: painel → Chatbot → Personalizar → Botão de mensagem → Diferente em algumas páginas. Escolha "Sem botão" nas páginas em que ele deve ficar escondido. Não há API para remover o widget depois de carregado, então as regras de página são o caminho.

Posso abrir o chat pelo meu próprio botão?

Sim. Chame window.dispatchEvent(new Event("nexoply:open-chat")) em qualquer handler de clique.

Deixe o seu site responder às perguntas por você

Adicione as informações do seu negócio, teste o seu assistente e coloque-o no seu site. Tudo isso no plano Grátis.