external:доставка:смс_информирование

Это старая версия документа!


СМС информирование

Служба СМС информирования позволяет оповестить гостей о статусе их заказа в доставке через отправку СМС сообщений.
Для отправки сообщений используется сервис SMSC.
Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать:

  • Одно SMS может содержать 70 символов с нелатинскими буквами (например, на русском) или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для нелатинских и 153 для латинских букв.
  • Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.

Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки, нажав ссылку «Пересчитать».

Часто задаваемые вопросы SMSC: https://smsc.ru/faq/

Зарегистрируйтесь в сервисе SMSC. Имейте в виду, что данные для входа в сервис будут использоваться в конфигурационном файле, поэтому не используйте свои личные пароли.

Наведите на вкладку «Настройки», а затем нажмите на «Имена отправителей».

В списке имён отправителей нажмите кнопку «Добавить новое имя».
Впишите имя, которое будет видно гостю при получении SMS сообщения в поле «Имя отправителя», запишите что-нибудь в поле для комментария и нажмите кнопку «Сохранить».

Затем нажмите на кнопку «Настройки» и поменяйте «Имя отправителя» на новое.

Настройка службы проходит в конфигурационном файле config.ini:

config.ini
[APP]
port 5858 Порт приложения
[SMSC]
login Username Логин учетки SMSC
password Password Пароль учетки SMSC
[STATUS] (см. раздел Редактирование сообщений)
XX_enabled 1 0 - не отправлять сообщение по статусу, 1 - отправлять
XX_text Ваш заказ №{order} принят Текст SMS сообщения при смене статуса

Пример конфигурационного файла:

config.ini
;
[APP]
port=5858
 
[SMSC]
login=Username
password=Password
 
[STATUS]
; «В работе» - Заказ принят в Ресторан и передан на производство.
10_enabled=1
10_text=Ваш заказ №{order} принят

; «В пути» - Заказ отправлен с курьером к получателю.
20_enabled=1
20_text=Ваш заказ №{order} передан курьеру для доставки

; «В архиве» - Курьер вернулся в ресторан, заказ полностью завершен.
30_enabled=1
30_text=Ваш заказ №{order} выполнен

; «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.
40_enabled=1
40_text=Ваш заказ №{order} удален. Тел для связи +7-555-123-45-67

Содержание сообщений настраивается в конфигурационном файле config.ini.

В разделе [STATUS] XX_enabled отвечает за отправку сообщений по статусу (0 — не отправлять, 1 — отправлять), а XX_text содержит текст сообщения, где XX это статус:

  • 10: «В работе» - Заказ принят в Ресторан и передан на производство.
  • 20: «В пути» - Заказ отправлен с курьером к получателю.
  • 30: «В архиве» - Курьер вернулся в ресторан, заказ полностью завершен.
  • 40: «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.

В текст сообщения также можно добавить номер заказа через слово {order} (без пробелов между фигурными скобками и словом order):

config.ini
[STATUS]
; «В работе» - Заказ принят в Ресторан и передан на производство.
10_enabled=1
10_text=Ваш заказ №{order} принят

При такой конфигурации, гостю с номером заказа 19 придет следующий текст SMS:

Ваш заказ №19 принят

Для корректной работы требуется минимальная версия DeliveryHatch 3.2.10.1861.
В конфигурационном файле DeliveryHatch.ini в разделе [SERVER] нужно добавить новое поле Status_callback, в значении которого указать адрес сервера, где стоит служба SMS информирования с постфиксом /send-sms. (http://{адрес}:{порт}/send-sms)

Например:

Status_callback=http://127.0.0.1:5858/send-sms
  • external/доставка/смс_информирование.1618804723.txt.gz
  • Последние изменения: 2021/04/19 06:58
  • Илья Савенков