Hoteles: Cloudbeds y Opera Cloud
El sistema de administración del hotel (PMS) le dice al sistema telefónico quién está en cada habitación. El registro de entrada abre la extensión de la habitación, la salida la cierra y borra los rastros del último huésped, los despertadores vienen del PMS y las habitaciones pueden llamarse entre sí según reglas.
Conectores
Instálelos desde Consola, Admin, Integraciones (cloudbeds, opera, categoría hospitality). Las credenciales se sellan con la llave de la empresa y no se vuelven a mostrar. Cree un endpoint de hooks entrantes para el conector (vea Webhooks salientes) y entregue su dirección al PMS.
| Ajuste | Significado | Predeterminado |
|---|---|---|
timezone | zona IANA del hotel; la hora de cada despertador es local de esa zona | UTC |
room_prefix | dígitos antepuestos al número de habitación para obtener la extensión (habitación 201, prefijo 1: extensión 1201) | ninguno |
front_desk | la extensión a la que toda habitación siempre puede llamar | 0 |
checkin_cos | clase de servicio durante la estancia: internal, local, national, international | national |
room_to_room | occupied_only, always, never | occupied_only |
wakeup_attempts | timbrados por despertador antes de avisar a recepción (1 a 6) | 3 |
wakeup_retry_minutes | minutos entre timbrados (1 a 30) | 5 |
Cloudbeds: property_id y una llave de API. Webhooks: reservation/status_changed (checked_in, checked_out; las habitaciones salen de getReservation), reservation/notes_created, housekeeping/room_condition_changed. Cloudbeds no tiene objeto de despertador, así que recepción escribe WAKEUP 06:30 (o WAKEUP CANCEL) en las notas de la reservación; el evento de notas programa o cancela el despertador de cada habitación asignada.
Opera Cloud (OHIP): dirección del gateway, client id y secret, usuario y contraseña de integración, llave de aplicación, enterprise id y código de hotel. Eventos de negocio: CHECKED_IN, CHECKED_OUT, ROOM_MOVE, ROOM_STATUS_CHANGED, WAKE_UP_CALL_CREATED, _UPDATED, _CANCELLED. Un evento de otro código de hotel se rechaza.
Ambos conectores dan al agente de IA una herramienta, room_status (ocupada o vacía, estado de limpieza).
Qué ocurre
| Evento del PMS | Sistema telefónico |
|---|---|
| registro de entrada | la extensión de la habitación recibe checkin_cos; el idioma del huésped elige los avisos y el mensaje del despertador |
| salida | la extensión vuelve a restricted (solo recepción y números de emergencia); buzón de voz, desvíos y No molestar se restablecen; los despertadores pendientes se cancelan |
| cambio de habitación | la habitación anterior se cierra y restablece, la nueva se abre, los despertadores y el idioma siguen al huésped |
| fuera de servicio | habitación restringida |
| limpieza | solo se registra |
| despertador: programar / cancelar | se programa en la zona del hotel; el mismo minuto dos veces es un solo despertador; máximo 3 pendientes por habitación; máximo 30 días por adelantado; una habitación vacía se rechaza |
Un despertador timbra en su minuto y luego cada wakeup_retry_minutes hasta que contesten o se agoten los intentos; entonces se avisa a recepción.
Reglas de marcación
Toda habitación siempre puede llamar a recepción y a los números de emergencia (911, 112, 065, 066, 999). Una habitación vacía o fuera de servicio no puede llamar a nada más. Entre habitaciones: según room_to_room. Los demás números requieren la clase: 4 dígitos o menos es interno, 7 a 9 dígitos local, 10 o más nacional, + o 00 internacional. Las extensiones del personal no son habitaciones y estas reglas no las restringen.
Flujo de plantilla
pbx/crates/flows/templates/hotel-front-desk.json: los huéspedes (que llaman desde una habitación) reciben un menú con recepción, limpieza, solicitud de despertador y servicio a la habitación; quienes llaman de fuera reciben recepción, reservaciones y un directorio de huéspedes. Todo tiempo de espera, tecla incorrecta y falla termina en recepción y luego en su buzón de voz. La ruta del despertador captura cuatro dígitos (0630) y los envía con la extensión de quien llama a POST /api/v1/hotel/wakeups/by-extension (el nodo HTTP necesita la capacidad http; sustituya el host de ejemplo por la dirección de su PBX, guarde una llave de API con hotel:write como secreto del flujo hotel_api_key y grabe los avisos).
La recepción
El PMS alimenta la recepción del hotel de la empresa (Recepción del hotel): las habitaciones y los despertadores se guardan en la base de datos, la lista de habitaciones se carga una vez desde el PMS cuando arranca la recepción, y recepción también puede registrar entradas y salidas, cambiar de habitación y programar despertadores desde la consola. Los endpoints de hooks usan el esquema shared_secret para ambos PMS hasta que un laboratorio de hotel confirme los encabezados de firma del proveedor.