Notifications Placeholders for SMS & Email Customer Notifications

In addition to the custom text in your notification messages, you can also use multiple informative placeholders that retrieve data from particular Route4Me fixed attributes (i.e., order numbers, customers’ names, estimated arrival times, geofence-entered/departed timestamps, etc.) and automatically insert this data into your notifications as text. Thus, you do not need to waste valuable time on finding, copying and pasting a particular order number or customer’s name into each notification. All you need to do is insert one or multiple preferred placeholders into a particular notification, and the route optimization system will automatically generate a personalized message for each customer, containing the custom text and the data pulled from the corresponding fixed attributes.

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

All notification types (E-Mail and SMS) are sent to the customers/prospects whose contact information is defined in the Customer section of the corresponding route stops. The Customer section of each route stop can be accessed and modified using the Route Editor in real-time.

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Below, you can find all available placeholders that can be used for retrieving data from Route4Me fixed attributes and inserting this data into your Customer Notifications.

PlaceholderRoute4Me Fixed AttributeDescriptionExample of Retrieved Data
{{address}}AddressStreet address of the customer associated with the corresponding stop.405 Lexington Ave, New York, NY 10174, USA
{{alias}}AliasA user-defined name assigned to a customer/stop for internal use.Customer 001
{{lat}}Lat, LngLatitude coordinates of the customer’s location.40.751868
{{lng }}Lat, LngLongitude coordinates of the customer’s location.-73.975554
{{address_stop_type}}Address Stop TypeThe type of the corresponding stop on the route.Pickup, Delivery, Break, Meetup, Visit, Service, or Drive By.

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Placeholder Route4Me Fixed AttributeDescriptionExample of Retrieved Data
{{now_date}}Address Visit DetailsThe current date when the corresponding notification was triggered and sent to the customer. The format of this date can be adjusted in the advanced settings10.10.2019
{{now_time_formatted}}Address Visit DetailsThe current time when the corresponding notification was triggered and sent to the customer. The format of this time can be adjusted in the advanced settings04:10 PM
{{geofence_detected_visited_timestamp}}Detected as VisitedThe timestamp that was automatically generated by the system when the driver entered the geofenced area set around the address.07/07/2019 05:00 PM
{{geofence_detected_departed_timestamp}}Detected as DepartedThe timestamp that was automatically generated by the system when the driver left the geofenced area set around the address.07/07/2019 05:00 PM

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Placeholder Route4Me Fixed AttributeDescriptionExample of Retrieved Data
{{order_no}}Order NoThe order number associated with the stop.QA000007188
{{cost}}CostThe cost of visiting and servicing the stop.100
{{cube}}CubeThe cubic volume of the cargo/order that is being delivered to or picked up at the stop.0.5
{{invoice_no}}Invoice NoThe order invoice number associated with the stop.ALT12341
{{pieces}}PiecesThe number of pieces (items) that are being delivered to or picked up at the stop.20
{{reference_no}}Reference NoThe order reference number associated with the stop.789
{{revenue}}RevenueThe revenue that is expected to be generated from visiting and servicing the stop.1000
{{weight}}WeightThe weight of the cargo/order that is being delivered to or picked up at the stop.100
{{sequence_no}}PriorityThe sequence number/position of the stop on the corresponding route.1
{{tracking_number}}Tracking NumberThe tracking number that is automatically assigned to the order by the system. Tracking numbers can be used by customers for checking their orders on the customer tracking portal.E27YMNGK

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Placeholder Route4Me Fixed AttributeDescriptionExample of Retrieved Data
{{name}}First Name + Last NameFull name (first name and last name) of the customer/prospect associated with the stop.John Smith
{{first_name}}First NameFirst name of the customer/prospect associated with the stop.John
{{last_name}}Last NameLast name of the customer/prospect associated with the stop.Smith
{{email}}E-mailContact e-mail address of the customer/prospect associated with the stop.[email protected]
{{phone}}PhoneContact phone number of the customer/prospect associated with the stop.+1 212-682-3070
{{customer_po}}Customer POPurchase order of the customer/prospect associated with the stop.PI000347

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Placeholder Route4Me Fixed AttributeDescriptionExample of Retrieved Data
{{time_window_start}}Time Window StartThe start of the stop’s time window (normally used for opening hours).09:00 AM
{{time_window_end}}Time Window EndThe end of the stop’s time window (normally used for closing hours).09:00 PM

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Placeholder Route4Me Fixed AttributeDescriptionExample of Retrieved Data
{{arrival_time_formatted}}Planned Arrival TimeThe estimated time when the driver is expected to arrive at the stop. The format of this time can be adjusted in the advanced settings.4:10 PM
{{arrival_date_formatted}}Planned Arrival DateThe estimated date when the driver is expected to arrive at the stop. The format of this date can be adjusted in the advanced settings.07.07.2019
{{earliest_time_formatted}}Planned Arrival Time with ETA PaddingThe estimated time of arrival minus 50% of the defined “ETA Padding” value (i.e., minus 5 minutes from the estimated arrival time). The format of this time can be adjusted in the advanced settings.2:10 PM
{{max_arrival_time_formatted}}Planned Arrival Time with ETA PaddingThe estimated time of arrival plus 50% of the defined “ETA Padding” value (i.e., plus 5 minutes to the Estimated Arrival Time). The format of this time can be adjusted in the advanced settings.1:50 PM

Using Placeholders with Customer Alerting and Notifications - Inserting Route4Me Fixed Attributes into Notifications

 

Custom Data Notifications Placeholder

The Custom Data notification placeholder allows you to automatically attach Custom Data to your SMS and Email notification messages. To use the Custom Data Placeholder, first, add the preferred Custom Data fields and values to one or multiple route destinations.

Next, insert the Custom Data placeholder into the preferred SMS or Email Notification Type message. The first part of the placeholder “{{custom_fields.” should be unchanged, and the second part of the placeholder should contain the name of the Custom Data Field that contains the value which you want to attach to the message, i.e., “item_1}}”.

PlaceholderRoute4Me AttributeDescriptionPlaceholder Example
{{custom_fields.}}Custom DataCustom Data attached to route destinations.{{custom_fields.item_1}}

Add custom data placeholder to your Email and SMS messaging customer notifications and alerts.

 

In the example below, if you use the following Custom Data placeholder: “{{custom_fields.item_1}}” the value (Custom Data 1) from the corresponding Custom Data field (item_1) will be attached to the message.

  • Sample message with placeholder: Your order will include {{custom_fields.item_1}} and {{custom_fields.item_2}}
  • Received notification message: Your order will include Custom Data 1 and Custom Data 2

Use an underscore to separate words in Custom Data values.

Add custom data to route destinations and send it to customers in action-triggered notifications

 

Placeholders by Notification Type

The table below provides the list of all placeholders that are supported for the corresponding notification types.

PlaceholderRoute ScheduledGeofence EnteredGeofence DepartedVisit CompletedNotify Next Customer
{{now_date}}
{{now_time_formatted}}
{{arrival_time_formatted}}
{{arrival_date_formatted}}
{{earliest_time_formatted}}
{{max_arrival_time_formatted}}
{{address}}
{{first_name}}
{{last_name}}
{{name}}
{{tracking_number}}
{{customer_po}}
{{invoice_no}}
{{reference_no}}
{{order_no}}
{{weight}}
{{distance_to_next_destination}}
{{alias}}
{{lat}}
{{lng}}
{{address_stop_type}}
{{cost}}
{{cube}}
{{pieces}}
{{revenue}}
{{sequence_no}}
{{email}}
{{phone}}
{{geofence_detected_departed_timestamp}}
{{geofence_detected_visited_timestamp}}
{{timestamp_last_visited}}
{{timestamp_last_departed}}

 

 

Visit Route4Me's Marketplace to Check out Associated Add-Ons:

Was this article helpful?
Still can't find what you're looking for? Contact us
Route4Me

About Route4Me

Route4Me has over 40,000 customers globally. Route4Me's Android and iPhone mobile apps have been downloaded over 2 million times since 2009. Extremely easy-to-use, Route4Me's apps create optimized routes, synchronize routes to mobile devices, enable communication with drivers and customers, offer turn-by-turn directions, delivery confirmation, and more. Behind the scenes, Route4Me's operational optimization platform combines high-performance algorithms with data science, machine learning, and big data to plan, optimize, and analyze routes of almost any size in real-time.