Skip to content

Connect Mews

The Mews tool connects your KonversAI assistant to one hotel in Mews. You add the tool on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools. Once connected, the assistant does three things. It tells visitors which rooms are free on their dates, what the stay costs, and links to your Mews booking engine. It answers a guest’s questions about their own booking, after the guest verifies their email address. It also passes a guest’s request, such as champagne in the room, to your staff as a task in Mews. The assistant never books, changes, cancels or charges anything in Mews.

KonversAI turns the Mews tool on for a workspace on request. Ask your KonversAI contact to turn on Mews for your workspace.

A team member with the View tools permission opens the Assistant tools screen in the KonversAI console. A team member with the Modify tools permission adds, edits, tests and deletes the tool. A Tenant Admin holds both permissions, always. Without View tools, the item AI tools does not appear under Settings in the left sidebar.

With Mews: you need someone who can connect integrations in the Mews Marketplace and open the booking engine settings in Mews, such as the hotel manager.

KonversAI must have turned on the Mews tool for your workspace. Without it, Mews does not appear when you select + Add tool.

The Mews tool uses two things from Mews. You can connect one or both:

  • Mews access token. The booking answers and guest requests need it. Mews creates the access token when you connect KonversAI in the Mews Marketplace.
  • Booking engine configuration ID. The free rooms, prices, room details and booking links need it. The configuration ID is the ID of your Mews booking engine.

The booking answers and guest requests need a verified email address. Add an Email Verification tool on the Assistant tools screen, so guests can verify their email address in the chat.

One Mews tool covers one hotel. For a group with several hotels, add one tool per hotel, each with its own Slug.

  1. In Mews: Open the Mews Marketplace and find KonversAI.
  2. In Mews: Select Connect and accept the request.
  3. In Mews: Wait for the access token. Mews sends the access token for your hotel to KonversAI. Your KonversAI contact tells you when it has arrived, or adds it to the tool for you.
  4. In Mews: Open the settings of your booking engine and copy its configuration ID. The configuration ID is a long ID such as 3fa85f64-5717-4562-b3fc-2c963f66afa6.
  1. In KonversAI: Select Settings in the left sidebar, then select AI tools. The screen opens with the heading Assistant tools.
  2. In KonversAI: Select + Add tool. Type Mews in the search field, then select Mews. The form opens with the heading Add tool.
  3. In KonversAI: Type a label in Display name, for example the hotel’s name. KonversAI fills Slug while you type.
  4. In KonversAI: Type your instruction in Usage guidance for the AI assistant. For example: Use this for free rooms, prices, questions about a guest’s booking, and requests during the stay.
  5. In KonversAI: Select Add tool at the bottom. KonversAI saves the tool and opens it with the heading Edit tool.
  1. In KonversAI: In the Connection card, keep Mews environment on Production.
  2. In KonversAI: Select Add secret on Mews access token. Paste the access token, then select Save.
  3. In KonversAI: Paste the configuration ID from Mews in Booking engine configuration ID.
  4. In KonversAI: Switch on Enable availability and room information tools to let the assistant quote free rooms and prices.
  5. In KonversAI: Switch on Enable booking lookup to let the assistant answer a verified guest about the guest’s booking.
  6. In KonversAI: Switch on Enable guest requests to let the assistant pass guest requests to your staff.
  7. In KonversAI: Select Test connection. Success starts with Connected to and your hotel’s name, and lists your Mews departments.
  8. In KonversAI: Optional: copy the ID of the department that should get guest requests, such as Reception, into Department for guest requests.
  9. In KonversAI: Select Save changes.

What can the assistant do once Mews is connected?

Section titled “What can the assistant do once Mews is connected?”

The Mews tool gives your KonversAI assistant three abilities. It tells a visitor which rooms are free for their dates and guests, what the whole stay costs, and gives a link that opens your Mews booking engine on that room and those dates. It answers a verified guest about their own booking: dates, check-in and check-out times, room type, room number once assigned, and the number of guests. It also passes a verified guest’s request to your staff as a task in Mews. The assistant never books, changes, cancels or charges anything.

Are the prices the assistant quotes the same as on our booking engine?

Section titled “Are the prices the assistant quotes the same as on our booking engine?”

Yes. The Mews tool reads free rooms and prices from your Mews booking engine, for the booking engine set in Booking engine configuration ID. The assistant quotes the price for the whole stay, and gives the guest a link to book it. Prices can change before the guest books, so the booking engine shows the final price.

How does a guest request, such as champagne in the room, reach our staff?

Section titled “How does a guest request, such as champagne in the room, reach our staff?”

The Mews tool creates a task in Mews with the guest’s name, booking number, room number or arrival date, the request, and the time the guest wants it. The task goes to the department in Department for guest requests, or to no department when that field is empty. Your staff deliver the request and charge anything payable as usual. KonversAI does not charge the guest. The assistant tells the guest the request was passed on, not that it is confirmed.

Which guests can send a request to our staff?

Section titled “Which guests can send a request to our staff?”

A guest can send a request when the guest has verified their email address in the chat, and the booking is confirmed or the guest is staying now. The email address must be the one the booking was made with. Guests with a cancelled, provisional or finished stay cannot send requests through the assistant. Switch on Enable booking lookup and Enable guest requests on the Mews tool to allow requests.

Why does the assistant ask the guest to verify their email address?

Section titled “Why does the assistant ask the guest to verify their email address?”

Mews bookings hold personal details. The Mews tool shows a booking only to the guest whose email address is on the booking in Mews, and only after the guest proves the email address is theirs in the chat. Add an Email Verification tool on the Assistant tools screen, so guests can verify.

The guest verified their email, but the assistant finds no booking. Why?

Section titled “The guest verified their email, but the assistant finds no booking. Why?”

The Mews tool finds a booking by its confirmation number, or by a Booking.com or other channel reference. The verified email address must match the email address of the person the booking is under in Mews. A booking made by someone else in the party does not show. A booking from Booking.com or another booking site often holds a temporary email address from that site instead of the guest’s own address. Then no verified email matches. Replace the email address on the guest’s profile in Mews with the guest’s own address, and ask the guest to try again.

Test connection says Mews rejected the access token. What now?

Section titled “Test connection says Mews rejected the access token. What now?”

The message reads Mews rejected the access token. Check that Mews environment is Production. Then replace Mews access token with the access token Mews issued for your hotel, and select Test connection again. KonversAI never shows a stored secret again, so replace the value rather than trying to read it.

Do I need both the access token and the configuration ID?

Section titled “Do I need both the access token and the configuration ID?”

No. The access token alone gives booking answers and guest requests. The configuration ID alone gives free rooms, prices, room details and booking links. Both together give all of them.

Last reviewed . Tell us when a step no longer matches the product.