Hospitable Integration

Connect your Touch Stay and Hospitable accounts to import Hospitable property & reservation data into your guides and make it easier to share guides with your guests.

The steps to complete your integration:

• Step 1: Connect your Touch Stay & Hospitable accounts
• Step 2: Match Hospitable properties
• Step 3: Import Hospitable properties
• Step 4: Complete guide creation (new Touch Stay customers only)
• Step 5: Personalisation settings
• Step 6: Sync reservations
• Step 7: Sharing guide links through Hospitable

Video: Step by step instructions to connect your Touch Stay & Hospitable accounts

Step 1. Connect your Touch Stay & Hospitable accounts

Go to Integrations > Partners and click 'Connect' underneath the Hospitable logo.

Follow the next prompts to take you to the Hospitable connection flow, where you confirm giving access to Touch Stay. You will need your Hospitable login to complete this step.

Step 2. Match Hospitable properties

You can now match existing Touch Stay guides to your Hospitable properties. Go to Integrations > Match and use the drop-downs to match the correct Hospitable property for each Touch Stay guide. When the matching is complete, click 'Match selected'.  If you don’t have any to match, then just move on to the Import tab.

Step 3. Import Hospitable properties

If you have any remaining unmatched properties from Hospitable, go to Integrations > Import. Click the remaining properties you want to import and click ‘Import selected’.

Each imported property will create a new Touch Stay guide and populate them with the following details from Hospitable:

• Property Name
• Property Address
• Property Location

Step 4. Complete guide creation (for new Touch Stay customers only)

Now is the time to check the content of your guides to make sure they are ready to share with guests before you complete the integration and sync your Hospitable reservations.

If you’re new to Touch Stay, then check out the Getting Started page for hints and tips on the quickest way to build out your guide content.

If you have more than 20 properties, please contact us at support@touchstay.com to find out more about our onboarding service.

Step 5. Personalisation settings

You can map Hospitable reservation data fields to Touch Stay custom fields. These can then be inserted into guides and guest messages to personalise them for each reservation. The following paragraphs explain how to map and sync Hospitable reservation data to your custom fields.

The following Hospitable reservation data fields will be automatically mapped to standard field codes in your Touch Stay account:

• Guest first name (data type: Text)
• Guest last name (data type: Text)
• Arrival date (data type: Number)
• Departure date (data type: Number)
• Guest contact phone number* (data type: Number)
• Guest contact email address* (data type: Text)

*Some OTAs and booking sites do not always provide the guest email address or phone number so the availability of these two data points is dependent on the platform the guest used to complete their booking.

The following Hospitable reservation data fields are also available through the integration. They are optional and can be manually mapped to a Touch Stay custom field: 

• Check-in time (data type: Text)
• Check-out time (data type: Text)
• Number of adults (data type: Number)
• Number of children (data type: Number)
• Number of infants (data type: Number)
• Number of pets (data type: Number)
• Booking code (data type: Text)
• Booking Platform (data type: Text)
• Booking date (data type: Date)

To connect any of these optional data fields to Touch Stay custom fields, go to Integrations > Map data and click the '+Add new mapping' button. 

From here you can select the Hospitable data field to connect. Choose from an existing custom field or create a new one by giving it a name and any substitute value. Substitute values are used in the case of data missing when the field code is used, see this article for more detail about field codes.

Once the custom fields have been created, any future reservations which sync from Hospitable will have the relevant data automatically populated for the reservation (invitation record) and can be used in Memo message templates and guide content.

Step 6. Sync reservations

Sync Hospitable reservations with your Touch Stay account to complete the integration.

Here you can choose whether to import all your existing reservations or only import new reservations. 

• If you are new to Touch Stay and not using the Memo messaging tool then choose 'All reservations'.

• If you are already using the Memo messaging tool, then choose 'New reservations only'  to prevent duplicate Memo messages being sent to existing reservations.

If you have selected 'All reservations' then all existing reservations from Hospitable will now be imported and the unique guide link of each one will be passed back into Hospitable.

To complete this step, go to Integrations > Sync reservations and select the guides you want to sync using the checkboxes. Use the ‘Select all’ option to select all in one go. Click 'Sync selected'.

Step 7. Sharing guide links through Hospitable

By activating the sync, a short code called %guidebook% will automatically be created in your Hospitable account. This data field will contain a trackable guide link that's unique for each reservation that is synced to Touch Stay.

You can add this short code to an existing or new automated message in Hospitable, so every guest can access a guide that has been personalised with their reservation details.

For additional help and support creating message automations in Hospitable please reach out to Hospitable support.

*** A note about Hospitable message timing***

There may be a delay between the booking arriving in Hospitable and the link being sent back from Touch Stay whilst our respective systems process the booking, generate the link and pass it back.

Therefore, we recommend NOT adding your "Touch Stay Guide Link" custom field to Hospitable messages that are sent out as soon as the booking is received.

Instead, we recommend adding a message at least 1 hour later or perhaps the next day that's dedicated to introducing guests to everything they'll find in your guidebook.