Это старая версия документа!
СМС информирование
Принцип работы
Служба СМС информирования позволяет оповестить гостей о статусе их заказа в доставке через отправку СМС сообщений.
Для отправки сообщений используется сервис SMSC.
Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать:
- Одно SMS может содержать 70 символов с нелатинскими буквами (например, на русском) или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для нелатинских и 153 для латинских букв.
- Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.
Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки, нажав ссылку «Пересчитать».
Часто задаваемые вопросы SMSC: https://smsc.ru/faq/
Установка
Учетная запись в SMSC
Зарегистрируйтесь в сервисе 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