Integración con Acuity Scheduling
HiLucy se integra con Acuity Scheduling para permitirte ofrecer servicios y experiencias basadas en horarios que los huéspedes pueden reservar directamente. Ya sea tratamientos de spa, tours guiados, reservas de restaurante o excursiones privadas, Acuity gestiona la programación mientras HiLucy se encarga de la experiencia del huésped.
Cómo Funciona
La integración sincroniza los datos de tu cuenta de Acuity en la base de datos de HiLucy, haciendo que tus servicios estén disponibles a través del Portal del Huésped y LucyAI:
- Tú configuras tipos de citas, calendarios y productos en Acuity Scheduling
- HiLucy sincroniza esos datos en tablas locales de la base de datos para una recuperación rápida
- Los huéspedes descubren actividades a través de la pestaña Explorar o preguntando a LucyAI
- LucyAI puede buscar y reservar actividades en nombre de los huéspedes durante la conversación
Configuración de la Integración
1. Obtén tus Credenciales de Acuity
En tu cuenta de Acuity Scheduling, navega a Integraciones > API y anota tu:
- User ID -- tu identificador de cuenta de Acuity
- API Key -- la clave secreta para la autenticación de la API
Cada propiedad (listado) en HiLucy puede tener sus propias credenciales de Acuity, permitiendo que diferentes propiedades ofrezcan diferentes catálogos de actividades.
2. Configura en HiLucy
Desde el administrador de WordPress, edita tu listado y localiza el metabox de Acuity Integration:
- Activar Acuity -- activa la integración para este listado
- User ID -- ingresa tu User ID de Acuity
- API Key -- ingresa tu API Key de Acuity
Guarda el listado para almacenar las credenciales.
3. Sincroniza tus Datos
Haz clic en el botón Sync Now en el metabox de Acuity Integration. HiLucy obtendrá datos de la API de Acuity y llenará tres tablas locales:
- Appointment Types -- tus servicios (ej., "Masaje de 60 Minutos", "Tour al Atardecer")
- Calendars -- tus calendarios de disponibilidad (ej., "Calendario Spa", "Calendario Tours")
- Products -- paquetes adicionales y extras vinculados a los tipos de citas
La sincronización normalmente se completa en unos segundos. Puedes volver a sincronizar en cualquier momento para obtener los cambios realizados en Acuity.
4. Configuración de Webhooks
HiLucy proporciona un endpoint de webhook en /hilucy/v1/acuity-webhook para actualizaciones en tiempo real. Configura esta URL en tu cuenta de Acuity en Integraciones > Webhooks para recibir notificaciones instantáneas cuando se reserven, reprogramen o cancelen citas.
Flujo de Reserva del Huésped
Una vez sincronizadas, las actividades aparecen en la pestaña Explorar del Portal del Huésped. El proceso de reserva funciona así:
- El huésped navega las actividades disponibles o pregunta a LucyAI "¿Qué puedo hacer hoy?"
- Lucy busca en tus tipos de citas sincronizados y presenta opciones coincidentes con disponibilidad
- El huésped selecciona un horario y confirma la reserva
- Acuity crea la cita y envía confirmación tanto al huésped como al proveedor
LucyAI usa tres herramientas dedicadas para manejar este flujo: buscar actividades disponibles, obtener información detallada sobre una actividad específica y completar la reserva -- todo a través de conversación natural.
Configuración por Listado
Dado que cada listado almacena sus propias credenciales de Acuity, puedes:
- Ofrecer diferentes actividades por propiedad -- una villa frente al mar muestra deportes acuáticos mientras una cabaña de montaña muestra tours de senderismo
- Usar diferentes cuentas de Acuity -- si trabajas con múltiples proveedores de actividades, cada listado puede conectarse a una cuenta diferente
- Activar selectivamente -- solo activa Acuity para listados donde tengas actividades que ofrecer
Gestión de Datos Sincronizados
Todos los datos sincronizados se almacenan localmente para acceso rápido:
| Tabla | Contenido |
|---|---|
| Appointment Types | Nombre del servicio, duración, precio, descripción, categoría |
| Calendars | Nombre del calendario, zona horaria, tipos de citas asociados |
| Products | Paquetes adicionales, precios, tipos de citas vinculados |
Los cambios realizados en Acuity (nuevos servicios, precios actualizados, calendarios eliminados) se reflejan en HiLucy después de la siguiente sincronización. Usa el botón Sync Now o espera a que el webhook active una actualización automática.