Saltar al contenido principal

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.

AjusteSignificadoPredeterminado
timezonezona IANA del hotel; la hora de cada despertador es local de esa zonaUTC
room_prefixdígitos antepuestos al número de habitación para obtener la extensión (habitación 201, prefijo 1: extensión 1201)ninguno
front_deskla extensión a la que toda habitación siempre puede llamar0
checkin_cosclase de servicio durante la estancia: internal, local, national, internationalnational
room_to_roomoccupied_only, always, neveroccupied_only
wakeup_attemptstimbrados por despertador antes de avisar a recepción (1 a 6)3
wakeup_retry_minutesminutos 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 PMSSistema telefónico
registro de entradala extensión de la habitación recibe checkin_cos; el idioma del huésped elige los avisos y el mensaje del despertador
salidala 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ónla habitación anterior se cierra y restablece, la nueva se abre, los despertadores y el idioma siguen al huésped
fuera de serviciohabitación restringida
limpiezasolo se registra
despertador: programar / cancelarse 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.