Skip to main content

Delivery Dispatch: Configure Notification Triggers

Joyce D. avatar
Written by Joyce D.
Updated this week

Overview

Notification Triggers let you automatically send messages when key delivery events happen - whether it's updating a customer or alerting your internal team. Each trigger has two parts:

  • Trigger + message = what’s sent and when

  • Audience = who gets it (managed through “Destinations”)

This setup makes it easy to reuse messages and send the same alert to different groups.


Notification Triggers

Simply put, Notification Triggers are automated messages sent externally to customers or internally to teams for important actions or steps during the delivery order process.

Each notification is broken down into two primary parts: defining the trigger and message, and identifying the audience. The trigger and message are defined in each Notification Trigger, and the audience is defined in the Destinations section. By separating the trigger and message from the audience, LB Delivery Dispatch makes it easy to send multiple notifications to the same audience.

Within the message section, you will have access to delivery-specific variables that you can use to customize the message to your end customer.

By default, your account will have 3 customer-facing SMS notifications enabled and 2 internal notifications that are disabled. To see these notifications and edit them if necessary, follow these steps:

  1. From anywhere within the LB Delivery Dispatch dashboard, click on the Settings icon.

  2. From the Settings page, under find Integrations section and then select Notifications

  3. On the Notifications page, you can see the 5 default Triggers and select to create a new Trigger


Default Notification Triggers

Each notification serves a different purpose, so let's take a closer look at each one.

The default notifications sent to your end customer are all SMS messages that are triggered upon a status transition from the delivery provider. This means that your end customer will receive an SMS message as the delivery progresses to its eventual completion. All notifications can be easily customized to fit your needs and brand voice, but the default messages are described below.

Notifications Sent to Your End Customer

The messages intended for end customers are configured, and enabled, by default. They are configured to automatically send an SMS message to the phone number that was provided as the drop-off phone number, typically the end customer.

Status transitions to "Pickup Complete"

The first default notification that is triggered happens as soon as LB Delivery Dispatch receives a "Pickup Complete" status from the delivery provider. When this occurs, the provided drop-off phone number will receive the following SMS message:

Your order from {{pickup_business_name}} has been picked up. Stay tuned for more text updates and track the delivery here {{job_tracking_link}}

The {{pickup_business_name}} and {{job_tracking_link}} are variables, as designated by the surrounding curly brackets, or braces, and will be replaced with information specific to each delivery.

The delivery tracking link can be used by the end customer to track the location, ETA, and eventual proof of delivery photo for their delivery.

Status transitions to "Dropoff Enroute"

The next default notification that is triggered happens as soon as LB Delivery Dispatch receives a "Dropoff Enroute" status from the delivery provider. When this occurs, the provided drop-off phone number will receive the following SMS message:

The driver is on their way. They should arrive by {{dropoff_eta}}.

The {{dropoff_eta}} is a variable, as designated by the surrounding curly brackets, or braces, and will be replaced with an ETA specific to each delivery.

Status transitions to "Dropoff Complete"

The final default notification is triggered as soon as LB Delivery Dispatch receives a "Dropoff Complete" status from the delivery provider. When this occurs, the provided drop-off phone number will receive the following SMS message:

Your order from {{pickup_business_name}} has been delivered.

The {{pickup_business_name}} is a variable, as designated by the surrounding curly brackets, or braces, and will be replaced with the pickup business name specific to each delivery.

Internal Facing Notifications

The remaining notifications are intended to help your internal operations run smoothly. They are created by default, but not enabled, because the best recipient of these messages will vary. To enable these notifications, you will need to define where they get sent by creating a Destination, then adding that Destination to the notification(s).

Job Created

The first default notification that could be triggered would happen as soon as a new delivery is created in LB Delivery Dispatch. This notification is helpful if you do not typically sign in to the LB Delivery Dispatch portal, but still want to be notified every time a new delivery is created. The default message that is sent is:

A new job has been created. Track here: {{job_tracking_link}}.

The {{job_tracking_link}} is a variable, as designated by the surrounding curly brackets, or braces, that will send you to the same job tracking link that your end customer will receive upon "Pickup Complete" status.

Job Reassigned

The final default notification on your account could be triggered as soon as a delivery is reassigned from one provider to another. This notification is helpful to keep track of which delivery provider is fulfilling an order. The default message that is sent is:

Task reassigned on job {{job_id}}. Track here: {{job_tracking_link}}.

The {{job_id}} and {{job_tracking_link}} are variables, as designated by the surrounding curly brackets, or braces, that are specific to each job. The {{job_tracking_link}} will send you to same delivery tracking link that your end customer will receive upon "Pickup Complete" status and will allow you to see the new delivery provider assigned to the delivery.


Setting Up Flags

Flags allow teams to be proactive during live delivery operations. You can enable flags for any notification in the Nash history dashboard under the “Flagged” view.

Recommended Triggers

We strongly recommend setting up and enabling these triggers:

  1. Failed to Auto Dispatch (especially important for Webhook Integration): Recommended to send directly to the merchant’s phone or email address. This prevents delays when auto-dispatch fails during peak times or low courier availability.

  2. Address Validation Failed: Notifies when there’s an issue with the customer’s address.

  3. Stuck Status: These notifications prevent deliveries from being late and allow merchants to make more informed decisions. Common scenario: an order stuck in “Assigned Driver” for more than 10 minutes.

Full Trigger Reference

In addition to the recommended triggers above, the following notification triggers are also available:

  • delivery_incident_report – Notifies when a delivery incident is reported.

  • status_changed_too_quickly – Flags when delivery statuses change more rapidly than expected.

  • dropoff_delayed – Flags when dropoff ETA is significantly later than the specified dropoff time.

  • driver_geolocation – Provides updates on driver location.

  • pickup_delayed – Flags when pickup ETA is significantly later than the specified pickup time.

  • driver_location_vs_delivery_status – Flags when driver’s location doesn’t match the reported delivery status.

  • stuck_status – Alerts when a delivery seems to be stuck in a particular status.

  • task_reassignment – Notifies when a delivery task is reassigned.

  • delivery_status_transition – Informs about changes in delivery status.

  • autodispatch_failed – Alerts when automatic dispatching of a delivery fails.

  • address_validation_failed – Notifies when there’s an issue validating an address.

  • order_needs_attention – Alerts when an order requires manual intervention.

  • order_ready_to_fulfill – Notifies when an order is ready for fulfillment.

  • job_creation_failed – Alerts when there’s an error creating a new job.

  • delivery_cancellation_failed – Notifies when a delivery cancellation attempt fails.

  • task_health_status – Provides updates on the real-time status of tasks.

  • internal_driver_not_assigned – Alerts when an internal driver hasn’t been assigned to a task.

  • nash_ai_invalid_pod – Notifies when the AI system detects an invalid proof of delivery photo.


Dynamic Text Options

Here are examples of variables clients can use in notification messages. We add to them regularly, so feel free to request more. Here are examples of triggers you can use to send notifications:

Trigger

Description

delivery_incident_report

Notifies when a delivery incident is reported

status_changed_too_quickly

Flags when delivery statuses change more rapidly than expected

dropoff_delayed

Flags when dropoff ETA is significantly later than the specified dropoff time

driver_geolocation

Provides updates on driver location

pickup_delayed

Flags when pickup ETA is significantly later than the specified pickup time

driver_location_vs_delivery_status

Flags when driver’s location doesn’t match the reported delivery status

stuck_status

Alerts when a delivery seems to be stuck in a particular status

task_reassignment

Notifies when a delivery task is reassigned

delivery_status_transition

Informs about changes in delivery status

autodispatch_failed

Alerts when automatic dispatching of a delivery fails

address_validation_failed

Notifies when there’s an issue validating an address

order_needs_attention

Alerts when an order requires manual intervention

order_ready_to_fulfill

Notifies when an order is ready for fulfillment

job_creation_failed

Alerts when there’s an error creating a new job

delivery_cancellation_failed

Notifies when a delivery cancellation attempt fails

task_health_status

Provides updates on the real-time status of tasks

internal_driver_not_assigned

Alerts when an internal driver hasn’t been assigned to a task

nash_ai_invalid_pod

Notifies when the AI system detects an invalid proof of delivery photo


Creating and enabling Destinations

Internal notifications are not active by default. In order to activate them, you will need to create a Destination and add it to each notification.

Destinations and multi-channel options:

  • Notifications can be sent to multiple channels (“Destinations”), including email, Slack, SMS, Webhook, WhatsApp, Help Desk, Voice AI, Zendesk, or Pylon.

  • To use multiple channels, duplicate the automation process and set a separate trigger for each destination.

  • You can also enable Flag Delivery to mark failed auto-dispatch deliveries.

  • Custom events can be added to delivery activities, making it easier to identify and sort issues on the delivery page.

  • Notifications contain details about the problem and include a direct Job ID link for quick reference.

  • Flags: Flags allow teams to be proactive during live delivery operations. You can enable flags for any notification in the Nash history dashboard under the “Flagged” view.

Once the Destination has been enabled, create a notification Trigger and select the destination accordingly.

Destination Options

Variable

Description

Customer

{{customer.first_name}}

The customer’s first name (in dropoff address)

{{customer.last_name}}

The customer’s last name (in dropoff address)

{{customer.phone_number}}

The customer’s phone number

The customer’s email address

{{customer_feedback_link}}

The URL for the customer to provide feedback

Pickup

{{org_name}}

Name of your organization in Nash

{{pickup_business_name}}

The business name from where the order(s) were picked up

{{pickup_business.phone_number}}

The phone number associated with pickup location

{{pickup_location.email}}

The email address associated with the pickup location

{{pickup_eta}}

The pickup ETA

{{pickup_datetime}}

The actual pickup datetime localized to the pickup location

Dropoff

{{dropoff_eta}}

The dropoff ETA

{{dropoff_datetime}}

The dropoff datetime localized to the dropoff location.

{{dropoff_business_name}}

The dropoff business name.

{{dropoff_location.address_first_line}}

The first line of the dropoff address

{{proof_of_delivery_photo_url}}

The URL link to the photo proof of delivery

Job

{{job_id}}

The job ID e.g. job_oBDDbYnKFCHAfivtjMoabt

{{job_cfg_id}}

The job configuration ID e.g. cfg_SuC7dAU8VErdhzx9Wa345k

{{job_metadata.X}}

Pulls from the key X in job_metadata. X can be any field

{{job_tracking_link}}

The link to track the job

{{job_details_url}}

The URL to view job details

{{job_external_identifier}}

The external ID of a job

{{job_feedback_url}}

The URL for providing job feedback

Delivery Provider

{{provider_delivery_id}}

The delivery ID provided by the delivery provider

{{provider_name}}

The name of the delivery provider

The name of the driver/courier

{{driver.phone_number}}

The phone number of the driver/courier

{{delivery_incident_report_type}}

The type of the delivery incident

{{delivery_incident_report_message}}

The message contained in the delivery incident

Nash

{{nash_order_id}}

The Nash order ID

{{nash_order_portal_url}}

The URL to view the order in the Nash portal

{{nash_order_validation_errors}}

Any validation errors associated with the Nash order

{{nash_order_external_id}}

The external ID of the Nash order

{{nash_order_pickup_location.email}}

The email associated with the pickup location for the Nash order

{{nash_order_dropoff_location.email}}

The email associated with the dropoff location for the Nash order

{{nash_order_pickup_business_name}}

The business name of the pickup location for the Nash order

{{nash_order_dropoff_business_name}}

The business name of the dropoff location for the Nash order

{{nash_order_pickup_time}}

The pickup time for the Nash order

{{reference_id}}

The order’s reference ID

Misc

{{request_id}}

The ID of the request as generated by Nash’s API service. Helpful for debugging purposes.


Did this answer your question?