Методы оповещений заявителей

Методы оповещений заявителей

06.04.2022

Оповещение через СМС

Для оповещения о событиях посредством отправки СМС администратор системы должен выбрать технологию с помощью которой будут отправляться короткие сообщения заявителю на номер телефона.

Команда CMD для отправки

Команда CMD для отправки СМС позволяет настроить команду, которая будет вызываться при попытке отправить сообщение. В это поле вписывается текст команды, которую выполнит операционная система. В тексте команды могут быть использованы 2 параметра : первый - номер телефона, второй - текст сообщения.

Пример: echo %s --- %s >> /var/opt/sms_list.txt Для данного примера произойдет следующее:

Предположим есть заявитель с номером телефона +799912345678, Работник МФЦ завершил работу с его делом и отправил его на выдачу, при этом в настройке "Фразы при автоматическом оповещении заявителя" для события "Исполнено дело" стоит текст "Ваше дело исполнено, результат готов к выдаче". В папке /var/opt будет создан файл sms_list.txt с текстом

+799912345678 --- Ваше дело исполнено, результат готов к выдаче

При возникновении следующего события в данном файле будет создана ещё одна строка с соответвующим номером телефоном и тестом оповещения.

Также этот метод можно применять для отправки смс через gsm модем,

Пример: для связи с модемом будем использовать программу cmd2phone.exe, модем отпраделяется в системе на порту COM5.

Тогда команда будет выглядеть следующим образом

start c:/cmd2phone/cmd2phone.exe -Q -P COM5 %s "%s"

Команда для отправки через Kannel

При использовании этой функции будет послан GET запрос на указанный в команде адрес. Здесь также обрабатывется 2 параметра : первый - номер телефона, второй - текст сообщения. Этой функцией пользуются при необходимости отправлять СМС по протоколу SMPP. Для этого устанавливается программа Kannel, которая осуществляет взаимодействие с сервером оповещения по протоколу SMPP, а к ней уже можно обращаться по протоколу HTTP, отправляя GET запросы.

Пример команды для kannel : http://10.2.65.201:13013/cgi-bin/sendsms?user=users&pass=pass&charset=utf-8&coding=2&to=%s&text=%s

где 10.2.65.201 - адрес компьютера, на котором установлен kannel.

13013 - порт, описан в kannel.conf (sendsms-port)

Также можно использовать эту функцию для отправки GET запросов к другим сервисам

Отправка через сервис оператора

при использовании любого из методов данного раздела производятся допольнительные обработки сообщений перед отправкой.

Такие как логирование запроса к оператору и ответа от него в таблице БД log.sms и проверка на дубли перед отправкой в соответствии с настройкой "Время для отправки одинаковых СМС на один номер (сек.)". Если в таблице log.sms есть запись с номером телефона и текстом сообщения идентичным тем, которые патаются отправиться и с момента отправки(поле dt таблицы log.sms) прошло меньше указанного в настройке количества секунд - то отправка сообщения будет отменена.
- api.sms-agent.ru - Оператор СМС-Агент
- api3.sms-agent.ru - Оператор СМС-Агент
- smpp3.sms-agent.ru - Оператор СМС-Агент
Отправляется POST запрос на один из адресов

https://api.sms-agent.ru/v2.0/

https://api3.sms-agent.ru/v2.0/

https://smpp3.sms-agent.ru/v2.0/
```
параметры

 - login=значение настройки "Логин" раздела "Отправка через сервис оператора",
 - pass=значение настройки "Пароль" раздела "Отправка через сервис оператора",
 - act=send,
 - to   =номер телефона,
 - text =текст сообщения
 - from = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора"
```
- lk.evatelecom.ru - Оператор EvaTelecom
- lk2.evatelecom.ru - Оператор EvaTelecom
  
  Отправляется GET запрос на один из адресов
  
  http://lk.evatelecom.ru/sendsms.php
  
  http://lk2.evatelecom.ru/sendsms.php
  
  параметры
  - user =начение настройки "Логин" раздела "Отправка через сервис оператора",
  - pwd = значение настройки "Пароль" раздела "Отправка через сервис оператора",
  - sact = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора",
  - dadr = номер телефона,
  - text = текст сообщения
- beeline.amega-inform.ru - Оператор BeeLine
- a2p-sms.beeline - Оператор BeeLine
  
  Отправляется POST запрос на адрес
  
  https://beeline.amega-inform.ru/sms_send/
  
  https://a2p-sms-https.beeline.ru/proto/http/
  
  параметры
  - user=значение настройки "Логин" раздела "Отправка через сервис оператора",
  - pass=значение настройки "Пароль" раздела "Отправка через сервис оператора",
  - action = post_sms,
  - target =номер телефона,
  - message =текст сообщения
  - gzip = none
  - sender = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора"
- a2p-api.megalabs.ru - Оператор Megafon
  
  Отправляется POST запрос на адрес
  
  https://a2p-api.megalabs.ru/sms/v1/sms
  
  для доступа к сервису используется BASIC авторизация указанными в настройках раздела "Отправка через сервис оператора" логином и паролем
  
  тело запроса передается в формате JSON
  
  параметры
  - from = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора",
  - message = текст сообщения,
  - to = номер телефона
- sms.e-vostok.ru - Оператор Электроник Восток
  
  Отправляется GET запрос на адрес
  
  https://sms.e-vostok.ru/smsout.php
  
  параметры
  - login = значение настройки "Логин" раздела "Отправка через сервис оператора",
  - password = значение настройки "Логин" раздела "Отправка через сервис оператора",
  - text = текст сообщения,
  - space = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора",
  - subno = номер телефона,
  - service = "25873",
  - space_force= 1,
- api.mcommunicator.ru - Оператор МТС
  
  Отправляется GET запрос на адрес
  
  https://api.mcommunicator.ru/m2m/m2m_api.asmx/SendMessage
  
  для доступа к сервису используется BASIC авторизация с помощью ключа, который надо указать в настройках раздела "Отправка через сервис оператора" в поле "Логин" или поле "Пароль"
  
  параметры
  - message = текст сообщения,
  - naming = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора",
  - msid = номер телефона,
- omnichannel.mts.ru - Оператор МТС
  
  Отправляется GET запрос на адрес
  
  https://omnichannel.mts.ru/http-api/v1/messages
  
  для доступа к сервису используется BASIC авторизация указанными в настройках раздела "Отправка через сервис оператора" логином и паролем
  
  тело запроса передаётся в формате JSON
  
  документация: https://support.mts.ru/mts_marketolog/Rassilki-po-svoei-baze-PRO-i-API-k-nim/dokumentatsiya-rest-api
  
  формат:
```
"messages": [
    {
        "content": {
            "short_text": текст сообщения
        },
        "to": [
            {
                "msisdn": номер телефона,
                "message_id": GUID сообщения(генерируется перед отправкой)
            }
        ],
        "from": {
            "sms_address": значение настройки "Имя отправителя" раздела "Отправка через сервис оператора"
        }
    },
],
```
- target.tele2.ru - Оператор TELE2
  
  Отправляется POST запрос на адрес
  
  https://target.tele2.ru/api/v2/send_message
  
  для доступа к сервису используется BASIC авторизация указанными в настройках раздела "Отправка через сервис оператора" логином и паролем
  
  параметры
  - shortcode = значение настройки "Имя отправителя" раздела "Отправка через сервис оператора",
  - text = текст сообщения,
  - msisdn = номер телефона

Оповещение посредством осуществления телефонного звонка

Для оповещения о событиях посредством осуществления телефонного звонка на номер заявителя администратор системы должен выбрать технологию с помощью которой будут выполняться взаимодействие с call-центром.

Автообзвон через call-center

при использовании любого из методов данного раздела производятся допольнительные обработки сообщений перед отправкой.

Такие как логирование запроса к оператору и ответа от него в таблице БД log.calls и проверка на дубли перед отправкой в соответствии с настройкой "Время для отправки одинаковых СМС на один номер (сек.)". Если в таблице log.calls есть запись с номером телефона и текстом сообщения идентичным тем, которые патаются отправиться и с момента отправки(поле dt таблицы log.calls) прошло меньше указанного в настройке количества секунд - то отправка сообщения будет отменена.
КОМЭКС

Отправляется POST запрос на адрес указанный в поле "Адрес API call-center`а" раздела "Автообзвон через call-center" + /api/outer/addTaskToCall

Например адрес в настройке = "http://10.1.100.10", то запрос будет отправлен на адрес

http://10.1.100.10/api/outer/addTaskToCall

для доступа к сервису используется BASIC авторизация указанными в настройках раздела "Отправка через сервис оператора" логином и паролем

тело запроса передается в формате JSON

- kind      = одна из констант 'CASE_STATUS' или 'OTHER',
- text   = текст сообщения,
- phoneNumber        = номер телефона

сообщение передается в виде текста, озвучкой занимается программа "КОМЭКС - Телефонный центр МФЦ"

Ставрополь

Не используется в данный момент

Курган

Отправляется POST запрос на адрес указанный в поле "Адрес API call-center`а" раздела "Автообзвон через call-center"

тело запроса передается в формате JSON

- CaseStatus      = тип события - одна из констант в зависимости от события, сообщение о котоором отправляется
   'mesIspol'      
   'mesIspolNotVid'
   'mesYavka'      
   'mesOtkaz'      
   'mesStop'       
   'mesStart'      
   'mesMoveKas'    
   'mesIspolCs'      
   'mesIspolNotVidCs'
   'mesYavkaCs'      
   'mesOtkazCs'      
   'mesStopCs'       
   'mesStartCs'      
   'mesMoveKasCs'     
   'OTHER'
- caseNum   = номер дела,
- phoneNumber        = номер телефона
- uuid        = GUID сообщения(генерируется перед отправкой)

сообщение передается в виде текста, озвучкой занимается программа телефонного центра используемая в МФЦ.

Также при использовании данного метода автообзвона происходит дополнительная обработка дел при их выдаче либо возврате исполнителю из формы "Выдача дел". При выполнении операции выдачи либо возврата на адрес call-центра отправляется запрос с типом события mesCaseVid и сообщением "Дело выдано "+ id дела.

Пример :

   CaseStatus= mesCaseVid 
   caseNum   = 1-315
   phoneNumber = +799912345678
   uuid        = 72e38e1d-6fa9-46f9-81f3-0a5d022f7a76

Стоит обратить внимание, что при оповещении этим методом текст соощения не передается в call-центр, но сохраняется в таблицах логов и участвует в проверках на уникальность сообщения. Call-центр самостоятельно на основании типа события и номера дела формирует фразу для оповещения и доводит её до заявителя.

Калуга. Инфинити

Отправляется POST запрос на адрес указанный в поле "Адрес API call-center`а" раздела "Автообзвон через call-center" + /data/insertarr/?ProviderName=-=имя кампании=-

где -=имя кампании=- - значение настройки "Имя отправителя" раздела "Отправка через сервис оператора"

Например адрес в настройке = "http://10.1.100.10" и значение настройки "Имя отправителя" раздела "Отправка через сервис оператора" = "MFC_CALL", то запрос будет отправлен на адрес

http://10.1.100.10/data/insertarr/?ProviderName=MFC_CALL

тело запроса передается в формате JSON

формат:

   "result": {
           "data": {
               "ID": значение поля id таблицы log.calls,
               "Phone": номер телефона,
               "State": текст сообщения,
           },
       },

сообщение передается в виде текста, озвучкой занимается телефонный центр компании "Инфинити"

События по запросу(API)

В момент возникновения события отправки задачи на обзвон этим методом происходит следующее:

В БД в таблице clients.notify_queue создается запись с реквизитами сообщения(номер телефона, текст сообщения, дело в рамках которого возникло событие отправки, заявитель и т.п.), также в таблице clients.notify_delivery создается запись со ссылкой на clients.notify_queue и флагом channel=2 (это означает что канал оповещения = обзмон методом "События по запросу(API)").

Затем некий сервис, когда это ему необходимо обращается к API внешнего сайта МФЦ, к методу "Выгрузка событий для оповещения заявителя" - /rest-api/message/callsmess. АИС КОМЭКС "Мои документы" в ответ за запрос по данному API отдает набор записей для оповещения из таблицы clients.notify_queue, таких у которых не заполнена колонка dt_send из связанной таблицы clients.notify_delivery и сохраняет дату отправки(чтоб при повторном запросе не отправить те же данные). После чего сервис выполняет работу по оповещению заявителей и по завершении оповещения присылает на API внешнего сайта "Сохранение результатов обзвона" - /rest-api/message/сallresult, информацию о результате обзвона(id сообщения, дата и время обзвона, продолжительность звонка (сек) и т.д.). Эти данные сохраняются в таблицу clients.notify_delivery_details. Информация о доставке сообщений для данного метода отправки отображается в форме "Информация по делу" в разделе "Доставка сообщений(API)".

Реестры для call-центра

Данный метод выпоняется всегда, не зависомо от настройки метода оповещения. Это означает что при любой попытке отправить сообщение(смс любым методом, обзвон любым методом, почта и т.д.) сообщение дополнительно будет включено в реестр для call-центра.

Обрабатываются сообщения с типами:

- Исполнено дело
- Исполнено дело (нет выдачи)
- Отказ по делу
- Приостановлено
- Исполнен этап с отметкой «Необходима явка заказчика после исполнения этапа»

В момент возникновения события отправки сообщения происходит следующее:

В таблице delo.cc_reestr сосздается запись с реквизитами сообщения(номер телефона, дело в рамках которого возникло событие отправки, заявитель и т.п.).

Затем работник call-центра, когда это ему необходимо открывает форму "Реестры для call-центра", доступно через меню "Call-центр"->"Реестры для ЦТО". В этой форме работник формирует новый реестр(выбирает фильтры(подразделения, услуги, результат дел), нажимает кнопку "Новый реестр" и в него попадают все строки из таблицы delo.cc_reestr с незаполенной колонкой id_reestr_list, подходящие под указанные фильтры), либо открывает ранее сформированный и обрабатывает список для оповещения вручную(обзванивает заявителей)

Важно! Так как и для обзвона и для отправки СМС ключевым параметром заявителя является номер телефона и обе функции оповещения(СМС и обзвон) зависят от него же, то ограничения или разрашения на оповещения по номеру телефоны, проставляемые в карточке заявителя, участниках в деле, при передаче на выдачу и т.п., влияют как на отправку смс так и на обзвон. Другими словами если в карточке заявителя снять галочку "Получение уведомлений" возле номера телефона, то не будет отправляться смс и не будет выполняться обзвон(1 галочка влияет на 2 метода оповещений).

Оповещение через Email

описано на этой странице в разделе "Электронная почта"

Оповещение через ЕПГУ

Дополнительно к вышеописанным методам оповещения сообщение может бать доставлено заявителю в личный кабинет на ЕПГУ. Для этого МФЦ должен быть подключен к СМЭВ3, иметь доступ к видам сведений "Регистрация заявлений в ЕЛК" и "Передача статусов по заявлению в ЕЛК" и настроенные адаптеры в программе "КОМЭКС. СМЭВ3" к этим видам сведений.

При открытии дела, если услуга описана достаточно подробно(указаны коды ФРГУ, коды целей обращения, процедур и т.п.)и данных хватает для отправки информации на ЕПГУ о создании обращения, то через адаптер к ВС "Регистрация заявлений в ЕЛК" будет послан запрос на создание обращения на ЕПГУ. В ответ на запрос ЕПГУ пришлет номер обращения, который сохранится в таблице delo.delo в колонке epgu_number. Далее при возникновении события оповещения и наличии в деле epgu_number с помощью адаптера к ВС "Передача статусов по заявлению в ЕЛК" будет оправляться сообщение на ЕПГУ со статусом 12 (Входящее сообщение) и текстом сообщения.