Widgets e instalacion
Las superficies, la etiqueta de script, los dominios permitidos y que revisar si no aparece.
Actualizado 2026-09-05Elegir la superficie
- Chat flotante. Una burbuja en la esquina. Lo normal para una web de marketing.
- Chat embebido. Se dibuja dentro del elemento que elijas, para una pagina de ayuda.
- Asistente de documentacion. Una caja tipo buscador para documentacion.
- Pagina alojada. Una pagina completa en tu propia direccion, cuando no tienes donde embeber.
Instalar
Copia la etiqueta de script desde la pestana Instalar del widget y pegala justo antes del cierre del body.
<script src="https://cdn.welcomeai.dev/widget/v1.js" data-wai-key="wg_xxxxxxxxxxxx" defer></script>No hace falta nada mas. El widget carga de forma asincrona y no bloquea tu pagina.
Dominios permitidos
Un widget solo responde en los dominios que listes. Anade todos, incluido el de pruebas. *.example.com cubre los subdominios. Una peticion desde cualquier otro sitio se rechaza, y eso es lo que impide que alguien se lleve tu clave y monte tu asistente en su web.
No aparece nada
Revisa en este orden:
- Esta publicado el widget? Un widget en borrador no carga.
- Esta permitido el dominio? La consola del navegador muestra el rechazo con el origen que vimos.
- Esta el script en la pagina? Mira el codigo fuente y busca
data-wai-key. - Lo bloquea algo? Una politica de seguridad estricta necesita permitir
cdn.welcomeai.dev.
La pagina del widget muestra los dominios donde se ha visto y cuando, que suele resolver la duda mas rapido que la consola.