Changes

Jump to navigation Jump to search

Auto Actions

10,049 bytes added, 12:01, 14 January 2022
== General Information ==
An Auto Action is an action which can be programmed to run at a specific time relative to the time of the '''booking''', to the '''check -in ''' date or to the '''check -out ''' date.
Auto actions have one or more trigger conditions and one or more actions. They can be triggered on a number of different conditions, like property, time or booking related conditions. Actions can be to send pre-drafted emails/messages or SMS, change booking or invoice information or run webhooks.
*To send Emails automatically you need to set up your outgoing Email address in {{#fas:cog}} (SETTINGS) ACCOUNT -> OUTGOING EMAIL.
*To send Emails manually open a booking and go to the MAIL /Action tab. Manual Emails will open in a window, you may send it as is or edit it before sending.
Some systems have a limit of about 2000 characters for this form of email generation. If the email will not open try reducing the amount of text.
<div class="headline-collapse" >
====Send an message or SMS to Guest when booking made more for last minute booking - 6 days or less====
</div>
<div class="mw-collapsible-content">
Time:
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 365 day
Time
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 1 day
Time
*Trigger Event = After Check-out
*Trigger Time = 30 days
*Trigger Window = 365 days
Time
*Trigger Event = After Booking
*Trigger Time = Immediate
*Trigger Window = 1 day
You will need to create multiple emails to capture the payment multiple times for the same booking.
 
'''Create Auto Action one'''
'''Trigger tab:'''
'''Trigger tab:'''
 
Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1
 
Booking Source:
*Booking Source = All (for example)
 
Booking Conditions:
*Booking Status = All Not Cancelled
 
Booking Fields:
*Booking Field Contains - select "Language" in the next field enter: the short code for the language this Auto Action is for.
</div>
<div class="mw-collapsible-content">
This uses a smart template variable. In this example the auto action will trigger on Booking and for 1 day, we check whether the guest booked in French. If yes, then we send a French text. If no, we send an English text.
'''Trigger tab:'''
 
Set the rules to when this Auto Action should trigger.
 
Time:
*Trigger Event = Booking
*Trigger Time = Immediate
*Trigger Window = 1
 
Booking Source:
*Booking Source = All (for example)
 
Booking Conditions:
*Booking Status = All Not Cancelled
 
'''SMS tab:'''
<div class="headline-collapse" >
====Send Remotelock/Lockstate, Nuki PIN or Chekin Link 2 days before Check-in ====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:'''
 
Time:-
*Trigger Event = Check-in
*Trigger Time = -2 (the number of days before check-in you want to sent the code or link)
*Trigger Window = 2
 
Booking Souce :-
*Booking Source = All
*Booking Status = All but not cancelled
 
Booking Conditions:-
*Group bookings = Trigger all on master
*Info Code = LOCKSTATE_PIN or NUKI_PIN or CHEKIN_URL (select the appropriate Booking Info Code for the service you use)
'''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box. *Send Message = Booking API/Smart Email If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. *Subject - enter the subject for your Guests - Your access code (your text) *Plain text box - will send to channels using Message API Message Text :- enter the text you wish to send to your guests include URL. Include these template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] or [BOOKINGINFOCODETEXT:CHEKIN_PIN] see the list of ALL template variables that can be used [[Template_Variables| see here]] *HTML box - Email will be sent Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Include these template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] or [BOOKINGINFOCODETEXT:CHEKIN_PIN] see the list of ALL template variables that can be used [[Template_Variables| see here]] </div></div> <div class="mw-collapsible mw-collapsed"><div class="headline-collapse" > ====Send Email to guests with check-in details 2 days before Check-in, booking paid/no outstanding balance ====</div><div class="mw-collapsible-content"> This auto action will be sent only when the Invoice Balance of the booking is zero. This can be used to ensure that the checkin details are only sent when the guest has completed the payments.  '''Trigger tab:''' Time:-*Trigger Event = Check-in*Trigger Time = -2 (the number of days before check-in you want to sent the code or link) *Trigger Window = 2 Booking Source:- *Booking Source = All*Booking Status = All but not cancelled Booking Conditions:- *Group bookings = Trigger all on master*Invoice Balance = Zero '''Messaging tab:''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.
*Send Message = Booking API/Smart Email
If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.
*Email Subject - enter the subject for your Guests - Your access code (your text)
*Plain text box - will send to channels using Message API
Message Text :- enter the text you wish to send to your guests . This can include URL. Include these any information that is important for the checkin of the guest, for example the Key code for the door, who to contact if there are any issues, template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]
*HTML box - Email will be sent
Email Text :- It Enter the text you wish to send to your guests this can include URLs. Include any information that is possible to use important for the checkin of the guest, for example the same details (URL) as in Key code for the Plain Text box above. Include these door, who to contact if there are any issues, template variables - [BOOKINGINFOCODETEXT:LOCKSTATE_PIN] or [BOOKINGINFOCODETEXT:NUKI_PIN] can be used, see the list of ALL template variables that can be used [[Template_Variables| see here]]
</div>
<div class="headline-collapse" >
====Send Email to all current guest (Check-in) ====
</div>
<div class="mw-collapsible-content">
'''Trigger tab:''' Time:
*Trigger Event = Check-in
*Trigger Time = Immediate
*Trigger Window = 14(the max number of days your guests can stay)
 
Booking Source:
*Booking Source = All
 
Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled
*Group bookings = Trigger all on masterInfo Codes:
*Any Booking Info Code = CHECKIN
*Exclude Booking Info Code = CHECKOUT
Message '''Messaging tab: ''' For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box. *Send Message = Booking API/Smart Email If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email = Guest address is available the message sends via the channels API messaging systems if possible. *EMail Subject = Enter If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the appropriate details Email. *Email Text = Your text which includes Subject - enter the details subject for your current guests. Guests
*Plain text box - will send to channels using Message API Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]] *HTML box - Email will be sent Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]  <span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkin to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.
</div>
</div>
<div class="mw-collapsible mw-collapsed">
<div class="headline-collapse" >  ====Send Email with a Guest Invoice - PDF attachment====
</div>
<div class="mw-collapsible-content">
You can send Invoice or Booking Template attachments as an attachment to your Guests.  Setup your Invoice go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> INVOICING
Setup your Invoice or Booking Template, go to {{#fas'''Trigger tab:cog}} (SETTINGS) GUEST MANAGEMENT -> INVOICING or {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> BOOKING TEMPLATES'''
Trigger tabTime:
*Trigger Event = Checkout
*Trigger Time = Immediate
*Trigger Window = 1day Booking Source:
*Booking Source = All (or select the appropriate channel/Direct)
 
Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled
*Group bookings = Trigger all on masterInfo Codes:
*Any Booking Info Code = CHECKOUT
Message '''Messaging tab: '''  
*Send Email = Guest API/Smart Email (or one of the other options)
*Attachment = Select an option from the drop down list.
*EMail Subject = Enter the appropriate details
*Email Text = Your text which includes the details for your current guests.
If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. *Attachment = Select the Invoice Template from the drop down list.  *Subject - enter the subject for your Guests *Plain text box - will send to channels using Message API Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]] *HTML box - Email will be sent Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]] <span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkout to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings. If you send Emails with pdf attachment (invoice, booking template) to Alias-Email addresses created by channels the channel might block the attachment so it is not delivered to the guest. Ask your channel about their policy regarding this. Other files can not be attached. We recommend you use a link to a file you upload to your web site.</div></div> <div class="mw-collapsible mw-collapsed"><div class="headline-collapse" > ====Send Email with Booking Registration Form - PDF attachment====</div><div class="mw-collapsible-content"> You can send Booking Template attachments to your Guests.  Setup your Booking Template, go to {{#fas:cog}} (SETTINGS) GUEST MANAGEMENT -> BOOKING TEMPLATES '''Trigger tab:''' Time:*Trigger Event = Booking*Trigger Time = Immediate*Trigger Window = 1 day Booking Source:*Booking Source = All (or select the appropriate channel/Direct) Booking Conditions:*Group bookings = Trigger all on master*Booking Status = All but not cancelled '''Messaging tab:'''  *Send Message = Guest API/Smart Email (or one of the other options) If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email. *Attachment = Select Booking Template from the drop down list.  *Subject - enter the subject for your Guests *Plain text box - will send to channels using Message API Message Text :- enter the text you wish to send to your guests include URL. Template variables can be used [[Template_Variables| see here]] *HTML box - Email will be sent Email Text :- It is possible to use the same details (URL) as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]] <span class="" style="color: #f3e504; font-size: 150%;" >{{#fas:lightbulb}} </span> It is assumed you use the Checkin/Checkout feature in the Dashboard, if not you can either manually add Checkout to your bookings (Booking info tab) or create an auto action to add the Booking Info Codes to the bookings.
If you send Emails with pdf attachment (invoice, booking template) to Alias-Email addresses created by channels the channel might block the attachment so it is not delivered to the guest. Ask your channel about their policy regarding this.
<div class="mw-collapsible-content">
To send an automated Email to the guest then they can check you/the cleaner have to add a unitstatus unit status to the room when it is ready. In this example we used the unit status clean '''Trigger tab:'''
Trigger tabTime:
*Trigger Event = Checkin
*Trigger Time = Immediate
*Trigger Window = 1
 
Booking Source:
*Booking Source = All
 
Booking Conditions
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled
*Group bookings = Trigger all on masterBooking Fields:
*Template Variable = [UNITSTATUS1] Contains = clean
Message '''Messaging tab: '''
*Send Email = Guest API/Smart Email (or one of the other options)
*EMail Subject = Enter the appropriate details
*Email Text = Your text.
If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible.
 
If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the Email.
 
*Subject - enter the subject for your Guests
 
*Plain text box - will send to channels using Message API
 
Message Text :- enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]]
 
*HTML box - Email will be sent
 
Email Text :- It is possible to use the same details as in the Plain Text box above. Template variables can be used [[Template_Variables| see here]]
 
*Attachment :- if you want to send a Booking/Invoice template you can select from the drop down list.
Other files can not be attached. We recommend you use a link to a file you upload to your web site.
This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.
'''Trigger Tab :- '''  Time:
*Trigger Event = Checkin (depending on when you want to notify the guest)
*Trigger Time = -2 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 2
 
Booking Source:
*Booking Source = All
 
Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled
*Group bookings = Trigger all on masterBooking Fields:
*Template Variables = [IFBETWEEN:[TURNOVERDAYS]:0:3:yes|no|no] equal yes
This template variable tests if there is 3 days between the guest booking and the next booking.
'''Message tab :- '''  For channels using the Message API, then enter the text in the Plain text box, for emails enter the text in the HTML box.  *Send Email Message = Guest Booking API/Smart Email (or one  If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the other options)Email. *EMail Email Subject = Enter - enter the appropriate details subject for your Guests *Email Text Plain text box - will send to channels using Message API, enter the text you wish to send to your guests. Template variables can be used [[Template_Variables| see here]] [IF<= :[TURNOVERDAYS]:3:Your textapartment ([ROOMNAME]), using which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [TURNOVERDAYS] extra night(s)|]. We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the template variables number of nights you would like to modify stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.   *HTML box - Email will be sent, enter the specific text in the bookingyou wish to send to your guests. Template variables can be used [[Template_Variables| see here]]
[IF<=:[TURNOVERDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [TURNOVERDAYS] extra night(s)|].
We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.
'''Booking Info Tab :- Optional'''*Booking info code = EXTRANIGHTS,
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night
This example uses fixed values that you have entered into {{#fas:cog}} (SETTINGS) > PROPERTIES > ROOMS > SETUP > ROOM TEMPLATES and standard Template Variables set in the Property/Rooms, useful way to utilise the template variables and different values rather than duplicating auto actions.
'''Trigger Tab :- '''  Time:
*Trigger Event = Checkin (depending on when you want to notify the guest)
*Trigger Time = -2 days (depending on when you want to notify the guest, in this example 2 days before arrival)
*Trigger Window = 2
 
Booking Source:
*Booking Source = All
 
Booking Conditions:
*Group bookings = Trigger all on master
*Booking Status = All but not cancelled
*Group bookings = Trigger all on masterBooking Fields:
*Template Variables = [IFBETWEEN:[VACANTDAYS]:0:3:yes|no|no] equal yes
This template variable tests if there is upto 3 days from previous checkout to check in of current booking.
Message '''Messaging tab :- '''*Send Email Message = Guest API/Smart Email (or one  If the "Mail & Actions" tab contains a "real" Email address the message is sent to the guests Email address. If only a masked Email address is available the message sends via the channels API messaging systems if possible. If no connection to a messaging system is available the message will send to the Email address from the "Mail & Actions" tab of the other options)Email. *EMail Subject = Enter the appropriate details  *Email Plain Text Box = Your text, using the template variables to modify the specific text in the booking.  [IF<=:[VACANTDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [VACANTDAYS] extra night(s)|]. We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.  *HTML Box
[IF<=:[VACANTDAYS]:3:Your apartment ([ROOMNAME]), which you booked for [NUMNIGHT] nights from [FIRSTNIGHTSHORT] to [LEAVINGDAYSHORT] is currently available for up to [VACANTDAYS] extra night(s)|].
We are very happy to offer you to extend your stay a [PROPERTYNAME] at the exceptional rate of [ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night. If you would like to extend your stay then please send an email to our Reservations team [PROPERTYEMAIL] confirming the number of nights you would like to stay and provide your Booking Reservation Number [BOOKID] and Offer ‘EXTRANIGHTS’ for the special Price.
'''Booking Info Tab :- Optional'''
*Booking info code = EXTRANIGHTS,
*Booking Info Description = Upsell email sent [CURRENTDATE] :[ROOMTEMPLATE3][PROPERTYCURRENCYBACK] per extra night
2,864

edits

Navigation menu