Set up SMS notifications

  1. SMS types
  2. SMS settings
  3. SMS customization

You can set up automatic sending of SMS notifications about the order delivery progress.

SMS types

There are two types of SMS notifications:

SMS text is always standard. It must specify:

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

The company name is taken from the settings in the Logistics Coordinator Workplace interface.

Conditions for sending any type of SMS:

  • The order contains one phone number in the +7XXXXXXXXXX format.
  • The courier logged in to the Yandex.Courier app and selected a route.
  • The courier's geolocation data is received in real time.
  • The courier started the route within the specified order delivery time interval (before the estimated arrival time for the order).
  • The order status is different from Delivered or Canceled.
Note.

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

For example, a route has three orders with the same location to the same customer and all orders have the same phone number. This means that messages will be sent to the recipient for each order.

Sent at the start of the route

Property Value
Notification type shift_start
Message text Order <Company name> <order number> issued for delivery. Status https://yandex.ru/courier/tracking/<tracking ID>.
Sending time Simultaneously for all orders in the route.
Property Value
Notification type shift_start
Message text Order <Company name> <order number> issued for delivery. Status https://yandex.ru/courier/tracking/<tracking ID>.
Sending time Simultaneously for all orders in the route.

Conditions for sending SMS:

  • The route start time has come or passed if it's set (in the route_start field of the route).
  • The earliest delivery interval has come if the route start time route_start isn't defined.
  • The courier was marked at the depot if the depot is clearly indicated as the starting point in the route.
  • The courier is not within the depot radius if the mark_route_started_radius parameter is set for the depot.

Sent before the courier's arrival

Property Value
Notification type nearby
Message text Order <Company name> <order number> will arrive in <Minutes before the arrival time> min. Status https://yandex.ru/courier/tracking/<tracking ID>.
Sending time N minutes before arrival at the order location (see SMS settings for companies).
Property Value
Notification type nearby
Message text Order <Company name> <order number> will arrive in <Minutes before the arrival time> min. Status https://yandex.ru/courier/tracking/<tracking ID>.
Sending time N minutes before arrival at the order location (see SMS settings for companies).

Conditions for sending SMS:

  • The courier follows the order sequence.
  • The expected time for creating a notification has come.

SMS settings

Set up SMS notifications in the interface: for companies or couriers.

For companies

SMS notifications are set up in the Logistics Coordinator Workplace interface: Settings → Company → SMS settings → Send SMS to customers.

The Send SMS to customers option is:

  • Enabled: SMS will be sent for the routes of all couriers regardless of the settings for individual couriers.
  • Disabled: SMS will only be sent for the routes of couriers with the send option activated.

The table below contains the combinations of company and courier settings and their interaction results. The company settings take priority over the courier settings.

SMS for companies SMS for couriers Result of sending SMS for a courier
Yes Yes To be sent
Yes No To be sent
No Yes To be sent
No No Won't be sent
SMS for companies SMS for couriers Result of sending SMS for a courier
Yes Yes To be sent
Yes No To be sent
No Yes To be sent
No No Won't be sent

Types of notifications are set by the options:

  • Send SMS at the start of the route.
  • Send SMS before arrival.

You can choose both options or only one. For example, if courier routes start too early, you can disable sending an SMS at the start of the route so as not to disturb the recipient at an inconvenient time.

You can also specify the following in the company settings:

  • The time interval to send an SMS before the estimated arrival time (by default, 1800 seconds, that is, 30 minutes).
  • The time interval when messages can be sent.

For couriers

SMS notifications for a specific courier are set up in the Track & trace settings: Track & trace → Couriers.

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

SMS customization

SMS messages use text that can't be customized with the service tools.

If you need to customize the text, use the service API for generating order events and implement the notification logic completely on your side. This will let you use your own wording in SMS notifications rather than standard text. For more information, see Order notifications.

Contact support