Reserva de habitaciones: Servio HMS
- 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
- 2
- 3Pulsa «Save».
- 4
3. Elige qué ofrece el agente
- 1
- 2«Room type IDs»: separadas por comas, las categorías que el agente puede ofrecer. Vacío: todas.
- 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«Price list IDs» limita las tarifas; «Hide non-refundable tariffs» las quita de las ofertas.
- 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«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.

| Campo | Qué define |
|---|---|
| Create bookings | El 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 type | Normal: retiene la habitación. Lista de espera: no la retiene y un gestor confirma la reserva. |
| Payment type, Company ID, Contract condition ID | Como en Servio. El pago sin efectivo y la lista de espera necesitan el ID de la empresa. |
| Additional contract condition IDs | Condiciones 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 comment | Texto guardado en la reserva; variables {phone}, {name}, {date}. El agente añade la edad de los niños por su cuenta. |
| Payment link | El 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 phone | El agente puede cancelar una reserva hecha desde el número del cliente, tras su confirmación. Desactivado por defecto. |
5. Añádela a una campaña
- 1
- 2Guarda la campaña.
| Herramienta | Qué hace |
|---|---|
| search_availability | Categorí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_dates | Las fechas libres más cercanas si las elegidas están completas. |
| create_booking | Crea la reserva; devuelve su número y el enlace de pago. |
| get_booking, send_confirmation | El estado de la reserva del cliente y el correo de confirmación al huésped. |
| cancel_booking | Cancelació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.
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
- Webhooks: resultados de las llamadas — resultados de herramientas en la plantilla del webhook.
- Instrucciones del agente — dónde escribir las reglas de reserva.
- Números y llamada de prueba — comprueba los escenarios antes del lanzamiento.




