Skip to main content
All CollectionsCommunication
How communication works
How communication works

Send automated messages to your driver, customer, dispatcher & admin user, pickup & dropoff contact via sms, email, notifications & webhooks

Updated this week

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:

  1. Channels

  2. Recipients

  3. Trigger

  4. Order Type

  5. Tags

  6. Title

  7. 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.

Did this answer your question?