How to Create a Customised SMS Message Template in MachShip

How to Create a Customised SMS Message Template in MachShip

If you wish to set up for MachShip to send out SMS notifications of delivery milestones and updates to clients upon despatching or status updating of freight you will need to configure an SMS Template. This template allows clients to configure a customised SMS message with functionality to allow for different messages based on milestone, carrier, and client. 

How to navigate to Create an SMS Template

Select Admin and then select Other Options


Via the Advanced panel on the left-hand side select Tracking Update Notifications


How to Create an SMS Template

To create an SMS Template select the Create Tracking Update Notifications option or the other option in the top right-hand corner

1. Set the Name

This is a free text field and would identify the SMS message for your purposes - it is not utilised in the text message that is sent


2. Set the Company
Select the company you wish to assign the SMS notification to by typing and selecting the relevant company. 
3. Notification Type
Select the "SMS option 


4. Template

Here you would set the template for what the SMS message should say. MachShip's templating engine uses the Mustache templating platform which allows you to insert dynamic values into the SMS content. MachShip has a number of saved consignment fields that can be utilised in the message including:

  • FromName - From Location Name
  • FromAddressLine1 - From Location Address Line 1
  • FromAddressLine2 - From Location Address Line 2
  • FromSuburb - From Location Suburb
  • FromPostcode - From Location Postcode
  • FromStateCode - From Location State Code
  • FromContact - From Contact name
  • FromEmail - From Email Name
  • FromPhone - From Location Phone Name
  • ToName - To Location Name
  • ToAddressLine1 - To Location Address Line 1
  • ToAddressLine2 - To Location Address Line 2
  • ToSuburb - To Location Suburb
  • ToPostcode - To Location Postcode
  • ToStateCode - To Location State Code
  • ToContact - To Contact Name
  • ToEmail - To Email Address
  • ToPhone - To Location Phone Number
  • CarrierName - Delivery Transport Carriers Name
  • CarrierConsignmentId - Carriers Consignment Number
  • CompanyEmail - Saved Company email Address
  • CustomerReference - Customer Reference 1
  • CustomerReference2 - Customer Reference 2
  • FriendlyEtaShort - ETA Date Time Short (i.e 6/11/2020)
  • FriendlyEtaLong - ETA Date Time Long (i.e Friday, 6 November 2020)
  • Now- The current date and Time
  • FriendlyEtaWithOrdinalIndicator - The ETA in format: 6th November, 2020
  • DeliveryComingToday - Will insert "Whether the delivery is scheduled to arrive today"
  • PublicUrl - MachShip Tracking Page
  • NewStatus - New Status Update
  • OldStatus - Old Status Previous Status Update
  • CompanyName - Name of the Company in MachShip
  • SupportCompanyName - Company Support Name
  • SupportPhone - Company Support Phone
  • ServiceCode - Service Code for the delivery in MachShip
  • CarrierAbbreviation - The abbreviation of the carrier name that is delivering the freight
  • FirstNameFormatted - This will return the Contact Name formatted to return a single name in Title Case (e.g. james brown will return as James)
  • DeliveryWindow - The delivery window for the consignment - Depends on factors, e.g. whether arriving today. E.g. If the pickup and delivery days (local) are the same: 8:00am and 5:00pm, Friday 10th June, 2016 If the pickup and delivery days (local) are different: 8:00am, Friday 10th June and 5:00pm, Saturday 11th June, 2016
  • DeliveryWindowV2 - The Delivery window for the consignment - Depends on factors, e.g. whether arriving today. 
  • ToAddressFormatted - Returns the ToAddress comma delimited, skipping over blank fields (Includes: ToName, ToAddressLine1, ToAddressLine2, ToSuburb, ToStateCode and ToPostcode)

To utilise these in an SMS message you would surround the consignment field with "{{ }}"

Examples for each of these is below:

  • {{FromName}}
  • {{FromAddressLine1}}
  • {{FromAddressLine2}}
  • {{FromSuburb}}
  • {{FromPostcode}}
  • {{FromStateCode}}
  • {{FromContact}}
  • {{FromEmail}}
  • {{FromPhone}}
  • {{ToName}}
  • {{ToAddressLine1}}
  • {{ToAddressLine2}}
  • {{ToSuburb}}
  • {{ToPostcode}}
  • {{ToStateCode}}
  • {{ToContact}}
  • {{ToEmail}}
  • {{ToPhone}}
  • {{CarrierName}}
  • {{CarrierConsignmentId}}
  • {{CompanyEmail}}
  • {{CustomerReference}}
  • {{CustomerReference2}}
  • {{FriendlyEtaShort}}
  • {{FriendlyEtaLong}}
  • {{FriendlyEtaWithOrdinalIndicator}}
  • {{DeliveryComingToday}}
  • {{PublicUrl}}
  • {{NewStatus}}
  • {{OldStatus}}
  • {{CompanyName}}
  • {{SupportCompanyName}}
  • {{SupportPhone}}
  • {{ServiceCode}}
  • {{CarrierAbbreviation}}
  • {{FirstNameFormatted}}
  • {{DeliveryWindow}}
  • {{DeliveryWindowV2}}
  • {{ToAddressFormatted}}

Sample Messages could be

Hi {{ToName}}

Your Order # {{CustomerReference}} from MachShip has been Despatched and is due to be delivered on {{FriendlyEtaShort}} with {{CarrierName}}

Please refer to the link below to see live status updates

{{PublicUrl}}

If you have any queries please dont hesitate to get in contact with us at 03 9999 9999


MachShip Template:


This would then generate the below for this consignment:


 

SMS Output:

Hi Tom

Your Order # REF1234 from MachShip has been Despatched and is due to be delivered on 11/11/2020 with Camerons Transport

Please refer to the link below to see live status updates

c.dev.gotke.me/H65bMccwokGOUd7TDT34LE1g

If you have any queries please don't hesitate to get in contact with us at 03 9999 9999

For further examples of the Mustache templating platform and more advanced use cases, please read the documentation available via the Mustache manual. If you have any queries or questions, please contact support@machship.com who can help.


5. Link to a Company, Carrier and Status

To link the SMS template that you have created to a company first select - Add Company Link


This will then give you the option to link to:

I. Company (Required)

Select the company you wish to assign the SMS Template to by typing and selecting the relevant company. To set this for a whole organisation simply type in the parent company and select the inheritable option

II. Tracking Status (Required)

Each SMS Template will need to be linked to a tracking status - the flagging of this status - either manually or from the carrier will prompt the sending of the SMS message. To link a status select from the drop-down:


Once selected the status will show as below:


III. Carrier (Optional)

If you wish to link this SMS to a particular carrier or carrier(s) simply type in the carrier name and select from the typeahead


To add a second carrier simply follow the same process


To remove a carrier simply select the X


Note if you wish to have this SMS flagged for ALL carriers - simply leave the selection field empty

If you wish to link this SMS template to multiple Carrier Status's or Companies - simply select the Add Company Link and repeat the process above


6. Set the SMS as Enabled

To enable the SMS and set it live - simply select the Enabled Flag to Yes 
for the SMS Template and SMS Template Company Links


7. Save the Tracking Update Notification

The SMS is now Live.


    • Related Articles

    • How to create a Company in MachShip

      Companies in MachShip are the basis by which accounts, permission, and access are separated and maintained. Below you will find instructions on how to create and edit a company. What is a Company? Companies in MachShip are assigned and hold the data ...
    • How To Create Custom Fields

      Custom Fields can be used in MachShip to customise the existing reference fields to match up with your company's own internal references, such as Purchase Orders, Cost Centres or Invoice Numbers. This customisation can be undertaken on the ...
    • How to create a Company Location Group

      The Location Group system in MachShip is used to connect locations together for use with the Batch Consignments creation method. How to navigate to the Create Location Group Page There are 2 ways to reach the Create Location Group page. 1. ...
    • How to create a Custom Notification

      Notifications advise users of MachShip of events such as cancellations of consignments, pick up bookings, partial deliveries or requests for important consignments. These are all known as system generated notifications. In order to provide Freight ...
    • How to create a Company Contact

      What is a Company Contact? Company structures are complex, and MachShip understands that, at times, key contacts within your business need to be informed about certain events which have happened. By creating a Company Contact in MachShip, you allow a ...