How do I create a user message?

Overview

User messages are messages that can be sent to users either manually from the order monitor or automatically during some order flows (like smart lockers). User messages are set up by location in the Communications tab and sent from each order in the order monitor. This article includes system settings, instructions for setting up user messages, a breakdown of supported message types, and supported variables that can be used in message templates. 

To send messages via SMS or Whatsapp, you will need a Twilio, Zingle, or Sinch account and we will need to configure the integration. 

Order Monitor Messages and System Settings

Order Monitor messages are messages that are sent to users from the order monitor. They can be sent as emails or SMS, depending on the device type of the order and configuration. All orders should have the option for email messages. If the order was placed from a client app where the system setting SMSProvider is present, it should have the SMS option. 

The following setting controls the default setting for sending messages from the order monitor.

Setting Type	Setting Name	Default Value	Potential Values
Restaurant / OrderMonitor	CustomerMessage	Email	Email / SMS

Creating User Messages

1. Go to the Communications tab.
2. Select your brand/location.
3. Click ADD NEW.

4. Select the appropriate message type. See the section below for more information on the different user messages that Tacit supports.
5. Enter the message in English and French (If applicable).
6. Click SAVE.

Message Types

The below table includes all message types supported by Tacit.

Message Type	Description
Order Monitor Message	Email message that can be sent to the customer via order monitor.
User SMS	SMS message that can be sent to the customer via order monitor when SMS messaging has been configured and the SMS toggle is on.
Order SMS	Automatic SMS message sent to the customer when an order is placed.
Decline Message	Automatic message sent to the customer when an order is declined in the order monitor.
Cancel Message	Automatic message sent to the customer when an order is cancelled in the order monitor.
KDS Customer Notification	Message sent to customer using the KDS (KDS Configuration is required for this message type).
Apex Locker Automatic Notifications	Apex Locker integrations include several automatic messages that are sent at various stages of the ordering process. For a detailed breakdown of all Apex Locker Notifications, visit Apex Smart Locker Integration.

Variables

Tacit supports a list of variables that can be used to enhance your user messages. Variables are included in messages by typing the desired variable in double brackets {{like this}}. For example, writing your template as:

Hi {{FirstName}}, your order {{Event.CustomerOrderNumber}} is delivered. Use {{Event.PickupCode}} to open the locker.

Would automatically produce a result like the following when the message is sent:

Hi John, your order #1234 is delivered. Use code 5678 to open the locker.

Below is a list of all variables that can be added to user message templates. All variables beginning with Event. are unique to Apex Smart locker integrations and should not be used for other message templates.

FirstName LastName TableOrderId Linked to the Tacit order ID OrderId Linked to the POS order ID BrandLogoColorURL BrandPrimaryColor Event.DeliveryId Event.CustomerOrderNumber Event.DeliveryCode Event.PickupCode Event.ReclaimCode Event.AccountId Event.AccountName

Event.ClientId Event.ClientName Event.LocationId Event.LocationName Event.PouId Event.PouName Event.InventoryPositionName Event.PackageId Event.Action Event.Status Event.ActionTime Event.ActionTimeLocal Event.Description Event.TimezoneLocal