Web Widget
El Web Widget es el chat que se instala en tu sitio web. Se configura en la pestaña Canales → Widget de cada agente.
Instalación
- Ve al agente, entra a la pestaña Canales y luego a la sub-pestaña Widget.
- En la sección Código de Embed, haz clic en Copiar código.
- Pega el código en el HTML de tu sitio, antes del cierre de
</body>.
El código tiene esta forma (EMMIA lo genera automáticamente con el ID de tu agente; solo cópialo, no necesitas completar nada a mano):
<script src="https://emmia.io/widget.js"
data-agent-id="ID_DE_TU_AGENTE"
data-api-key="API_KEY"></script>Nota: cada agente tiene su propio código de embed — no reutilices el de un agente en el sitio de otro.
Personalización
Todo lo que ves en la Vista Previa de la pestaña Widget se edita ahí mismo.
General
- Nombre del Widget: el nombre que ve el cliente en el chat (puede ser distinto al nombre interno del agente).
- Avatar: imagen cuadrada (PNG, JPG, WEBP o GIF, máx. 2 MB). Si no subes una, se muestra la inicial del nombre.
- Placeholder: el texto de ejemplo dentro del campo de escritura.
- Posición: abajo a la derecha o abajo a la izquierda.
- Margen horizontal y Margen vertical: separación del widget respecto a los bordes de la pantalla, en píxeles.
Colores
Puedes definir por separado el color primario, secundario, texto general, texto del header, fondo, y los colores de fondo y texto de las burbujas de usuario y de bot.
Dimensiones
- Border Radius: qué tan redondeadas son las esquinas del panel de chat.
Burbuja (botón flotante)
El botón circular que abre el chat se personaliza aparte:
- Ícono: elige entre 8 íconos (chat, mensaje, soporte, bot, ayuda, corazón, rayo, estrella).
- Color de fondo y Color del ícono: si no defines uno propio, hereda el color primario (fondo) o blanco (ícono).
- Border Radius: independiente del panel de chat; puedes dejarlo cuadrado o redondo.
Branding y acciones rápidas
- Mostrar branding: activa o desactiva el sello de EMMIA en el widget.
- Acciones rápidas: botones con preguntas frecuentes que aparecen al abrir el chat cuando todavía no hay conversación (por ejemplo, "¿Cuáles son sus horarios?").
Privacidad y consentimiento
Para cumplir con la Ley 21.719, puedes pedir consentimiento al usuario antes de que empiece a chatear:
- Pedir consentimiento antes de chatear: si lo activas, el widget muestra un aviso que el usuario debe aceptar antes de escribir el primer mensaje.
- Texto de consentimiento: opcional; si lo dejas vacío, se usa un texto por defecto.
- URL de tu política de privacidad: opcional; si la dejas vacía, se enlaza a la política de privacidad de EMMIA.
Ver también Consentimiento en el widget.
Cuando termines de personalizar, haz clic en Guardar Configuración.