embent

Guias de instalação / HTML e sites personalizados

Instale o Embent em qualquer site HTML

Um trecho de script, sem etapa de build, sem framework. Se você consegue editar seu HTML, termina em menos de um minuto.

Antes de começar

  • Acesso para editar os arquivos ou templates HTML que seu site serve.

Passos

1

Copie seu trecho de incorporação

No seu painel do Embent, abra a Visão geral do seu bot e copie o trecho de incorporação. Ele se parece com isto:

<script src="https://api.embent.com/widget.js" data-bot="YOUR_BOT_ID" async></script>
2

Cole antes da tag de fechamento </body>

Abra o arquivo ou template que renderiza todas as páginas — na maioria dos sites estáticos isso é um layout compartilhado ou um include de rodapé — e cole o trecho logo antes da tag de fechamento </body>.

3

Publique suas mudanças

Envie ou publique o arquivo editado da forma como você normalmente publica seu site.

Confira se funcionou

Recarregue seu site: o balão de chat aparece no canto. Faça uma pergunta sobre suas próprias páginas e ele deve responder com uma citação.

Se não funcionar

Tentou e o widget não está aparecendo? Isso resolve quase todos os casos.

Adicionei o código de incorporação, mas o widget não aparece — nenhum balão de chat, nenhum lançador, nada aparece no meu siteQuatro verificações resolvem quase todos os casos de "widget não aparece". Primeiro, abra seu site ao vivo e veja o código-fonte da página (clique com o botão direito → Ver código-fonte da página) e procure por "embent" — se o script não estiver lá, o código não foi salvo em uma página publicada. Segundo, confira se o ID data-bot no seu trecho de código corresponde ao mostrado no seu painel em Configurações. Terceiro, limpe o cache de página do seu site e qualquer cache de CDN — uma página em cache continua servindo a versão antiga sem o widget. Quarto, confira se o bot não está pausado no painel: um bot pausado propositalmente não mostra nada aos visitantes.
O balão de chat aparece mas as respostas nunca chegam, ou o widget está ausente e meu site define uma Content-Security-PolicyAdicione https://api.embent.com tanto em script-src (carrega o script do widget) quanto em connect-src (o streaming de respostas do chat conecta de volta à mesma origem). Uma entrada faltando em script-src esconde o widget inteiro; uma entrada faltando em connect-src mostra o balão mas nenhuma resposta chega a aparecer.
Eu uso o Cloudflare com Rocket Loader e o widget fica instável ou ausenteO Rocket Loader adia scripts pelo próprio carregador dele. O widget foi feito para sobreviver a isso, mas se ele falhar em aparecer, adicione data-cfasync="false" à tag de script do Embent — a opção oficial de exclusão do Rocket Loader — e o script carrega normalmente.

Perguntas frequentes

Funciona com React, Vue, Next.js ou outros frameworks?Sim. Cole o trecho uma vez no template HTML raiz — index.html ou seu layout raiz. O widget renderiza dentro de uma Shadow DOM e fica fora do caminho do seu framework; não precisa de nenhum componente wrapper.
Isso vai deixar meu site mais lento?Não. O script carrega de forma assíncrona e o widget fica abaixo de 50KB compactado, sem framework próprio, então nunca bloqueia a renderização da sua página.
Preciso adicionar em todas as páginas?Só nos templates compartilhados entre páginas. Uma página que não usa o layout compartilhado precisa do trecho adicionado separadamente.
Aponte o Embent para o seu site agora.Um agente de IA que prefere dizer "não sei" a inventar uma resposta. Plano Free, sem cartão — a maioria dos sites já está respondendo em dois minutos.

O balão de chat no canto é o próprio Embent, rodando nesta página — pergunte qualquer coisa sobre nós.