Integraciones
Akiles se integra con plataformas externas de dos formas:
- Integraciones de sincronización automatizan la creación de miembros y la gestión de acceso. Se conectan a sistemas de gestión de propiedades (PMS) o proveedores de identidad y mantienen los miembros de Akiles sincronizados con reservas o cuentas de usuario en el lado externo.
- Integraciones de notificación envían mensajes desde Akiles. Supervisan eventos y alertas dentro de Akiles y los entregan a la plataforma de chat que elijas (Discord, Slack, Telegram).
Una única integración es una integración de sincronización o una integración de notificación. Puedes tener cualquier número de integraciones de cualquiera de los dos tipos.
Integraciones de sincronización
Cuando una integración de sincronización está conectada, Akiles puede automáticamente:
- Crear y actualizar miembros basándose en reservas o cuentas de usuario en la plataforma externa.
- Asignar miembros a los grupos correctos basándose en los mapeos de recursos que configures.
- Establecer períodos de validez de acceso (fechas de inicio y fin) automáticamente.
- Provisionar métodos de acceso como códigos PIN y Magic Links.
- Eliminar el acceso cuando termina una reserva o un usuario se elimina de la plataforma externa.
Integraciones de sincronización disponibles:
- Guesty — Gestión de alquileres vacacionales y propiedades.
- Cloudbeds — Gestión de hoteles y propiedades de corta estancia.
- Nexudus — Gestión de espacios de coworking.
- Google Workspace — Sincroniza miembros desde el directorio de Google de tu organización.
- SCIM — Sincroniza miembros y grupos desde cualquier proveedor de identidad SCIM 2.0 (Okta, Azure AD, JumpCloud, etc.).
Cómo funcionan las integraciones de sincronización
Todas las integraciones de sincronización siguen el mismo flujo general:
- Conectar — Vincula tu cuenta externa a Akiles desde la página de configuración de la integración. Cada integración tiene su propio método de conexión (OAuth, instalación en marketplace o token de API).
- Mapear recursos — La integración importa recursos de la plataforma externa (listados, grupos, tarifas, etc.). Mapeas cada recurso a un grupo de miembros de Akiles para controlar a qué puertas pueden acceder los miembros.
- Sincronización automática — Akiles sincroniza periódicamente miembros desde la plataforma externa. Los miembros se crean, actualizan o eliminan automáticamente. Los webhooks proporcionan actualizaciones casi instantáneas cuando ocurren cambios en la plataforma externa.
Configuración común
Todas las integraciones comparten estas configuraciones:
- Habilitada — Cuando está deshabilitada, la integración deja de funcionar. Para integraciones de sincronización, se detiene la creación/actualización/eliminación de miembros; los miembros existentes permanecen y pueden seguir siendo utilizados. Para integraciones de notificación, se detiene la entrega de mensajes.
- Alcance de sincronización de miembros — (Solo integraciones de sincronización.) Elige si sincronizar todos los miembros, o solo aquellos válidos dentro de un cierto número de días a partir de ahora. Esto es útil para integraciones de PMS donde solo quieres sincronizar reservas próximas.
Estado de sincronización de miembros
Cada miembro de integración muestra un estado de sincronización:
- Sincronizado — El miembro fue creado o actualizado exitosamente en Akiles.
- Ninguno — El miembro no fue sincronizado. Esto puede ocurrir si ningún mapeo de recursos coincide, o si el miembro tiene una razón de omisión (por ejemplo, reserva no confirmada, usuario suspendido).
Puedes ver la razón de omisión para cada miembro en la lista de miembros de la integración para entender por qué un miembro no fue sincronizado.
Integraciones de notificación
Cuando una integración de notificación está conectada, Akiles puede enviar mensajes a una plataforma de chat externa siempre que ocurra algo — una puerta se abre, un administrador realiza un cambio, o una alerta de hardware se dispara.
Integraciones de notificación disponibles:
- Discord — Publica en un canal de Discord a través de webhook.
- Slack — Publica en un canal de Slack.
- Telegram — Envía mensajes a un chat o grupo de Telegram.
Todas las integraciones de notificación comparten el mismo conjunto de controles y reglas. Consulta Reglas de notificación para saber cómo controlar qué eventos se entregan.