Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Последняя версия Следующая версия справа и слева | ||
external:доставка:смс_информирование [2021/04/19 07:52] Александр Ильин [Учетная запись в SMSC] |
external:доставка:смс_информирование [2021/04/19 10:41] Илья Савенков |
||
---|---|---|---|
Строка 3: | Строка 3: | ||
===== Принцип работы ===== | ===== Принцип работы ===== | ||
- | Служба СМС информирования позволяет оповестить гостей о статусе их заказа в доставке через отправку СМС сообщений. | + | Служба СМС информирования — это приложение, которое позволяет оповестить гостей об изменении статуса их заказа в доставке через отправку СМС сообщений. |
Для отправки сообщений используется сервис [[https://smsc.ru/?pp336049|SMSC]]. | Для отправки сообщений используется сервис [[https://smsc.ru/?pp336049|SMSC]]. | ||
Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать: | Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать: | ||
- | * Одно SMS может содержать 70 символов с нелатинскими буквами (например, на русском) или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для нелатинских и 153 для латинских букв. | + | * Одно SMS может содержать 70 символов с русскими буквами или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для русских и 153 для латинских букв. |
* Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется. | * Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется. | ||
Строка 16: | Строка 16: | ||
===== Установка ===== | ===== Установка ===== | ||
+ | |||
+ | ==== Дистрибутив ==== | ||
+ | |||
+ | Актуальный дистрибутив доступен по ссылке: https://disk.yandex.ru/d/YWwTx3y3zQ_CYA?w=1 | ||
+ | Распакуйте архив в любую папку на сервере с Мини-доставкой. | ||
==== Учетная запись в SMSC ==== | ==== Учетная запись в SMSC ==== | ||
Строка 41: | Строка 46: | ||
| [STATUS] (см. раздел [[#Редактирование сообщений]]) ||| | | [STATUS] (см. раздел [[#Редактирование сообщений]]) ||| | ||
| XX_enabled | 1 | 0 - не отправлять сообщение по статусу, 1 - отправлять | | | XX_enabled | 1 | 0 - не отправлять сообщение по статусу, 1 - отправлять | | ||
- | | XX_text | Ваш заказ №{order} принят | Текст SMS сообщения при смене статуса | | + | | XX_text | Ваш заказ принят | Текст SMS сообщения при смене статуса | |
+ | | [LOG] ||| | ||
+ | | retention | 7 | Длительность хранения логов в днях | | ||
+ | | level | 1 | Уровень важности логируемых сообщений, высокий уровень логирования будет показывать только критичные ошибки программы, низкий — всю информацию о работе программы. | | ||
Пример конфигурационного файла: | Пример конфигурационного файла: | ||
Строка 56: | Строка 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> | ||
Строка 75: | Строка 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> | ||
Строка 87: | Строка 97: | ||
; «В работе» - Заказ принят в Ресторан и передан на производство. | ; «В работе» - Заказ принят в Ресторан и передан на производство. | ||
10_enabled=1 | 10_enabled=1 | ||
- | 10_text=Ваш заказ №{order} принят | + | 10_text=Ваш заказ принят |
</file> | </file> | ||
- | При такой конфигурации, гостю с номером заказа 19 придет следующий текст SMS: | + | При такой конфигурации, гостю придет следующий текст SMS: |
- | > Ваш заказ №19 принят | + | > Ваш заказ принят |
==== Настройка доставки ==== | ==== Настройка доставки ==== | ||
Строка 100: | Строка 110: | ||
Например: | Например: | ||
<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. | ||