Подключение универсального сервиса для оповещений

В системе PARTS SOFT вы можете подключить собственный сервис для отправки SMS- или push-уведомлений по API вместо использования готовых интеграций с сервисами рассылок.

Например, если подключен собственный сервис отправки SMS, универсальный сервис отправки уведомлений будет работать по следующей схеме:

Схема работы универсального сервиса

Настройка на стороне PARTS SOFT

Чтобы подключить универсальный сервис в системе, выполните следующие действия:

ШАГ 1. В панели администрирования перейдите в раздел Служебные → SMS и мессенджеры → Сервисы и в списке доступных сервисов нажмите кнопку Универсальный сервис.

Нажмите ОК в окошке подтверждения.

Переход к настройке сервиса

ШАГ 2. На открывшейся странице выполните следующие действия:

Таблица 1. Настройки универсального сервиса

№	Название настройки	Описание
1	Название	Укажите название сервиса.
2	Метод запроса	Выберите метод запроса: POST GET
3	Адрес запроса	Укажите адрес запроса. Пример адреса с заполненными полями: https://webhook.site/7695fa14-9386-4f6c-8e05-c4563374deb7?phone=&clean_phone=&message=. Корневая переменная — message. Доступные поля: message.phone — телефон клиента, как указан в системе; message.clean_phone — телефон клиента, очищенный от лишних символов (плюс и скобки); message.message — текст сообщения в системе; message.id — ID сообщения в системе.
4	Тело POST запроса	Укажите тело POST-запроса, если в поле Метод запроса выбран вариант POST.
5	HTTP заголовки	Укажите HTTP-заголовки, передавать дополнительную информацию вместе с запросом. Заголовки указываются по одной паре Заголовок - Значение в строке. Например, Content-Type: application/json.
6	Использовать для кодов	Перечислите мобильные коды (через знак вертикальной черты |), для которых будет доступна отправка сообщений с помощью сервиса.
7	Не использовать для кодов	Если требуется, перечислите мобильные коды (через знак вертикальной черты |), для которых отправка сообщений с помощью сервиса будет недоступна.
8	Регион	Выберите регион, в котором будет доступен сервис. Если оставить это поле пустым, сервис будет доступен во всех регионах.
9	Приоритет	Выберите приоритет сервиса среди других сервисов отправки сообщений. По умолчанию система игнорирует приоритет и в первую очередь отправляет сообщения через универсальный сервис, если он активен. В случае, если подключено два и более универсальных сервисов, оповещения отправляются согласно заданному приоритету.
10	Активен	Активируйте опцию, чтобы включить сервис.
11	Доступен для выбора клиентом	Активируйте опцию, если требуется, чтобы при оформлении заказа в клиентской части клиент мог выбрать данный сервис для получения уведомлений о статусе заказа.
12	Иконка сервиса	Загрузите иконку, которая будет отображаться в клиентской части для данного сервиса.

Нажмите кнопку Сохранить.

Настройки универсального сервиса

Тестирование с помощью webhook.site

Настроенное подключение можно проверить с помощью сервиса Webhook.site. Для этого выполните следующие действия:

ШАГ 1. Перейдите на сайт Webhook.site и в поле Your unique URL скопируйте URL для тестирования.

Получение URL для тестирования

ШАГ 2. Подключите Универсальный сервис на стороне PARTS SOFT.

Если Универсальный сервис уже настроен, внесите следующие изменения в его настройки:

1. В поле Метод запроса выберите GET;
2. В поле Адрес запроса укажите скопированный URL и дополните его переменными;

Пример: https://webhook.site/167178fe-b52b-4f94-b408-476367720c04?phone={{message.phone}}&message={{message.message | url_encode }}

Сохраните изменения.

Настройки для тестирования

ШАГ 3. Проведите проверку на тестовом заказе. Для этого в панели администрирования перейдите в раздел Заказы клиента → Все и переведите позицию любого заказа в статус группы Пришло.

Заказ в статусе Пришло

ШАГ 4. Перейдите обратно на сайт Webhook.site и убедитесь, что запрос доставлен.

В уведомлении мы видим, что передан телефон клиента и сообщение о смене статуса заказа.

Результат теста

Настройка сервиса на примере GSM VoIP шлюза Yeastar

GSM VoIP шлюз — это устройство, позволяющее перенаправлять трафик из интернета в GSM сеть. Одна из функций таких устройств — отправка SMS через API. 

В качестве примера рассмотрим подключение универсального сервиса для рассылки SMS на примере Yeastar TG100 с использованием статического IP-адреса и GET запроса.

Настройка на стороне Yeastar

Предварительно выполните стартовую настройку устройства согласно инструкции Yeastar, затем выполните следующие действия:

ШАГ 1. В веб-панели Yeastar перейдите в раздел SMS и нажмите кнопку Настройки AMI.

Переход к настройкам AMI

ШАГ 2. На открывшейся странице выполните следующие действия:

1. Активируйте опцию Включить AMI;
2. В полях Пользователь и Пароль придумайте и укажите имя пользователя и пароль. Эти данные будут использоваться для составления запроса.

Нажмите кнопку Сохранить.

Настройки AMI

Теперь для отправки SMS-уведомлений мы можем использовать следующий запрос:

http://ip:port/cgi/WebCGI?1500101=account=login&password=pass&port=1&destination=89991234567&content=test, где:

• ip:port — внешний статический IP-адрес и порт устройства.
• login и pass — данные, которые вы указали в полях Пользователь и Пароль;
• port=1 — номер GSM-порта;
• 89991234567 — номер телефона, на который отправляется СМС. Номер должен начинаться с 8;
• test — текст отправляемого сообщения.

Настройка на стороне PARTS SOFT

ШАГ 1. Подключите универсальный сервис с применением следующих настроек:

1. В поле Метод запроса выберите GET;
2. В поле Адрес запроса укажите http://202.168.180.530:8080/cgi/WebCGI?1500101=account=username&password=12345678&port=1&destination={{message.clean_phone | replace_first: "7", "8" }}&content={{message.message | url_encode }}, где:

• 202.168.180.530:8080 — статический внешний ip-адрес GSM VoIP шлюза с указанием порта;
• username — имя пользователя, указанное в поле Пользователь при настройке на стороне Yeastar;
• 12345678 — пароль, указанный в поле Пароль при настройке на стороне Yeastar;
• port=1 — номер GSM порта шлюза. Наше устройство имеет один GSM порт, поэтому указано 1;
• {{message.clean_phone | replace_first: "7", "8" }} — выводится номер телефона клиентов без скобок и плюса, дополнительно используется фильтр для замены 7 на 8 в начале номеров телефона;
• {{message.message | url_encode }} — текст сообщения.

Нажмите кнопку Сохранить.

Настройка завершена.