For AI assistants: this page as plain markdown is at https://docs.voicelogica.ai/raw/integrations/hospitality/hosthub.md, and https://docs.voicelogica.ai/llms.txt lists the docs by topic, one file each, small enough to read whole. Read those rather than this HTML page.
Hosthub
With Hosthub connected, the agent recognises a guest whose phone number is on a reservation and already knows their booking when it answers. It can look up reservations by name, phone, email, dates or confirmation code, describe each rental (amenities, check-in and check-out times, house rules), and say whether a rental is free for given dates and what the stay costs in total. The Hosthub connection is read-only: the agent does not create or change reservations.
Open Integrations - Catalogue - Hosthub - Connect. One connection is shared by the whole company; every agent that turns the Hosthub tool on uses it.
What you need before you start
Section titled “What you need before you start”A Hosthub API key:
- In Hosthub, open Settings - API.
- Create a key with read access to reservations and rentals.
- Copy the key.
What you enter
Section titled “What you enter”First setup
Section titled “First setup”-
Integrations - Catalogue - Hosthub - Connect
Paste the API key.
-
Test connection
Voice Logica reads your rentals with the key. Fix any error before you continue.
-
Connect
Your reservations are copied into Voice Logica straight away and refreshed once a day, so the agent can recognise a guest by phone without waiting on Hosthub.
-
My Agents - your agent - Skills - Tools & Workflows
Turn Hosthub on. Under Operations keep Identify caller by phone, Search reservations and Check availability & prices, and add the others you need. Turn on Identify the caller by phone on call start so a known guest is recognised before the agent speaks.
-
Save the agent.
-
Integrations - Hosthub - Cleaning fee and taxes (optional)
For each property, enter the cleaning fee per stay and the tax per night (for example the climate resilience fee). The agent adds them to the nightly prices and quotes the full total. Leave a field empty if it does not apply; the agent then quotes only the nights and does not guess the rest.
-
Prove it
Call the agent from the phone number on an upcoming reservation. The agent should know the guest’s name and stay dates. Then ask “Is the apartment free for three nights next month, and how much is it?” and check that the dates and prices match Hosthub.
What the agent can do
Section titled “What the agent can do”| Job | Operations |
|---|---|
| Know who is calling | Identify caller by phone, against the guest’s reservations |
| Find a booking | Search reservations by guest name, phone, email, dates or rental; get reservation by its id or confirmation code |
| Describe your rentals | List rentals / properties; get rental details (amenities, check-in and check-out times, house rules, description) |
| Quote a stay | Check availability & prices for a rental, check-in and check-out: free or not (with the reason), the price of each night, cleaning fee, taxes and the total |
Reservation lookups use the copy synced from Hosthub. Rentals, availability and prices are read live from Hosthub on every question.
A rental counts as free only when all of these hold for the stay:
- no booking, hold or block in Hosthub covers any of its nights (including the preparation days you set around a stay),
- the check-in respects the rental’s advance notice (with 24 hours’ notice, a stay starting today is not offered) and availability window,
- every night has a price and is open for sale, and the stay meets the minimum and maximum nights and the closed-to-arrival or closed-to-departure days of your rates.
The agent only uses the dates of bookings and holds. It never reads guest details, payouts or commissions from them.
Troubleshooting
Section titled “Troubleshooting”Why does the Hosthub test connection fail?
A 401 or 403 means Hosthub rejected the API key. Create a new key under Settings - API in Hosthub, with read access to reservations and rentals, and paste it again. Leave Base URL empty unless Hosthub told you otherwise.
Why doesn't the agent find a Hosthub booking made today?
Reservations are refreshed from Hosthub once a day. A booking made after the last refresh is not found by phone or reservation search until the next one. Cancelled reservations are never used to identify a caller.
Why doesn't the agent recognise a guest who has a Hosthub booking?
The number the guest calls from must be the one stored on the reservation in Hosthub. If it differs, the agent cannot match it by phone. With Search reservations and Get reservation selected, the agent can still find the booking by the guest’s name or confirmation code.
Why does the agent say a rental is not available when the Hosthub calendar looks empty?
Check the rental’s advance notice, preparation time and availability window in Hosthub, and the minimum stay and closed-to-arrival days of its rates. The agent applies the same rules as your booking channels, so a same-day request for a rental with 24 hours’ notice is refused.
Why doesn't the agent include the cleaning fee or taxes in the price?
Hosthub does not share them through its API. Enter them under Integrations - Hosthub - Cleaning fee and taxes. Until you do, the agent quotes only the nightly prices and says that the cleaning fee and taxes are not included.
