Различия

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

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