Ringostat
Log in

Room booking: Servio HMS

~6 min · The agent checks free rooms with prices and books them in Servio HMS during the call.
What you get:
the agent names free cottages and rooms with the total for the whole stay, suggests the nearest free dates and, if you allow it, creates the booking itself and tells the caller its number.
Before you start:
a hotel in Servio HMS with the booking module (Reservation API), project admin rights in Voice Agent and a “Voice Agent” campaign.

1. Get access in Servio

Ask Servio support or the hotel's administrator for three values:

  • the reservation API URL: the address of the ReservationService module, for example https://pms.example.com/ReservationService_1_14;
  • the access token (AccessToken);
  • the hotel ID in Servio. If the hotel uses cashless payment or a waitlist, also the company ID.

2. Connect the integration

  1. 1
    Left menu → “Integrations” → “Ready-made” → the “Booking” tab → the “Servio HMS” card → “Connect”.
    Servio HMS card
    Servio HMS card
  2. 2
    In the “Connection” block fill in “Reservation API URL”, “Access token” and “Hotel ID”.
    Connection fields
    Connection fields
  3. 3
    Click “Save”.
  4. 4
    Click “Test connection”. If everything is right, you will see “Connection works”.
    Test connection
    Test connection
The token is stored encrypted and is not shown after saving. To replace it, enter a new one; an empty field keeps the saved token.

3. Choose what the agent offers

  1. 1
    In the “What the bot offers” block click “Show the hotel's room types”: the room types from Servio appear with their IDs.
    The hotel's room types
    The hotel's room types
  2. 2
    “Room type IDs”: comma-separated room types the agent may offer. Empty means all.
  3. 3
    “Room type names for the bot”: one per line, “ID: name”. The agent says these names instead of the names from Servio, for example “11: cottage for two”.
  4. 4
    “Price list IDs” limits the tariffs; “Hide non-refundable tariffs” removes them from the offers.
  5. 5
    “Adults from age”: the age from which a guest is booked as an adult (12 by default). Younger children are sent to Servio with their ages.
  6. 6
    “Use extra beds” and “Include tourist tax”: as in your price list. Servio calculates the price; the agent only says the total.

4. Turn on booking (optional)

While “Create bookings” is off, the agent only checks availability and prices. Make your test calls in this mode first.

Booking settings
Booking settings
Create bookingsThe agent creates a booking in Servio once the caller has agreed to the room, dates, guests and total. Repeating the same request does not create a second booking.
Booking typeRegular: holds the room. Waitlist: the room is not held and a manager confirms the booking.
Payment type, Company ID, Contract condition IDAs in Servio. Cashless payment and the waitlist need the company ID.
Additional contract condition IDsComma-separated contract conditions whose tariffs the agent also offers: a hotel's room-only tariff often has its own condition. A booking is made under the chosen tariff's condition. Get the IDs from the hotel administrator or Servio support.
Booking commentText saved in the booking; placeholders {phone}, {name}, {date}. The agent adds the children's ages itself.
Payment linkThe prepayment link the agent gets after a regular booking. The booking number replaces {booking_id}. The agent can send it by SMS if the campaign has an SMS tool.
Allow cancellation by phoneThe agent may cancel a booking made from the caller's number after the caller confirms. Off by default.
Bookings are created in the hotel's live database. Agree test bookings with the hotel and pass on their numbers so they can be cancelled.

5. Add it to a campaign

  1. 1
    Campaign editor → the “AI tools” card → choose Servio HMS: all of its tools or only the selected ones.
    AI tools
    AI tools
  2. 2
    Save the campaign.
search_availabilityFree room types and the total for the whole stay for the given dates, number of adults and children's ages.
suggest_datesThe nearest free dates when the chosen ones are full.
create_bookingCreates the booking; returns its number and the payment link.
get_booking, send_confirmationThe caller's booking status and the confirmation e-mail to the guest.
cancel_bookingCancellation, only if allowed in the settings.

Add the hotel's rules to the agent's instructions: book only after the guest clearly agrees and say the booking number, which room types to offer to whom (for example, only for guests aged 12 and over), whether to name the prices of individual services.

One booking is one room. If no room type fits the whole group, the agent finds no option: tell it in the instructions to pass such requests to a manager.

6. The booking number in your CRM

In the campaign's webhook body template, insert the tool's result: {{tools.servio_create_booking.booking_id?}} for the booking number, {{tools.servio_create_booking.payment_link?}} for the payment link. The ? leaves the field empty (null) when no booking was made in the call. More in the guide “Webhooks: call results”.

What next