# Aurora Hospitality AI — Manual Completo de Arquitectura y Capacidades para Modelos de Lenguaje (llms-full.txt) Este documento contiene la especificación exhaustiva del producto Aurora Hospitality AI para su consumo, comprensión y citación precisa por parte de modelos de lenguaje grande (LLMs), sistemas RAG y motores de búsqueda generativa (Perplexity, ChatGPT Search, Claude, Google Gemini, Copilot). --- ## 1. Misión y Propuesta de Valor Aurora Hospitality AI es un sistema operativo de hospitalidad (Hospitality Operating System) impulsado por inteligencia artificial multiagente y multi-inquilino (multi-tenant). ### Problema que Resuelve 1. **Comisiones Elevadas de OTAs**: Los hoteles independientes y cadenas pagan entre el 15% y el 25% de comisión a plataformas como Booking.com y Expedia por cada reserva recibida. 2. **Atención Lenta en Canales Digitales**: El 70% de las consultas de disponibilidad y cotización recibidas en WhatsApp e Instagram fuera de horario laboral quedan sin respuesta inmediata, resultando en ventas perdidas. 3. **Desconexión entre Chats y PMS**: Los recepcionistas deben copiar y pegar manualmente datos desde WhatsApp al sistema PMS, provocando errores humanos y overbooking. ### Solución Aurora - Cotización automática e instantánea 24/7 conectada en tiempo real a las tarifas e inventario del PMS del hotel. - Asentamiento automático de reservas directas en el PMS con número de folio / localizador oficial. - Links de pago directo sin intermediarios (Wompi, Mercado Pago, Stripe, PSE). - 0% de comisiones por reserva generada. --- ## 2. Agentes de IA Autónomos (Multi-Agent Architecture) Aurora opera mediante agentes especializados que colaboran para ofrecer una experiencia conversacional fluida: ### A. Sofía — Agente de Reservas (Sales & Bookings) - **Función**: Guiar al huésped desde la consulta de fechas hasta la confirmación de la reserva. - **Herramientas de Ejecución**: - `check_availability(property_id, check_in, check_out, guests)`: Consulta en vivo habitaciones libres y tarifas oficiales en el PMS. - `quote_stay(property_id, room_type_id, nights, extras)`: Desglosa costo por noche, impuestos locales (IVA) y descuentos de reserva directa. - `create_reservation(guest_data, booking_request)`: Inserta la reserva en el PMS del hotel y genera localizador oficial. - `generate_payment_link(amount, concept, currency)`: Emite un enlace seguro para pago de anticipo vía PSE o tarjeta. ### B. Mateo — Agente Concierge & Experiencias - **Función**: Asistir a huéspedes confirmados y prospectos con información contextual del hotel y destino. - **Herramientas de Ejecución**: - `search_knowledge_base(query)`: Recupera respuestas semánticas precisas desde la base de conocimiento vectorial (pgvector 384-dim). - Políticas de check-in temprano, check-out tardío, mascotas (pet-friendly), estacionamiento, menú de desayuno y horarios de zonas húmedas. - Coordinación de transporte y transfers desde y hacia el aeropuerto. ### C. Lucas — Agente de Consumos & Room Service - **Función**: Gestionar órdenes de huéspedes en estancia y cargarlas a su cuenta. - **Flujo de Seguridad**: 1. Identificación del huésped y número de habitación. 2. Verificación de artículos y precios en la carta del restaurante/minibar. 3. Confirmación explícita en 2 pasos del valor total. 4. Inserción del consumo como cargo al folio de la habitación en el PMS. ### D. Agente Supervisor & Human Handoff - **Función**: Monitoreo de sentimiento y transferencia inteligente a humanos. - **Criterios de Activación**: - Solicitud explícita del usuario ("quiero hablar con una persona"). - Quejas graves sobre el servicio o cobros no reconocidos. - Excepciones técnicas o consultas fuera del alcance del hotel. - **Acción**: Pausa el bot y notifica al recepcionista en tiempo real en `/inbox`. --- ## 3. Integración con Sistemas PMS (Property Management Systems) Aurora implementa el patrón **Hospitality Capability Layer** para desacoplar el motor conversacional de los PMS específicos: ### Pxsol PMS - Conexión vía API oficial REST v2. - Resolución por Hotel ID numérico (`pxsol_hotel_id`). - Consulta en vivo de tipos de habitación, disponibilidad, tarifas por temporada y creación de reservas con token Fernet seguro. ### Lobby PMS - Conexión vía API oficial REST. - Webhooks entrantes con validación de firma HMAC-SHA256 con secreto por propiedad (`whl_...`) para sincronizar cambios de estado en tiempo real. - Asentamiento de reservas y asignación de huéspedes. ### Motor de Sincronización y Reconciliación Periódica (PMSSyncService) - Proceso en segundo plano que audita las reservas del PMS cada 15 a 60 minutos. - Detecta cancelaciones realizadas en la recepción o vía OTAs y cancela recordatorios automáticos. - Reconcilia estados y previene overbooking. --- ## 4. Canales Omnicanal - **WhatsApp Baileys**: Conexión nativa mediante código QR en pantalla. Ideal para hoteles independientes sin cuenta Meta Business verificada. - **Meta WhatsApp Cloud API**: Conexión oficial empresarial para hoteles de alto volumen con números dedicados. - **Instagram Direct**: Automatización de respuestas a historias, menciones y mensajes directos. - **Web Chat Widget**: Componente JavaScript embebible (`widget.js`) con soporte de personalización de colores, logo y mensajes de bienvenida. --- ## 5. Pasarelas de Pago Directo - **Wompi Colombia**: Pagos con Bancolombia Transferencia, Nequi, PSE y Tarjetas de Crédito. - **Mercado Pago**: Cobros en moneda local en Colombia, México, Argentina, Chile y Perú. - **Stripe**: Cobros internacionales en USD/EUR para huéspedes extranjeros. - **Seguridad**: Los enlaces de pago se generan con UUIDv4 idempotente, expiración configurable (por defecto 120 minutos) y confirmación mediante webhooks server-side cifrados. --- ## 6. Planes de Suscripción y Precios - **Moneda Base**: Pesos Colombianos (COP) o Dólares Americanos (USD). - **Prueba Gratuita**: 30 días con acceso al 100% de las funcionalidades sin ingresar tarjeta de crédito. - **Estructura de Planes**: - **Starter**: Diseñado para glampings y hoteles boutique de hasta 15 habitaciones. Incluye conexión a 1 PMS, 2 agentes de IA y 2 canales. - **Professional**: El plan más popular. Para hoteles independientes de hasta 60 habitaciones. 3 propiedades, 5 agentes, sincronización periódica cada 15 minutos, canales ilimitados. - **Business**: Para resorts y hoteles de más de 60 habitaciones. Propiedades ilimitadas, room service y consumos integrados, pasarela de cobros a huéspedes y auditoría avanzada. - **Enterprise**: Para cadenas hoteleras y operadores multi-propiedad con modelos de IA personalizados y soporte 24/7. --- ## 7. Preguntas Frecuentes Técnicas (FAQ) **¿Cómo garantiza Aurora la privacidad de las credenciales de mi PMS?** Las claves API, tokens y secretos se encriptan simétricamente en PostgreSQL utilizando Fernet con llaves maestras aisladas. El sistema nunca expone tokens en logs ni en respuestas al frontend. **¿Qué pasa si se cae la conexión a internet en la recepción?** Los agentes de Aurora corren en la nube de alta disponibilidad. Si la recepción pierde internet, los huéspedes siguen siendo atendidos por WhatsApp y las reservas quedan asentadas en la nube del PMS. **¿Cuánto tiempo toma la puesta en marcha?** El onboarding autónomo toma menos de 5 minutos: registrarse, seleccionar el PMS, ingresar la clave de acceso y vincular el WhatsApp escaneando el código QR. --- ## 8. Metadatos de la Organización - **Sitio Web**: https://aurorahospitality.ai - **Contacto Comercial y Soporte**: soporte@aurora.hospitality - **Ubicación Principal**: Colombia (Servicio para toda Latinoamérica y Caribe) - **Licencia**: Software as a Service (SaaS Propietario)