Настройка отправки уведомлений пользователю по СМС

Сергей Гусев, Алексей Городков
2024-09-16 16:22
Инструкция может быть полезна для пользователей с ролью: Диспетчер-Администратор, Администратор

1. Назначение

Для отправки пользователям СМС-сообщений в системе используется плагин OTSMS и интеграция с внешним сервисом sms.ru. Администратор СЭО задает необходимые настройки для плагина и отправки уведомлений, которые используются по умолчанию. В дальнейшем каждый пользователь системы в Личном кабинете  может дополнительно настроить под себя, какие виды уведомлений и о каких событиях он хочет получать. Исключение составляют уведомления, отмеченные Администратором со статусом «Заблокировано»: для них пользователь самостоятельно не сможет управлять способами доставки и не сможет отключить эти уведомления.

2. Предварительные условия по доступу и использованию

Если у вас возникла необходимость использовать в учебном процессе механизм СМС-уведомлений, необходимо:

  • пройти регистрацию на внешнем сервисе sms.ru;
  • через личный кабинет клиента оформить заявку (в категории «Гарантийная техподдержка /  Настройка СЭО»), указав информацию о ключе API.
Важно! Действия в данной инструкции с отметкой требуются права Администратора можно выполнить только при наличии доступа «Полный Администратор». По умолчанию мы предоставляем ответственному сотруднику доступ «Диспетчер-Администратор». Изменить или расширить предоставляемый набор прав можно сформировав (через личный кабинет клиента),  соответствующее обращение в техническую поддержку ООО «Открытые технологии».
Подробнее об этом в статье «Полный административный доступ».
 Все нижеописанные настройки и действия подразумевают наличие активной (незаблокированной) учетной записи внешнего сервиса sms.ru с положительным балансом, обеспечивающим пользователю доступ к услугам в необходимом объеме.
 Подробнее в статье  «Использование сервиса «SMS.RU»

-Вернуться к Содержанию-

3. Включение и общая настройка плагинатребуются права Администратора

Чтобы данный плагин начал работать, его нужно включить и настроить.

Для того чтобы включить плагин необходимо перейти «Администрирование->Обмен сообщениями->Способ доставки сообщений по умолчанию» (Рис. 3.1) и установить маркер в соответствующем чекбоксе (Рис. 3.2) (или убедиться, что плагин уже включен -  маркер установлен).

 Рис. 3.1. Переход на страницу «Способ доставки сообщений по умолчанию» в меню «Администрирование».

 Рис. 3.2. Фрагмент страницы «Способ доставки сообщений по умолчанию», плагин OTSMS включен.

На странице «Способ доставки сообщений по умолчанию» (см. Рис. 3.2) также  отображается перечень возможных типов уведомлений (табличная форма «Настройки уведомлений по умолчанию»), о которых может быть проинформирован пользователь (поз. 1 Рис. 3.3), с доступными каналами уведомлений и следующими элементами управления этими каналами:

  • Выпадающее меню настроек канала (поз. 2 Рис. 3.3) с возможными опциями:
    • Не разрешено - пользователь не может использовать данный канал уведомлений.
    • Разрешено - пользователь может использовать данный канал уведомлений и управлять его настройками через личный кабинет.
    • Заблокировано - канал уведомлений настраивается Администратором, пользователь не может управлять настройками  через личный кабинет.
  • Чекбокс контроля события (поз. 3 Рис. 3.3). Если маркер не установлен, данное событие не формирует уведомлений ни по одному из представленных каналов.
  • Чекбоксы условия формирования уведомления (поз. 4 Рис. 3.3). Инструмент активен только при выборе опции «Разрешено» и формирует соответствующее уведомление по каналу, если пользователь авторизован в системе (На сайте) или не авторизован (Вне сайта).

Рис. 3.3. Фрагмент таблицы «Настройки уведомлений по умолчанию» страницы «Способ доставки сообщений по умолчанию». 

Для того, чтобы настроить плагин необходимо перейти «Администрирование->Обмен сообщениями->OTSMS» (Рис. 3.4) или нажав на соответствующую ссылку «Настройки» на экране «Способ доставки сообщений по умолчанию» (см. Рис. 3.2).

Рис. 3.4. Переход на страницу настроек «OTSMS» в меню «Администрирование».
Для версий ниже 3.9.5а настройки плагина находятся: «Администрирование->Плагины->Управление способами доставки сообщений».
Для проведения апгрейда системы  вы можете обратиться с заявкой в службу технической поддержки ООО «Открытые технологии».

На странице настроек «OTSMS» (Рис. 3.5) доступны следующие поля и настройки:

  • API ID. Здесь необходимо ввести API-ключ, полученный при регистрации в сервисе sms.ru (после авторизации его можно найти внизу на главной странице сервиса или в разделе «Программистам»).
  • Всегда добавлять тему к тексту сообщения (по умолчанию=Да). Опция добавляет тему к тексту всех сообщений перед отправкой (можно отключить для экономии места в сообщении).
  • Всегда транслитерировать (по умолчанию=Да). Позволяет транслитерировать все сообщения перед отправкой.
  • Длина транслитерированного сообщения (по умолчанию=140 символов). Лимит длины сообщения, состоящего из латинских символов. Если количество символов превышает установленное значение, текст  отправляется несколькими сообщениями.
  • Длина сообщения (по умолчанию=70 символов). Лимит длины сообщения, состоящего из смешанных символов. Если количество символов превышает установленное значение, текст  отправляется несколькими сообщениями.
  • Тестовый режим (по умолчанию=Нет). Режим проверки функционирования сервиса. При отправке сообщений от сервиса будут поступать ответы, текст сообщений будет фиксироваться в истории сообщений, но сами сообщения конечному адресату не будут доставляться.

Рис.3.5. Страница настроек «OTSMS».
 Добавление темы сообщения и транслитерация текста сообщения могут быть принудительно переданы плагином, который изначально генерирует сообщение. В этом случае настройки самого модуля OTSMS игнорируются.
Важно! Полная информация  по отправке уведомлений (дата и время обращения к сервису, запрос к сервису sms.ru, ответ и код ответа) фиксируется в базе системы. Ознакомится с ней можно только обладая соответствующими правами доступа к базе или обратившись в службу технической поддержки ООО «Открытые технологии».
Краткая информация (дата и время обращения к сервису, «доставлено/не доставлено») доступна в  "Журнале событий" СЭО 3КL.

-Вернуться к Содержанию-

4. Настройка личных уведомлений пользователем

Пользователь может определить индивидуальные настройки получения уведомлений, перейдя «Личный кабинет -► Настройки -► Настройка уведомлений»(раздел «Учетная запись пользователя») (Рис. 4.1).

 Рис. 4.1. Переход на страницу «Настройка уведомлений» в Личном кабинете пользователя.

На странице «Настройка уведомлений» (Рис. 4.2) в левом столбце таблицы отображается перечень событий, о которых может быть уведомлен пользователь, в остальных столбцах - каналы уведомления (вывод на экран,  отправка СМС, сообщение на электронную почту) с элементами управления (включено/выключено) этими каналами.

Рис. 4.2. Фрагмент страницы «Настройка уведомлений».

 Нажав на соответствующий элемент управления (кнопку) пользователь может изменить текущую настройку формирования уведомления по событию на противоположную; отметив  маркером чекбокс «Отключить уведомления» (расположен вверху таблицы) - отключить все уведомления (не относится к уведомлениям, настраиваемым Администратором).

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

-Вернуться к Содержанию-

5. Пример настройки отправки уведомлений

Задача: настроить уведомления о заданиях таким образом, чтобы они отправлялись по электронной почте и по СМС когда пользователь на сайте и вне сайта, а уведомления во всплывающем окне - только тогда, когда пользователь на сайте.

Рис.5.1.  Пример административных настроек плагина для получения уведомлений о заданиях.

Рис.5.2. Пример настроек уведомлений о заданиях в Личном кабинете пользователя.
Один из распространенных вариантов использования плагина OTSMS в системе - упрощенная регистрация и авторизация пользователя через СМС. Осуществляется это с помощью плагина авторизации «Синхронизация с Free Deans Office». Подробно процедура этой настройки описана в статье «Упрощение регистрации пользователей». После включения и настройки плагинов, данные по авторизации будут приходить в виде СМС на телефон пользователя.

-Вернуться к Содержанию-

Tags: администрирование, интеграция, коммуникации
Average rating: 0 (0 Votes)

You cannot comment on this entry