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 uno o más grupos de miembros de Akiles para controlar a qué puertas pueden acceder los miembros. Consulta Mapeos de recursos más abajo.
- 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.
Mapeos de recursos
Un mapeo conecta un recurso con un grupo de miembros de Akiles. Es lo que convierte una reserva o una cuenta de usuario en acceso a puertas reales. Un recurso sin mapeo no da acceso, y sus miembros no se sincronizan.
Puedes mapear un recurso a más de un grupo. Los miembros de ese recurso reciben acceso a todos los grupos de la lista. Por ejemplo, un apartamento puede mapearse al grupo “Apartamento 101” y también a un grupo compartido “Portal”.
Modificadores de hora
Cada mapeo tiene dos modificadores de hora opcionales, uno para el inicio del período de acceso y otro para el fin:
- Desplazamiento — Suma tiempo. Usa un valor negativo para mover la hora antes.
- Fijar hora — Sustituye la hora del día y mantiene el mismo día.
Si pones los dos, primero se aplica la hora fijada y después el desplazamiento.
Un modificador solo cambia el grupo al que pertenece. Los demás grupos del mismo recurso mantienen el período original. Así es como das al huésped la puerta del apartamento exactamente durante la reserva, y la puerta del portal durante un período más largo:
| Lo que quieres | Cómo configurarlo |
|---|---|
| Acceso al portal desde 1 hora antes del check-in hasta 1 hora después del check-out | Desplazamiento de inicio -60 minutos, desplazamiento de fin +60 minutos |
| Acceso al portal hasta las 21:00 del día del check-out | Fijar la hora de fin a 21:00 |
El período de validez del propio miembro crece para incluir los períodos modificados. Si el portal termina 1 hora después del check-out, el miembro sigue siendo válido durante esa hora.
Un modificador no hace nada cuando ese extremo del período no tiene fecha. Los miembros de Google Workspace y SCIM no tienen fecha de inicio ni de fin, así que los modificadores de hora no les afectan.
Qué hora local usa “fijar hora”
Una hora fijada es una hora local, no UTC. Akiles busca la zona horaria en este orden, y usa la primera que encuentra:
- La zona horaria que la plataforma externa indica para la propiedad (los listados de Guesty, las propiedades de Cloudbeds y los alojamientos de Avantio indican una).
- La zona horaria del espacio del grupo de miembros.
- La zona horaria del primer espacio de tu organización.
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.