Плагин: Уведомление пользователей (Боты)

О плагине

Плагин позволяет отправлять уведомления по событиям в системе в поддерживаемые мессенджеры. Пользователь самостоятельно может подписаться или отписаться на уведомления. Все сообщения отправляются приватно.



Возможности

  • Отправка уведомлений всем пользователям, подписанным на уведомления
  • Мгновенная доставка уведомлений
  • Поддержка различных мессенжеров
  • Поддержка шаблонов для каждого типа события
  • Редактор шаблонов с возможностью вставки тэгов для замены
  • Ведение лога отправленных сообщений

Настройка плагина

 

Бот для Telegram

  1. На вкладке "Справка" подключите все или только необходимые события к системе WebHook (для CRM)
  2. Зарегистрируйте бота:
  3. Подключим бота к плагину на вкладке "Боты, Пользователи"
    • Достаточно указать тип бота и Secret Key
    • Далее нажмем "Проверить" - в случае успешного подключения будут заполнены поля "Bot ID" и "Имя бота"
    • После сохранения бота можно узнать состояние подключения Webhook с помощью ссылки "Инфо" в колонке "Действия"
  4. Добавляем сотрудников, которому будет доступна возможность получать уведомления
    • Заполненное поле "User ID" дает плагину понять, что сотрудник подписан на уведомления
    • Поле "User ID" можно не заполнять, оно будет заполнено при первом подключении сотрудника к боту
    • Уведомления будут получать только активные пользователи CRM

Подписка на уведомления и отписка

Пользователь будет подписан на уведомления через Webhook Telegram сразу после ввода команды "/start", т.е. после подключения к боту.

Для отключения уведомлений необходимо набрать команду "/stop"

Важно для функционирования

  • Адрес скрипта для подключения Webhook в Telegram: http://sm20179.crm/plugins/userNotifier/callback.php?api_key=gCG01Q5MA8msP1jXuQUC
  • Регистрация Webhook проводится в момент сохранения настроек бота автоматически.
  • Самоподписанные сертификаты не поддерживаются плагином (рекомендуем использовать сертификаты от Let’s Encrypt).
  • На текущий момент отправка обновлений через вебхуки доступна только на эти порты: 443, 80, 88, 8443

Бот для Slack

  1. На вкладке "Справка" подключите все или только необходимые события к системе WebHook (для CRM)
  2. Создайте приложение:
    • Создадим приложение в Slack - https://api.slack.com/apps/new
    • Вариант 1:
    • В разделе "Install App" подключим команду к приложению и получим "Bot User OAuth Access Token" (Secret Key)
    • В разделе "Bot Users" добавим пользователя-бота
    • Вариант 2:
    • Добавим бота - https://my.slack.com/services/new/bot
    • Получим "API Token" (Secret Key) для бота
  3. Подключим бота к плагину на вкладке "Боты, Пользователи"
    • Достаточно указать тип бота и Secret Key (Bot User OAuth Access Token)
    • Далее нажмем "Проверить" - в случае успешного подключения будут заполнены поля "Bot ID" и "Имя бота"
    • Нажимаем "Сохранить" и переходим к добавлению сотрудников
  4. Добавляем сотрудников, которым плагин будет отправлять уведомления
    • В поле "Username" указываем имя сотрудника в Slack (без знака @) либо..
    • ..Сотрудник может создать спец.канал для получения уведомлений из CRM. В этом случае следует указать имя канала
    • В поле "User ID" можно не заполнять
    • Уведомления будут получать только активные пользователи CRM

Подписка на уведомления и отписка

Действий не требуется

Работа с шаблонами

Формирование сообщений происходит с использованием шаблонизатора Mustache (http://mustache.github.io/mustache.5.html) и набора специальных тегов.

  • Шаблонами можно управлять на вкладке "Шаблоны"
  • Поддерживается один шаблон для каждого события
  • Поддерживается вставка спец.тэгов
  • Для каждого события предоставляется свой набор тэгов, который будет доступен после выбора события

Важно

  • Если для события отсутствует шаблон, то оно будет игнорироваться, даже если WebHook активен
  • Тег {{{comments}} содержит расширенную информацию, которая отличается для каждого события
  • Большинство ботов не поддерживают html в сообщениях, либо поддерживают его на минимальном уровне

Приобретение

Данный плагин не является бесплатным и не входит в состав дистрибутива. Запрос на подключение можно отправить по email: team@salesman.pro

Что-то не понятно? Задай вопрос: