Guías de instalación / HTML y sitios personalizados

Instala Embent en cualquier sitio HTML

Una etiqueta de script, sin build, sin framework. Si puedes editar tu HTML, terminas en menos de un minuto.

Antes de empezar

Acceso para editar los archivos HTML o las plantillas que sirve tu sitio.

Pasos

Copia tu código de inserción

En tu dashboard de Embent, abre la sección Overview de tu bot y copia el código de inserción. Se ve así:

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

Pégalo antes de la etiqueta de cierre </body>

Abre el archivo o la plantilla que renderiza cada página — en la mayoría de los sitios estáticos es un layout compartido o un include de footer — y pega el código justo antes de la etiqueta de cierre </body>.

Publica tus cambios

Sube o despliega el archivo editado de la forma en que normalmente publicas tu sitio.

Comprueba que funcionó

Recarga tu sitio: la burbuja de chat aparece en la esquina. Hazle una pregunta sobre tus propias páginas y debería responder con una cita.

Si no funciona

¿Lo intentaste y el widget no aparece? Esto soluciona casi todos los casos.

Añadí el código de inserción pero el widget no aparece — no hay burbuja de chat, ni botón, no se ve nada en mi sitioCuatro comprobaciones resuelven casi todos los casos de "el widget no aparece". Primero, abre tu sitio en vivo y mira el código fuente de la página (clic derecho → Ver código fuente de la página) y busca "embent" — si el script no está ahí, el código no se guardó en una página publicada. Segundo, asegúrate de que el ID data-bot de tu código coincida con el que aparece en tu dashboard, en Settings. Tercero, borra la caché de páginas de tu sitio y cualquier caché de CDN — una página en caché sigue sirviendo la versión antigua sin el widget. Cuarto, comprueba que el bot no esté pausado en el dashboard: un bot pausado deliberadamente no muestra nada a los visitantes.

La burbuja de chat aparece pero las respuestas nunca llegan, o el widget falta y mi sitio configura una Content-Security-PolicyAñade https://api.embent.com tanto a script-src (para cargar el script del widget) como a connect-src (el flujo de respuestas del chat se conecta al mismo origen). Un script-src sin esta entrada oculta el widget por completo; un connect-src sin ella muestra la burbuja pero ninguna respuesta llega a transmitirse.

Uso Cloudflare con Rocket Loader y el widget se ve intermitente o faltaRocket Loader retrasa los scripts a través de su propio cargador. El widget está diseñado para resistir eso, pero si no aparece, añade data-cfasync="false" a la etiqueta de script de Embent — la exclusión oficial de Rocket Loader — y el script se carga con normalidad.

Preguntas frecuentes

¿Funciona con React, Vue, Next.js u otros frameworks?Sí. Pega el código una vez en la plantilla HTML raíz — index.html o tu layout raíz. El widget se renderiza dentro de un Shadow DOM y no interfiere con tu framework; no hace falta ningún componente contenedor.

¿Ralentiza mi sitio?No. El script se carga de forma asíncrona (async) y el widget pesa menos de 50KB comprimido (gzip), sin depender de ningún framework propio, así que nunca bloquea la carga de tu página.

¿Necesito añadirlo en cada página?Solo en las plantillas compartidas entre páginas. Una página que se salta el layout compartido necesita el código añadido por separado.

Apunta Embent a tu sitio ahora.Un agente de IA que prefiere decir "no lo sé" antes que inventar algo. Plan Free, sin tarjeta — la mayoría de los sitios empiezan a responder en menos de dos minutos.

La burbuja de chat en la esquina es el propio Embent, funcionando en esta página — pregúntale lo que quieras sobre nosotros.

Empieza gratis o prueba la vista previa primero ↑