Различия
Здесь показаны различия между двумя версиями данной страницы.
Следующая версия | Предыдущая версия | ||
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. | ||