====== СМС информирование ======

===== Принцип работы =====

Служба СМС информирования — это приложение, которое позволяет оповестить гостей об изменении статуса их заказа в доставке через отправку СМС сообщений.
Для отправки сообщений используется сервис [[https://smsc.ru/?pp336049|SMSC]].
Сама служба не будет ограничивать вас в длине и содержании ваших сообщений, но сервис SMSC имеет свои ограничения, о которых вам стоит знать:

	* Одно SMS может содержать 70 символов с русскими буквами или 160 символов только с латинскими буквами. Для передачи более длинного сообщения оно разбивается на несколько SMS и максимальная длина каждой SMS в этом случае становится 67 символов для русских и 153 для латинских букв.

	* Сообщения проверяются на наличие рекламы (спама), на содержание нецензурных выражений и оскорблений, на призывы отправить SMS и на некоторые другие запрещенные тексты. Если в сообщении встречаются запрещенные слова или фразы, то такое сообщение не отправляется.

Проверить стоимость и возможность рассылки всегда можно в личном кабинете на странице отправки, нажав ссылку «Пересчитать».

Часто задаваемые вопросы SMSC: [[https://smsc.ru/faq/?pp336049|faq]]. 

===== Установка =====

==== Дистрибутив ====

Актуальный дистрибутив доступен по ссылке: https://disk.yandex.ru/d/YWwTx3y3zQ_CYA?w=1
Распакуйте архив в любую папку на сервере с Мини-доставкой.

==== Учетная запись в SMSC ====

Зарегистрируйтесь в сервисе [[https://smsc.ru/?pp336049|SMSC]]. Имейте в виду, что данные для входа в сервис будут использоваться в конфигурационном файле, поэтому не используйте свои личные пароли.

Наведите на вкладку «Настройки», а затем нажмите на «Имена отправителей».
{{:external:доставка:pasted:20210419-065056.png}}
В списке имён отправителей нажмите кнопку «Добавить новое имя».
Впишите имя, которое будет видно гостю при получении SMS сообщения в поле «Имя отправителя», запишите что-нибудь в поле для комментария и нажмите кнопку «Сохранить».
{{:external:доставка:pasted:20210419-065347.png}}
Затем нажмите на кнопку «Настройки» и поменяйте «Имя отправителя» на новое.
{{:external:доставка:pasted:20210419-065723.png}}

==== Настройка службы ====

Настройка службы проходит в конфигурационном файле ''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                         | Уровень важности логируемых сообщений, высокий уровень логирования будет показывать только критичные ошибки программы, низкий — всю информацию о работе программы. |

Пример конфигурационного файла:
<file ini 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
</file>

==== Редактирование сообщений ====

Содержание сообщений настраивается в конфигурационном файле ''config.ini''.

В разделе [STATUS] ''XX_enabled'' отвечает за отправку сообщений при переходе заказа в соответствующий статус (0 — не отправлять, 1 — отправлять), а ''XX_text'' содержит текст сообщения, где XX это статус, в который перешел заказ:
	* 10: «В работе» - Заказ принят в Ресторан и передан на производство.
	* 20: «В пути» - Заказ отправлен с курьером к получателю.
	* 30: «В архиве» - Курьер вернулся в ресторан, заказ полностью завершен.
	* 40: «Отменен» - Ресторана отменил ранее принятый заказ по той или иной причине.

<file ini config.ini>
[STATUS]
; «В работе» - Заказ принят в Ресторан и передан на производство.
10_enabled=1
10_text=Ваш заказ принят
</file>

==== Настройка доставки ====

Для корректной работы требуется минимальная версия DeliveryHatch 3.2.10.1861.
В конфигурационном файле DeliveryHatch.ini в разделе [SERVER] нужно добавить новое поле Status_callback, в значении которого указать адрес сервера, где стоит служба SMS информирования с постфиксом ''/send-sms''. (%%http://{адрес}:{порт}/send-sms%%)

Например:
<code ini>Status_callback=http://127.0.0.1:5858/send-sms</code>

==== Запуск службы ====

Запустите файл DeliverySMS.exe с ключом ''/install''.
Затем запустите службу Carbis Delivery SMS.