Плагин: Уведомление пользователей (Боты)
О плагине
Плагин позволяет отправлять уведомления по событиям в системе в поддерживаемые мессенджеры. Пользователь самостоятельно может подписаться или отписаться на уведомления. Все сообщения отправляются приватно.
Возможности
- Отправка уведомлений всем пользователям, подписанным на уведомления
- Мгновенная доставка уведомлений
- Поддержка различных мессенжеров
- Поддержка шаблонов для каждого типа события
- Редактор шаблонов с возможностью вставки тэгов для замены
- Ведение лога отправленных сообщений
Настройка плагина
Бот для Telegram
- На вкладке "Справка" подключите все или только необходимые события к системе WebHook (для CRM)
- Зарегистрируйте бота:
- в Telegram (https://tlgrm.ru/docs/bots)
- Подключим бота к плагину на вкладке "Боты, Пользователи"
- Достаточно указать тип бота и Secret Key
- Далее нажмем "Проверить" - в случае успешного подключения будут заполнены поля "Bot ID" и "Имя бота"
- После сохранения бота можно узнать состояние подключения Webhook с помощью ссылки "Инфо" в колонке "Действия"
- Добавляем сотрудников, которому будет доступна возможность получать уведомления
- Заполненное поле "User ID" дает плагину понять, что сотрудник подписан на уведомления
- Поле "User ID" можно не заполнять, оно будет заполнено при первом подключении сотрудника к боту
- Уведомления будут получать только активные пользователи CRM
Подписка на уведомления и отписка
Пользователь будет подписан на уведомления через Webhook Telegram сразу после ввода команды "/start", т.е. после подключения к боту.
Для отключения уведомлений необходимо набрать команду "/stop"
Важно для функционирования
- Регистрация Webhook проводится в момент сохранения настроек бота автоматически.
- Самоподписанные сертификаты не поддерживаются плагином (рекомендуем использовать сертификаты от Let’s Encrypt).
- На текущий момент отправка обновлений через вебхуки доступна только на эти порты: 443, 80, 88, 8443
Бот для Slack
- На вкладке "Справка" подключите все или только необходимые события к системе WebHook (для CRM)
- Создайте приложение:
- Создадим приложение в 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) для бота
- Подключим бота к плагину на вкладке "Боты, Пользователи"
- Достаточно указать тип бота и Secret Key (Bot User OAuth Access Token)
- Далее нажмем "Проверить" - в случае успешного подключения будут заполнены поля "Bot ID" и "Имя бота"
- Нажимаем "Сохранить" и переходим к добавлению сотрудников
- Добавляем сотрудников, которым плагин будет отправлять уведомления
- В поле "Username" указываем имя сотрудника в Slack (без знака @) либо..
- ..Сотрудник может создать спец.канал для получения уведомлений из CRM. В этом случае следует указать имя канала
- В поле "User ID" можно не заполнять
- Уведомления будут получать только активные пользователи CRM
Подписка на уведомления и отписка
Действий не требуется
Работа с шаблонами
Формирование сообщений происходит с использованием шаблонизатора Mustache (http://mustache.github.io/mustache.5.html) и набора специальных тегов.
- Шаблонами можно управлять на вкладке "Шаблоны"
- Поддерживается один шаблон для каждого события
- Поддерживается вставка спец.тэгов
- Для каждого события предоставляется свой набор тэгов, который будет доступен после выбора события
Важно
- Если для события отсутствует шаблон, то оно будет игнорироваться, даже если WebHook активен
- Тег {{{comments}} содержит расширенную информацию, которая отличается для каждого события
- Большинство ботов не поддерживают html в сообщениях, либо поддерживают его на минимальном уровне