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

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Следующая версия
Предыдущая версия
external:доставка:смс_информирование [2021/04/19 06:44]
Илья Савенков создано
external:доставка:смс_информирование [2021/04/19 10:48]
Илья Савенков [Редактирование сообщений]
Строка 3: Строка 3:
 ===== Принцип работы ===== ===== Принцип работы =====
  
-Служба СМС информирования позволяет оповестить гостей о статусе их заказа в доставке через отправку СМС сообщений. +Служба СМС информирования ​— это приложение,​ которое ​позволяет оповестить гостей об изменении ​статуса их заказа в доставке через отправку СМС сообщений. 
-Для отправки сообщений используется сервис [[https://​smsc.ru/​|SMSC]].+Для отправки сообщений используется сервис [[https://​smsc.ru/​?pp336049|SMSC]].
 Сама служба не будет ограничивать вас в длине и содержании ваших сообщений,​ но сервис SMSC имеет свои ограничения,​ о которых вам стоит знать: Сама служба не будет ограничивать вас в длине и содержании ваших сообщений,​ но сервис SMSC имеет свои ограничения,​ о которых вам стоит знать:
  
- * Одно SMS может содержать 70 символов с нелатинскими буквами ​(например,​ на русском) ​или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для ​нелатинских и 153 для латинских букв.+ * Одно SMS может содержать 70 символов с русскими буквами или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для ​русских и 153 для латинских букв.
  
  * Сообщения проверяются на наличие рекламы (спама),​ на содержание нецензурных выражений и оскорблений,​ на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.  * Сообщения проверяются на наличие рекламы (спама),​ на содержание нецензурных выражений и оскорблений,​ на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.
Строка 13: Строка 13:
 Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки,​ нажав ссылку «Пересчитать». Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки,​ нажав ссылку «Пересчитать».
  
-Часто задаваемые вопросы SMSC: https://​smsc.ru/​faq/ ​+Часто задаваемые вопросы SMSC: [[https://​smsc.ru/​faq/​?​pp336049|faq]]. ​
  
 ===== Установка ===== ===== Установка =====
 +
 +==== Дистрибутив ====
 +
 +Актуальный дистрибутив доступен по ссылке:​ https://​disk.yandex.ru/​d/​YWwTx3y3zQ_CYA?​w=1
 +Распакуйте архив в любую папку на сервере с Мини-доставкой.
  
 ==== Учетная запись в SMSC ==== ==== Учетная запись в SMSC ====
  
-Зарегистрируйтесь в сервисе [[https://​smsc.ru/​|SMSC]]. Имейте в виду, что данные для входа в сервис будут использоваться в конфигурационном файле, поэтому не используйте свои личные пароли.+Зарегистрируйтесь в сервисе [[https://​smsc.ru/​?pp336049|SMSC]]. Имейте в виду, что данные для входа в сервис будут использоваться в конфигурационном файле, поэтому не используйте свои личные пароли.
  
 Наведите на вкладку «Настройки»,​ а затем нажмите на «Имена отправителей». Наведите на вкладку «Настройки»,​ а затем нажмите на «Имена отправителей».
 +{{:​external:​доставка:​pasted:​20210419-065056.png}}
 В списке имён отправителей нажмите кнопку «Добавить новое имя». В списке имён отправителей нажмите кнопку «Добавить новое имя».
-Впишите имя, которое будет видно гостю при получении SMS сообщения в поле «Имя отправителя» и сохраните новое имя отправителя.+Впишите имя, которое будет видно гостю при получении SMS сообщения в поле «Имя отправителя», запишите что-нибудь в поле для комментария и нажмите кнопку «Сохранить». 
 +{{:​external:​доставка:​pasted:​20210419-065347.png}} 
 +Затем нажмите на кнопку «Настройки» и поменяйте «Имя отправителя» на новое. 
 +{{:​external:​доставка:​pasted:​20210419-065723.png}}
  
 ==== Настройка службы ==== ==== Настройка службы ====
Строка 30: Строка 39:
  
 ^ config.ini ​                                                                                   ^^^ ^ config.ini ​                                                                                   ^^^
-| APP                                                                                           ​|||+[APP]                                                                                         |||
 | port       | 5858                      | Порт приложения ​                                       | | port       | 5858                      | Порт приложения ​                                       |
-| SMSC                                                                                          |||+[SMSC]                                                                                        ​|||
 | login      | Username ​                 | Логин учетки SMSC                                      | | login      | Username ​                 | Логин учетки SMSC                                      |
 | password ​  | Password ​                 | Пароль учетки SMSC                                     | | password ​  | Password ​                 | Пароль учетки SMSC                                     |
-| STATUS (см. раздел [[#​Редактирование сообщений]]) ​                                             |||+[STATUS(см. раздел [[#​Редактирование сообщений]]) ​                                          ​|||
 | XX_enabled | 1                         | 0 - не отправлять сообщение по статусу,​ 1 - отправлять | | XX_enabled | 1                         | 0 - не отправлять сообщение по статусу,​ 1 - отправлять |
-| XX_text ​   | Ваш заказ ​№{order} ​принят | Текст SMS сообщения при смене статуса ​                 |+| XX_text ​   | Ваш заказ принят | Текст SMS сообщения при смене статуса ​                 ​
 +| [LOG]                                                                                         ||| 
 +| retention ​ | 7                         | Длительность хранения логов в днях ​                    | 
 +| level      | 1                         | Уровень важности логируемых сообщений,​ высокий уровень логирования будет показывать только критичные ошибки программы,​ низкий — всю информацию о работе программы. ​|
  
 Пример конфигурационного файла: Пример конфигурационного файла:
Строка 52: Строка 64:
 ; «В работе» - Заказ принят в Ресторан и передан на производство. ; «В работе» - Заказ принят в Ресторан и передан на производство.
 10_enabled=1 10_enabled=1
-10_text=Ваш заказ ​№{order} ​принят+10_text=Ваш заказ принят
  
 ; «В пути» - Заказ отправлен с курьером к получателю. ; «В пути» - Заказ отправлен с курьером к получателю.
 20_enabled=1 20_enabled=1
-20_text=Ваш заказ ​№{order} ​передан курьеру для доставки+20_text=Ваш заказ передан курьеру для доставки
  
 ; «В архиве» - Курьер вернулся в ресторан,​ заказ полностью завершен. ; «В архиве» - Курьер вернулся в ресторан,​ заказ полностью завершен.
 30_enabled=1 30_enabled=1
-30_text=Ваш заказ ​№{order} ​выполнен+30_text=Ваш заказ выполнен
  
 ; «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине. ; «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.
 40_enabled=1 40_enabled=1
-40_text=Ваш заказ ​№{order} ​удален. Тел для связи +7-555-123-45-67+40_text=Ваш заказ удален. Тел для связи +7-555-123-45-67 
 + 
 +[LOG] 
 +retention=7 
 +level=1
 </​file>​ </​file>​
  
Строка 71: Строка 87:
 Содержание сообщений настраивается в конфигурационном файле ''​config.ini''​. Содержание сообщений настраивается в конфигурационном файле ''​config.ini''​.
  
-В разделе [STATUS] ''​XX_enabled''​ отвечает за отправку сообщений по статусу (0 — не отправлять,​ 1 — отправлять),​ а ''​XX_text''​ содержит текст сообщения,​ где XX это статус:​+В разделе [STATUS] ''​XX_enabled''​ отвечает за отправку сообщений при переходе заказа в соответствующий ​статус (0 — не отправлять,​ 1 — отправлять),​ а ''​XX_text''​ содержит текст сообщения,​ где XX это статус, в который перешел заказ:
  * 10: «В работе» - Заказ принят в Ресторан и передан на производство.  * 10: «В работе» - Заказ принят в Ресторан и передан на производство.
  * 20: «В пути» - Заказ отправлен с курьером к получателю.  * 20: «В пути» - Заказ отправлен с курьером к получателю.
  * 30: «В архиве» - Курьер вернулся в ресторан,​ заказ полностью завершен.  * 30: «В архиве» - Курьер вернулся в ресторан,​ заказ полностью завершен.
  * 40: «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.  * 40: «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.
- 
-В текст сообщения также можно добавить номер заказа через слово ''​{order}''​ (без пробелов между фигурными скобками и словом order): 
  
 <file ini config.ini>​ <file ini config.ini>​
Строка 83: Строка 97:
 ; «В работе» - Заказ принят в Ресторан и передан на производство. ; «В работе» - Заказ принят в Ресторан и передан на производство.
 10_enabled=1 10_enabled=1
-10_text=Ваш заказ ​№{order} ​принят+10_text=Ваш заказ принят
 </​file>​ </​file>​
- 
-При такой конфигурации,​ гостю с номером заказа 19 придет следующий текст SMS: 
-> Ваш заказ №19 принят 
  
 ==== Настройка доставки ==== ==== Настройка доставки ====
Строка 96: Строка 107:
 Например:​ Например:​
 <code ini>​Status_callback=http://​127.0.0.1:​5858/​send-sms</​code>​ <code ini>​Status_callback=http://​127.0.0.1:​5858/​send-sms</​code>​
 +
 +==== Запуск службы ====
 +
 +Запустите файл DeliverySMS.exe с ключом ''/​install''​.
 +Затем запустите службу Carbis Delivery SMS.
  
  • external/доставка/смс_информирование.txt
  • Последние изменения: 2021/04/19 10:48
  • Илья Савенков