---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/en/extras/sms-setting.md
  - https://yandex.kz/routing/doc/kk/extras/sms-setting.md
  - https://yandex.kz/routing/doc/ru/extras/sms-setting.md
  - href: en/extras/sms-setting.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
title: "RouteQ\_— setting up SMS notifications"
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/en/llms.txt


# Setting up SMS notifications

You can set up automatic SMS notifications for any order updates and enable confirmation by SMS code.


There are two types of SMS notifications: [regular SMS notifications](#sms-notification) and [delivery confirmations codes](#sms-confirmation).

## SMS notifications {#sms-notification}

A standard SMS notification text must include:

- Company name.
- Order number.
- Courier tracking link with the tracking ID

For information on changing the standard text, see [Custom SMS messages](#customization).
  
The company name is copied from the Routing Workspace [settings](https://yandex.kz/routing/doc/en/delivery/interface/company.md).

Order ID provided in the SMS and [widget](https://yandex.kz/routing/doc/en/delivery/interface/company.md#feedback-sections) is taken from [Track & Trace](https://yandex.kz/routing/doc/en/delivery/index.md) or the client's external system, depending on the settings:

#|
|| **Option in Track & Trace: From the system** | **Option in Track & Trace: External customer number** | **Number from the client's external system: Specified/Not specified** | **Displayed number** ||
|| <!-- diplodoc:svg ![](_images/check.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/check.svg)   --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg>| From Track & Trace ||
|| <!-- diplodoc:svg ![](_images/check.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | From Track & Trace ||
|| <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/check.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/check.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg> | From the client's external system ||
|| <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/check.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 13.00" width="16.00" height="13.00"><path fill="#fece06" d="   M 14.06 0.00   L 16.00 0.00   L 16.00 1.81   L 6.69 13.00   L 4.94 13.00   L 0.00 7.44   L 0.00 5.94   C 2.21 3.92 4.10 7.71 5.56 9.07   Q 5.97 9.45 6.33 9.02   L 14.06 0.00   Z"/></svg> | <!-- diplodoc:svg ![](_images/cross.svg) --><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg xmlns="http://www.w3.org/2000/svg" version="1.1" viewBox="0.00 0.00 16.00 16.00" width="16.00" height="16.00"><path fill="#ababab" d="   M 0.00 0.00   L 2.81 0.00   L 7.71 4.94   Q 8.15 5.39 8.56 4.90   Q 10.95 2.03 14.06 0.00   L 16.00 0.00   L 16.00 2.56   L 11.03 7.70   Q 10.64 8.12 11.04 8.52   L 16.00 13.56   L 16.00 16.00   L 13.44 16.00   L 8.46 11.21   Q 8.00 10.76 7.52 11.20   L 2.44 16.00   L 0.00 16.00   L 0.00 13.94   L 4.95 8.44   Q 5.33 8.02 4.94 7.62   L 0.00 2.44   L 0.00 0.00   Z"/></svg> | From Track & Trace ||
|#

{% note info %}

If the order number is longer than 12 characters, it'll be truncated in the SMS. For example, `1234*2122`.

{% endnote %}

For more information on filling in the fields in Track & Trace, see [Description of fields](https://yandex.kz/routing/doc/en/delivery/interface/orders.md#order-card-table).

### Setting up SMS notifications {#interface-settings}

Set up SMS notifications in the interface: for [company](#interface-settings-company) or [couriers](#interface-settings-courier).

#### **For company** {#interface-settings-company}

You can set up SMS notifications in Routing Workspace: **Settings** → **Company** → **SMS**.

![](./_images/sms-company.png)

If the **Send to all clients** option is:

- Enabled, SMS will be sent in the routes of all couriers regardless of the settings for individual couriers.
- Disabled, SMS will only be sent in the routes of couriers with the sending option activated.

The table below shows different combinations of company and courier settings and the resulting action. The company settings take priority over the courier settings.

#|
|| **SMS for the company** |  **SMS for the courier** | **SMS sent for courier** ||
|| Yes | Yes | Is sent ||
|| Yes | No | Is sent ||
|| No | Yes | Is sent ||
|| No | No | Is not sent ||
|#

Types of notifications are set by the options:

- **Send at the beginning of the route**;
- **Send before the courier arrives**

You can choose both options or only one. For example, if couriers' routes start very early, you can disable sending an SMS at the start of the route to avoid disturbing clients if they're still asleep.

You can also specify the following in the company settings:

- **Interval between the delivery time and the SMS message** (by default, 1800 seconds, or 30 minutes).
- **Sending time** is the time window when messages can be sent. The SMS won't be sent if the courier's route starts earlier or later than this interval.

#### **For couriers** {#interface-settings-courier}

SMS notifications for individual couriers are set up in the Track & Trace settings: **Track & Trace** → **Couriers**.

{% list tabs %}

- In the general list of couriers

    Enable the **SMS** option next to the username of the appropriate courier.

- On the courier page

    Enable the **Send SMS to clients** option at the top-left of the page.

{% endlist %}

### Conditions for sending {#sms-notification-condition}

The notification is sent if the following conditions are met:

- The order contains one phone number in the format +7XXXXXXXXXX.
- The courier logged in to the [RouteQ](https://yandex.kz/routing/doc/en/rq-app/index.md) app and selected a route.
- The courier's geolocation data is received in real time.
- The courier started the route within the specified order time window (before the order's ETA).
- The order status isn't **Delivered** or **Canceled**.

{% note info %}

An SMS is sent for each order, even if multiple orders have the same recipient.

For example, if a route has three orders at the same location to the same customer with the same phone number. This means an SMS will be sent to the recipient for each order. To avoid this, you can provide the phone number only for one order.

{% endnote %}

### Route start notification {#sms-start}

#|
|| **Property** | **Value**||
|| Notification type | `shift_start` ||
|| Message text | Your order \<order number> from \<company name> is on its way: `https://yandex.ru/courier/tracking/<track ID>`. ||
|| Sending time | Simultaneously for all orders on the route. ||
|#

Conditions for sending an SMS depend on the courier's starting location:

{% list tabs %}

- Start from a depot

    All of the following conditions must be true:

    - The route start time has come (the `route_start` parameter), or the earliest delivery window comes no later than in 5 hours.
    - The courier launched the app and selected a route (started sending coordinates for the route).
    - The depot at the beginning of the route was marked as visited (via the mobile app or API).

- Start not from a depot

    All of the following conditions must be true:

    - The route start time has come (the `route_start` parameter), or the earliest delivery window comes no later than in 5 hours.
    - The courier launched the app and selected a route (started sending coordinates for the route).
    - The courier is not within the depot radius if the `mark_route_started_radius` parameter is set for the depot.
    
    Since the courier starts the route from the first order or a garage rather than a depot, SMS notifications depend on the depot radius — the system registers the courier's coordinates outside the area of the depot linked to the route.

{% endlist %}

### Notification before the courier arrives {#sms-nearby}

#|
|| **Property** | **Value** ||
|| Notification type | `nearby` ||
|| Message text | Your order from \<company name> will arrive in \<remaining time before order arrival, min> min: `https://yandex.ru/courier/tracking/<tracking ID>`.

The following text variant is also available: "Your order \<order number> will arrive in \<remaining time before order arrival, min> min." To choose it, contact support. ||
|| Sending time | N minutes before arrival at the order location (see [SMS settings for companies](#interface-settings-company)). ||
|#

Conditions for sending an SMS:

- The courier follows the order sequence.
- The [expected time for creating a notification](#notification-time) has come.

### Notification creation time {#notification-time}

The notification creation time depends on the [estimated time of arrival (ETA)](https://yandex.kz/routing/doc/en/delivery/functions/eta.md) calculation method.

The Estimated Time of Arrival (ETA) is calculated by Track & Trace every few minutes based on incomplete and active orders on the route. The estimate is based on current traffic and road condition data.

The ETA calculation method is determined by the company, but you can [change](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/editsOrder) it for an individual order in the `eta_type` field. There are two ETA calculation methods available in Track & Trace: `arrival_time` and `delivery_time`.


### Comparison of ETA calculation types {#notification-eta}

#|
|| **Property\Type** | **arrival_time** | **delivery_time** ||
|| **Used by default** | yes | no ||
|| **Order time window** | soft | hard ||
|| **Notification creation time** | N seconds before the start of the delivery.

{% cut "Explanation" %}

N is the time window when to send an SMS before the estimated arrival time. [Learn more](#interface-settings-company)

The start of delivery is the estimated time of arrival (ETA).

{% endcut %}

| N seconds before the start of delivery, but not before the delivery window.

{% cut "Explanation" %}

N is the time window when to send an SMS before the estimated arrival time. [Learn more](#interface-settings-company)

The start of delivery is the estimated time of arrival (ETA).

{% endcut %}  ||
|#

**Example 1**

The example describes the `arrival_time` ETA calculation.

Delivery window: between 12:00 and 14:00. The courier's arrival notification must be sent 30 minutes in advance. The order handling time is 1 hour, and the auto detection coefficient is 0.5.

For `arrival_time`, the delivery window is soft, so the courier can deliver the order earlier.

Let's say the courier's estimated time of arrival (ETA) is 10:00 a.m. The client receives the `nearby` notification at 9:30. The order status changes to **Delivered** at 10:30 a.m., when the courier has spent a certain amount of time in the delivery area.

![](./_images/eta-arrival-time.svg)

**Example 2**

The example describes the `delivery_time` ETA calculation.

Delivery window: between 12:00 and 14:00. The courier's arrival notification must be sent 30 minutes in advance. The order handling time is 1 hour, and the auto detection coefficient is 0.5.

For `delivery_time`, the delivery window is considered hard, so the courier can't deliver the order earlier. If a courier arrives before the delivery window starts, they will have to wait.

Let's say the courier's estimated time of arrival (ETA) is 10:00 a.m. The client receives the `nearby` notification at 11:30 a.m. The order status changes to **Delivered** at 12:30 p.m. when the courier has spent a certain amount of time in the delivery area. The time is counted from the beginning of the delivery window.

![](./_images/eta-delivery-time.svg)

{% note info %}

For [courier performance reports](https://yandex.kz/routing/doc/en/delivery/interface/quality-report.md), it's important that the order status is updated at the correct time. If the status automatically changes to **Delivered** when the courier is still waiting for the window to start, a time window violation is registered in the report. This may make statistics unreliable.

{% endnote %}



### Custom SMS messages {#customization}

To change the length of the number in SMS notifications, contact support.

If you want to customize the SMS text, use the service API for generating order events and implement the notification logic on your side. This will let you use your own wording in SMS notifications rather than standard text. more information, see [Order notifications](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/getsOrderNotifications).


<!-- source: en/extras/_includes/feedback.md -->
<a href="feedback">
  <span class="button">Contact support</span>
</a>


<!-- endsource: en/extras/_includes/feedback.md -->