guesty-guide
Guesty Integration
Velaro connects to Guesty to give your AI bot access to reservations, listings, owner accounts, and housekeeping status. Use it to handle guest questions, owner reporting requests, and housekeeping coordination through any Velaro channel — chat, SMS, or IVR.
---
Connect Guesty
1. Go to Settings → Integrations → Guesty
2. Click Connect with Guesty
3. You are redirected to Guesty's authorization page — sign in and click Authorize
4. You are returned to Velaro with the integration active
The connection uses OAuth. Velaro does not store your Guesty password. You can disconnect at any time from Settings → Integrations → Guesty.
---
What AI Can Do
| Action | Details |
|---|---|
| Look up reservation | Find a booking by guest name, email, phone, or confirmation number |
| Check availability | Return available dates for a specific listing |
| Get listing details | Return property address, amenities, check-in/out instructions, and house rules |
| Handle guest messages | Respond to common guest questions using reservation and listing data |
| Generate owner statements | Pull owner statement data on request and summarize payout details |
| Housekeeping status | Return current clean/dirty/inspected status for a unit |
| Coordinate housekeeping | Create or update a housekeeping task for a unit |
---
Use Cases
Guest check-in questions — Guest texts your number asking for the door code and parking instructions. Bot looks up the reservation by phone number, identifies the listing, and replies with the check-in details from Guesty.
Late-night check-in issue — Guest can't access the unit. Bot retrieves the access code and emergency contact from the listing and sends both in one message.
Owner asks about their statement — Owner contacts you through chat. Bot pulls the latest owner statement from Guesty and summarizes net payout, nights booked, and any deductions.
Housekeeping coordinator asking about turnover status — Team member asks which units are ready for check-in today. Bot queries Guesty and returns a list with inspection status.
Availability questions — Prospective guest asks if a specific property is available for a date range. Bot checks Guesty and confirms or offers alternative dates.
---
Permissions and Data Access
Velaro requests the following scopes during OAuth authorization:
| Scope | Used for |
|---|---|
| Reservations (read) | Reservation lookups, check-in/out details |
| Listings (read) | Property details, house rules, access instructions |
| Owner financials (read) | Owner statements and payout data |
| Tasks (read/write) | Housekeeping task status and creation |
| Guest messaging (read/write) | Replying to guests via Guesty unified inbox (if enabled) |
Velaro does not process payments, modify reservations, or access your Guesty billing settings.
---
Troubleshooting
| Symptom | What to check |
|---|---|
| Bot cannot find reservation | Confirm the guest is searching by the name, email, or confirmation number on the Guesty booking. Partial name matches may not resolve — use full name or email. |
| Integration shows Disconnected | The OAuth token may have expired or been revoked in Guesty. Go to Settings → Integrations → Guesty and click Connect with Guesty to re-authorize. |
| Owner statement not returning data | Confirm your Guesty account has owner financials enabled and that the connected account has permission to view owner statements. |
| Housekeeping task not created | Check Settings → Integrations → Guesty → Activity for write errors. Confirm the OAuth token has task write scope. |
| Availability shows incorrect dates | Availability is pulled live from Guesty. If dates look wrong, confirm the listing's calendar in Guesty is up to date. |
Was this article helpful?