Documentación

Modo burbuja

Botón flotante en la esquina inferior derecha — ideal para SaaS y dashboards sin ocupar espacio en el layout.

El modo burbuja muestra un botón redondeado fijo en la esquina inferior derecha. Al pulsarlo se abre el flow en un panel flotante; al cerrar, el botón vuelve a su etiqueta original.

Instalación

Burbuja flotante
<script
  src="https://getdilo.io/embed.js"
  data-flow="TU_FLOW_UUID"
  data-mode="bubble"
  data-label="¿Necesitas ayuda?"
  data-bubble-size="md"
  data-height="640px"
></script>

Coloca el script antes de </body>. El loader crea el botón y el iframe automáticamente.

Comportamiento

  1. Estado cerrado — solo la burbuja flotante (texto, emoji o imagen).
  2. Al abrir — panel encima de la burbuja; la burbuja se oculta y aparece una × discreta arriba a la derecha del panel.
  3. Cada apertura — el iframe recarga la URL con el contexto actual (útil si el tenant cambió en tu app).
  4. Altura — el flow ajusta la altura vía postMessage; máximo ~3200 px.

Personalización

AtributoEjemploEfecto
data-labelSoporte técnicoTexto del botón cerrado
data-bubble-sizesm / md / lgTamaño del botón
data-bubble-variantpill / circle / iconForma del botón
data-icon🤖Emoji o carácter en lugar de texto
data-icon-urlhttps://…/robot.pngImagen personalizada
data-color#2563EBColor principal del gradiente
data-color-end#1D4ED8Color secundario del gradiente
data-height720pxAltura inicial del panel (máx. ~85vh)
Burbuja con icono y colores de marca
<script
  src="https://getdilo.io/embed.js"
  data-flow="TU_FLOW_UUID"
  data-mode="bubble"
  data-bubble-size="sm"
  data-bubble-variant="icon"
  data-icon="🤖"
  data-color="#2563EB"
  data-color-end="#1D4ED8"
  data-height="600px"
></script>

En Configuración → Conexiones → Widget embebido puedes previsualizar tamaño, colores e icono antes de copiar el snippet.

Multi-tenant en runtime

Si el usuario puede cambiar de empresa sin recargar la página, actualiza el contexto al abrir la burbuja:

Contexto dinámico
// Cuando el usuario cambia de tenant o datos de contacto:
window.DiloEmbed?.setContext({
  externalId: currentTenant.externalId,
  contact: {
    name: currentUser.fullName,
    email: currentUser.email,
    phone: currentUser.phone,
  },
})

Ver la guía completa en Contexto y contacto.

Accesibilidad

  • El botón expone aria-expanded (true / false) según el panel esté abierto.
  • El iframe incluye title="Dilo Flow" para lectores de pantalla.

Vista previa en dashboard

En Configuración → Conexiones → Widget embebido elige Burbuja, configura el flow y usa la vista previa en vivo antes de copiar el snippet.