Communication is a highly adaptable service designed to inform any type of message to anyone. It can define messages that are automatically sent to users through various channels when the order status changes.
Components of an Automated Message
An automated message defined within the communication service comprises seven components:
Channels
Recipients
Trigger
Order Type
Tags
Title
Body
Below, we elaborate on the different components of an automated message.
Channels
Channels represent the methods of user communication. The following four channels are available for sending automated messages:
SMS
Email
Push Notification
Webhook
SMS
When SMS is chosen as one of the automated message channels, an SMS is sent to recipients through the integrated SMS service provider.
Email
Selecting Email as an automated message channel results in sending an email to the recipients.
Push Notification
A push notification is a message "pushed" from the backend server to user applications. On mobile devices, push notifications typically appear promptly upon receipt.
Webhook
This channel allows setting up a webhook, with the option to have multiple webhooks with different endpoints.
Note: When defining an automated message, more than one communication channel can be specified. For instance, a single automated message could be sent through all three channels mentioned above. However, it's important to note that messages are sent through these channels only if the user is reachable via the selected channel. For example, if drop-off contact numbers aren't registered in the order information, an SMS won't be sent. Similarly, if customers haven't installed the Customer Application on their phones, they won't receive push notifications.
Recipients
Recipients are the users to whom automated messages are sent. When creating an automated message, recipients can be selected from the following options:
Individual Customer
Business Customer
Driver
Pickup Contact
Dropoff Contact
Individual Customer
Refers to the customer who places an order, such as a user ordering an on-demand courier service to send a package to a friend.
Business Customer
Business customers use your services for their business operations. For example, a restaurant using your service to deliver food.
Driver
Drivers play a crucial role in fulfilling orders. They can be selected as recipients when creating automated messages.
Pickup Contact
The person placing an order may not necessarily be the one at the pickup location. This contact is designated as the Pickup Contact and can be different from the customer placing the order.
Dropoff Contact
The Dropoff Contact is a user typically present at the drop-off location. Since an order can have multiple drop-offs, the customer can provide separate phone numbers for each drop-off's contact person.
Note: Currently, communication with Pickup or Dropoff contacts is possible via email and phone number.
Trigger
The communication service sends automated messages based on specified events during message creation. These events, known as Triggers, usually correspond to order statuses or any event related to the order. Ten triggers are available, with only one selectable per automated message creation:
Assigned
Unassigned
Started
Arrived
Picked up
Done
Dropoff Done
Customer Canceled
Driver Canceled
Support Canceled
All these triggers, except Dropoff Done, are order statuses that occur when the order status changes.
Order Type
When defining an automated message, the order type can be specified. In such cases, the automated message is sent only for orders of the specified type. For example, an automated message defined for On-demand orders will be sent only for such orders.
Tags
Automated messages convey order status information. To facilitate this, order information can be inserted using tags. When a tag is specified in the automated message definition, the server replaces the tag with the corresponding order information when sending the message. The order information that can be replaced with tags includes:
Driver Given Name
Driver Family Name
Customer Name
Driver Name
Vehicle Plate
Vehicle Color
Vehicle Model
Track Link
Receipt Link
Order Price
Order Code
Pickup Address
Dropoff Address
Dropoff Contact Name
POD Photo
POD Signature
POD Note
Cash On Delivery
Title
Messages generally have titles, regardless of whether they are SMS, push notifications, or emails. For emails, the title becomes the email's subject.
Body
The message body is the primary content of the message. While setting up an automated message, the Body section can contain a combination of static text and Tags.