Ringostat
Entrar

Reserva de habitaciones: Servio HMS

~6 min · El agente consulta habitaciones libres con precios y las reserva en Servio HMS durante la llamada.
Qué obtendrás:
el agente nombra las cabañas y habitaciones libres con el total de toda la estancia, propone las fechas libres más cercanas y, si lo permites, crea la reserva y dice su número.
Antes de empezar:
un hotel en Servio HMS con el módulo de reservas (Reservation API), derechos de administrador del proyecto en Voice Agent y una campaña «Voice Agent».

1. Consigue los accesos de Servio

Pide al soporte de Servio o al administrador del hotel tres datos:

  • la URL de la API de reservas: la dirección del módulo ReservationService, por ejemplo https://pms.example.com/ReservationService_1_14;
  • el token de acceso (AccessToken);
  • el ID del hotel en Servio. Si el hotel trabaja con pago sin efectivo o lista de espera, también el ID de la empresa.

2. Conecta la integración

  1. 1
    Menú izquierdo → «Integrations» → «Ready-made» → pestaña «Booking» → tarjeta «Servio HMS» → «Connect».
    Tarjeta de Servio HMS
    Tarjeta de Servio HMS
  2. 2
    En el bloque «Connection», rellena «Reservation API URL», «Access token» y «Hotel ID».
    Campos de conexión
    Campos de conexión
  3. 3
    Pulsa «Save».
  4. 4
    Pulsa «Test connection». Si todo está bien, aparecerá «Connection works».
    Test connection
    Test connection
El token se guarda cifrado y no se muestra después de guardarlo. Para cambiarlo, introduce uno nuevo; si dejas el campo vacío, se conserva el guardado.

3. Elige qué ofrece el agente

  1. 1
    En el bloque «What the bot offers», pulsa «Show the hotel's room types»: aparecen las categorías de Servio con sus ID.
    Categorías de habitaciones del hotel
    Categorías de habitaciones del hotel
  2. 2
    «Room type IDs»: separadas por comas, las categorías que el agente puede ofrecer. Vacío: todas.
  3. 3
    «Room type names for the bot»: una por línea, «ID: nombre». El agente dice estos nombres en lugar de los de Servio, por ejemplo «11: cabaña para dos».
  4. 4
    «Price list IDs» limita las tarifas; «Hide non-refundable tariffs» las quita de las ofertas.
  5. 5
    «Adults from age»: la edad desde la que un huésped se reserva como adulto (12 por defecto). Los niños menores se envían a Servio con su edad.
  6. 6
    «Use extra beds» e «Include tourist tax»: según tu lista de precios. El precio lo calcula Servio; el agente solo dice el total.

4. Activa las reservas (si las necesitas)

Mientras «Create bookings» esté desactivado, el agente solo consulta disponibilidad y precios. Haz primero las llamadas de prueba en este modo.

Ajustes de reserva
Ajustes de reserva
Create bookingsEl agente crea la reserva en Servio cuando el cliente ha aceptado la habitación, las fechas, los huéspedes y el total. Repetir la misma petición no crea una segunda reserva.
Booking typeNormal: retiene la habitación. Lista de espera: no la retiene y un gestor confirma la reserva.
Payment type, Company ID, Contract condition IDComo en Servio. El pago sin efectivo y la lista de espera necesitan el ID de la empresa.
Additional contract condition IDsCondiciones de contrato separadas por comas cuyas tarifas el agente también ofrece: la tarifa sin desayuno de un hotel suele tener su propia condición. La reserva se hace con la condición de la tarifa elegida. Los ID los da el administrador del hotel o el soporte de Servio.
Booking commentTexto guardado en la reserva; variables {phone}, {name}, {date}. El agente añade la edad de los niños por su cuenta.
Payment linkEl enlace de prepago que el agente recibe tras una reserva normal. El número de reserva sustituye a {booking_id}. El agente puede enviarlo por SMS si la campaña tiene una herramienta de SMS.
Allow cancellation by phoneEl agente puede cancelar una reserva hecha desde el número del cliente, tras su confirmación. Desactivado por defecto.
Las reservas se crean en la base de datos real del hotel. Acuerda las reservas de prueba con el hotel y pásale sus números para que las anule.

5. Añádela a una campaña

  1. 1
    Editor de la campaña → tarjeta «AI tools» → elige Servio HMS: todas sus herramientas o solo las marcadas.
    Herramientas de IA
    Herramientas de IA
  2. 2
    Guarda la campaña.
search_availabilityCategorías libres y el total de toda la estancia para las fechas, el número de adultos y la edad de los niños.
suggest_datesLas fechas libres más cercanas si las elegidas están completas.
create_bookingCrea la reserva; devuelve su número y el enlace de pago.
get_booking, send_confirmationEl estado de la reserva del cliente y el correo de confirmación al huésped.
cancel_bookingCancelación, solo si está permitida en los ajustes.

Añade a las instrucciones del agente las reglas del hotel: reservar solo tras el acuerdo claro del huésped y decir el número de reserva, qué categorías ofrecer a quién (por ejemplo, solo para huéspedes de 12 años o más), si nombrar los precios de servicios concretos.

Una reserva es una habitación. Si ninguna categoría admite a todo el grupo, el agente no encontrará opción: indica en las instrucciones que esas peticiones pasen a un gestor.

6. El número de reserva en tu CRM

En la plantilla del cuerpo del webhook de la campaña, inserta el resultado de la herramienta: {{tools.servio_create_booking.booking_id?}} para el número de reserva, {{tools.servio_create_booking.payment_link?}} para el enlace de pago. El ? deja el campo vacío (null) si en la llamada no hubo reserva. Más en la guía «Webhooks: resultados de las llamadas».

Qué sigue