СМС информирование
Принцип работы
Служба СМС информирования — это приложение, которое позволяет оповестить гостей об изменении статуса их заказа в доставке через отправку СМС сообщений.
Для отправки сообщений используется сервис SMSC.
Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать:
- Одно SMS может содержать 70 символов с русскими буквами или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для русских и 153 для латинских букв.
- Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.
Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки, нажав ссылку «Пересчитать».
Часто задаваемые вопросы SMSC: faq.
Установка
Дистрибутив
Актуальный дистрибутив доступен по ссылке: https://disk.yandex.ru/d/YWwTx3y3zQ_CYA?w=1
Распакуйте архив в любую папку на сервере с Мини-доставкой.
Учетная запись в 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 | Ваш заказ принят | Текст SMS сообщения при смене статуса |
[LOG] | ||
retention | 7 | Длительность хранения логов в днях |
level | 1 | Уровень важности логируемых сообщений, высокий уровень логирования будет показывать только критичные ошибки программы, низкий — всю информацию о работе программы. |
Пример конфигурационного файла:
- config.ini
; [APP] port=5858 [SMSC] login=Username password=Password [STATUS] ; «В работе» - Заказ принят в Ресторан и передан на производство. 10_enabled=1 10_text=Ваш заказ принят ; «В пути» - Заказ отправлен с курьером к получателю. 20_enabled=1 20_text=Ваш заказ передан курьеру для доставки ; «В архиве» - Курьер вернулся в ресторан, заказ полностью завершен. 30_enabled=1 30_text=Ваш заказ выполнен ; «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине. 40_enabled=1 40_text=Ваш заказ удален. Тел для связи +7-555-123-45-67 [LOG] retention=7 level=1
Редактирование сообщений
Содержание сообщений настраивается в конфигурационном файле config.ini
.
В разделе [STATUS] XX_enabled
отвечает за отправку сообщений при переходе заказа в соответствующий статус (0 — не отправлять, 1 — отправлять), а XX_text
содержит текст сообщения, где XX это статус, в который перешел заказ:
- 10: «В работе» - Заказ принят в Ресторан и передан на производство.
- 20: «В пути» - Заказ отправлен с курьером к получателю.
- 30: «В архиве» - Курьер вернулся в ресторан, заказ полностью завершен.
- 40: «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.
- config.ini
[STATUS] ; «В работе» - Заказ принят в Ресторан и передан на производство. 10_enabled=1 10_text=Ваш заказ принят
Настройка доставки
Для корректной работы требуется минимальная версия 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
Запуск службы
Запустите файл DeliverySMS.exe с ключом /install
.
Затем запустите службу Carbis Delivery SMS.