Avantio Integration

Touch Stay integrates with Avantio to import your accommodations and then automate the sending of invitations for confirmed bookings. If you don’t have a Touch Stay account yet then you can sign up here for a free 14-day trial. Once you have a Touch Stay account, then follow the steps below.

Login to your account

Sign-up or your 14 day free trial

The steps to complete your integration:

• Step 1: Connect your Touch Stay & Avantio accounts
• Step 2: Match Avantio accommodations
• Step 3: Import Avantio units
• Step 4: Complete guide creation (new Touch Stay customers only)
• Step 5: Personalisation settings
• Step 6: Guide sharing options
• Step 7: Sync bookings

Step 1. Connect your Touch Stay & Avantio accounts

First, you need to authorise your Touch Stay account with Avantio and will need an API login and password for this. Avantio support can provide you with your API credentials, reach out to Avantio support and ask for an API login and password to connect to Touch Stay. 

Once you have your API credentials from Avantio, head to the Integrations page within your Touch Stay account, go to the Partners tab and click “Connect” underneath the Avantio logo. Paste your API username and password into the boxes and click Save.

Step 2. Match Avantio accommodations

Once authorised, go to the Match tab to pair any existing Touch Stay guides to your Avantio accommodations. Use the drop-downs to select the correct Avantio accommodation for each Touch Stay guide. When complete, click “Match Selected”. If you don’t have any to match, then just click “Skip”.

Step 3. Import Avantio Units

If you have any remaining unmatched units from Avantio go to the Import tab to import those into Touch Stay. Simply check the ones you want to import and click the “Import Selected” button. If you don’t want to import any, or don’t have any remaining, then just click “Skip” whilst leaving the selections blank.

Touch Stay will import the following:

• Accommodation Name
• Accommodation Address
• Accommodation Location

Each accommodation imported will create a new Touch Stay guide.

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

Matching or importing listings won’t automatically start syncing bookings from Avantio, so now is the time to check the content of your guides and make sure they’re ready before you sync bookings with Avantio.

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 welcome book content.

Step 5: Personalisation settings

You can connect custom field codes created in Touch Stay to additional fields through the Avantio integration. This will then mean any values/data for these fields set in Avantio will pass into Touch Stay and can be added to your Memo message templates and guide content. The available fields are as follows:

• Check-in Schedule (data type: Text)
• Check-out Schedule (data type: Text)
• Booking Code (data type: Number)
• Guest first name
• Guest last name
• Arrival date
• Departure date
• Guest contact phone number*
• Guest contact email address*

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

To connect any of these fields to Touch Stay head to the Custom data mapping tab on the Integrations page and click the Add new mapping button.

From here you can select the Avantio field to connect, choose a name for your custom field code 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, then any future bookings which sync from Avantio will have the relevant data automatically populated on the invitation record. That data will then show in your Memo messages (if you have them) or guide content wherever you have placed the custom field code.

Step 6. Guide sharing options

There are two main ways to send your guide link to guests.

To automatically share a trackable guide link for each booking you can send email or text message guests through Memo, Touch Stay's messaging tool. The bookings from Avantio will then follow your message workflow you setup and any default settings as defined by the templates that you create.

See the Memo help articles for how to add message templates and create a notification journey for your guests.

If you are using Avantio message inbox to communicate with guests you can copy and paste relevant guide link in to you Avantio message templates using the Quick share link that you can copy from the Invite & share tab in the Guides page:

Step 7. Sync bookings

You can now sync bookings (and your Memo messages if you are using them) between Avantio and Touch Stay. Go to Sync bookings tab on the Integrations page.

Here you can choose whether to import all your future bookings or have Touch Stay only import new bookings. If you are new to Touch Stay then choose “All bookings”. If you are already a user of Touch Stay messaging before you connect your Avantio account, then it’s best to choose “New bookings only” to prevent duplicate bookings being imported.

Next, select the booking type statuses you want to be imported, this can be “Confirmed” bookings, fully “Paid” bookings or both.

Finally, select the guides you want to sync using the checkboxes. Use the “Select All” option at the top right of the page to select all in one go. Click Sync selected to submit.

If you have selected “All bookings” then all your future dated bookings from Avantio will now be imported and will generate invitations and schedule email or SMS messages based on the booking details and your Touch Stay message templates. All future bookings for Avantio units matched to Touch Stay guides with the sync active will also now be imported automatically.