Apps de Dashboard
Las apps de dashboard permiten integrar aplicaciones externas directamente en la interfaz de Zelta Chat. Estas aplicaciones se muestran como paneles embebidos (iframes) dentro de la vista de conversaciones, dando a los agentes acceso a información adicional sin cambiar de herramienta.
Cómo funcionan
Una app de dashboard se carga como un iframe dentro del panel lateral de la conversación o como una pestaña independiente en el dashboard. Zelta Chat pasa automáticamente el contexto de la conversación actual a la aplicación, permitiéndole mostrar información relevante.
Casos de uso
| Caso de uso | Descripción |
|---|---|
| Consulta de CRM | Mostrar el perfil del cliente, historial de compras y oportunidades abiertas desde tu CRM |
| Estado de pedidos | Consultar el estado de envío o entrega de un pedido directamente en la conversación |
| Base de conocimiento | Buscar artículos de ayuda relevantes para la consulta del cliente |
| Herramientas internas | Acceder a sistemas de ticketing, facturación o inventario sin salir de Zelta Chat |
| Panel de métricas | Mostrar KPIs personalizados del equipo o del cliente |
Crear una app de dashboard
- Ve a Ajustes > Integraciones > Apps de Dashboard.
- Haz clic en + Agregar app.
- Completa los campos de configuración:
| Campo | Descripción |
|---|---|
| Nombre | Nombre visible de la app en el dashboard |
| URL | Dirección de la aplicación web que se cargará en el iframe |
- Haz clic en Crear.
Contexto de la conversación
Cuando se carga la app, Zelta Chat envía automáticamente información del contexto actual a través de parámetros en la URL. Tu aplicación puede leer estos parámetros para mostrar datos relevantes.
Los parámetros disponibles incluyen:
| Parámetro | Descripción |
|---|---|
conversation_id | Identificador único de la conversación actual |
contact_id | Identificador del contacto asociado |
contact_email | Correo electrónico del contacto (si está disponible) |
contact_phone | Número de teléfono del contacto (si está disponible) |
contact_name | Nombre del contacto |
account_id | Identificador de tu cuenta de Zelta Chat |
inbox_id | Identificador del canal (bandeja de entrada) |
Ejemplo de URL con contexto
Si configuras la URL de tu app como:
https://miapp.ejemplo.com/clienteZelta Chat la cargará como:
https://miapp.ejemplo.com/cliente?conversation_id=456&contact_id=789&[email protected]&contact_name=Juan+PerezTu aplicación puede leer estos parámetros para buscar y mostrar la información del cliente correspondiente.
Desarrollar tu propia app
Para crear una aplicación compatible con el dashboard de Zelta Chat:
- Crea una aplicación web accesible por HTTPS que acepte ser cargada en un iframe.
- Lee los parámetros de URL que Zelta Chat envía al cargar la app.
- Muestra información contextual basada en los datos recibidos.
- Adapta el diseño para que se visualice correctamente en el espacio del panel lateral (ancho aproximado de 300-400 px).
Consejo
Diseña tu app con un layout responsivo que funcione bien en el espacio limitado del panel lateral. Evita elementos que requieran mucho ancho horizontal.
Configuración de seguridad
Encabezados de iframe
Tu aplicación debe permitir ser cargada dentro de un iframe. Verifica que los encabezados HTTP de tu servidor incluyan:
X-Frame-Options: Debe permitir el dominio de Zelta Chat, o no estar presente.Content-Security-Policy: Si usasframe-ancestors, incluyehttps://chat.zelta.dev.
HTTPS obligatorio
Las apps de dashboard deben servirse a través de HTTPS. Las URLs con HTTP simple no se cargarán por políticas de seguridad del navegador.
Gestionar apps de dashboard
Ver apps instaladas
Desde Ajustes > Integraciones > Apps de Dashboard puedes ver todas las apps configuradas.
Editar una app
- Haz clic en la app que deseas modificar.
- Actualiza el nombre o la URL.
- Haz clic en Actualizar.
Eliminar una app
- Haz clic en el ícono de eliminar junto a la app.
- Confirma la eliminación.
Importante
Las apps de dashboard tienen acceso al contexto de la conversación, incluyendo datos del contacto. Asegúrate de que las URLs configuradas pertenezcan a aplicaciones de confianza y cumplan con tus políticas de privacidad de datos.