БП Уведомления в Telegram

Добавьте новые возможности в свой Битрикс24

Оформите подписку Битрикс24 Маркет Плюс и используйте более 3000 полезных приложений, представленных в каталоге.

БП Уведомления в Telegram
Лабораториум
Установить
Скриншоты
Приложение добавляет на портал робота и активити бизнес-процесса для отправки сообщений и уведомлений сотрудникам в Telegram.

В профиле сотрудников появится поле для Telegram ID. Заполнив это поле вы сможете отправлять сообщения сотрудникам в Telegram, как обычные уведомления, указывая в настройках робота роль сотрудника (например, ответственного за лид), отдел или группу.

Что можно отправить:
  • Форматированный текст со ссылками (с предпросмотром или без);
  • Фотографии и галереи;
  • Видео;
  • Аудио;
  • Документы и файлы;
  • Контакты.
При отправке в тексте сообщения ссылки в настройках робота можно включить или отключить создание превью.
Отключите создание превью при отправке ссылок на портал или другие закрытые сайты, чтобы сэкономить место в чате и не отображать превью страницы авторизации.



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


Если включить отправку всех файлов в виде документов, то все фото и другие медиа-файлы придут получателю в исходом виде для скачивания.


При стандартной отправке приложение сгруппирует файлы по типам и отправит медиа-файлы в виде галереи для удобного просмотра в Telegram.


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


В настройках робота можно включить бесшумную отправку сообщения.
Если процесс должен отправлять много уведомлений, на которые не требуется оперативная реакция сотрудника, или сообщения отправляются для фиксирования истории прохождения процесса, можно отключить push-уведомление.
В списке чатов будет видно, что в данный чат пришло новое сообщение, но push не придёт и не будет звукового уведомления.

Приложение поддерживает работу с любым кол-вом Telegram ботов.
Вы можете настроить разных ботов для разных типов уведомлений, чтобы сотрудники могли сразу понимать, от какого процесса пришло уведомление, а так же могли выборочно подписываться на нужных ботов или отключать звук у менее важных ботов.

Версия 1
Добавляет робота и активити для дизайнера бизнес-процессов, которые позволяют отправлять сообщения и уведомления сотрудникам в Telegram

ках котоЕсли возникнут вопросы, свяжитесь с нами:

В настройках приложения добавьте токены ваших Telegram-ботов.



Для добавления нового токена просто заполните пустое поле в новой строке.
Для удаления ранее добавленного бота просто сотрите токен в его строке.
И сохраните настройки.

При сохранении настроек приложение получит данные ботов (Название и ссылки) и добавит всех указанных ботов в выпадающий список в настройках робота (и активити).

Обратите внимание!
При удалении бота из настроек перестанут работать те роботы и активити, в настройках которых ранее был выбран удалённый бот.


Как получить токен для бота?
Создать своего бота можно при помощи специального бота Telegram BotFather

Отправьте команду /newbot для создания нового бота.
Отправьте название бота.
Далее отправьте имя вашего бота. Имя должно быть указано латинскими буквами и обязательно заканчиваться "bot".
Например: test_bot

В ответ BotFather пришлёт сообщение с токеном, который можно скопировать и указать в настройках приложения.



Чтобы установить фото в профиль бота, отправьте команду /setuserpic
Далее отправьте имя вашего бота (например, test_bot).
Отправьте изображение, которое хотите установить.

Как получить ID пользователей?
ID пользователя поможет узнать бот Get My ID
Каждый сотрудник должен открыть этого бота в своём Telegram и нажать Start.
В ответ бот пришлёт сообщение с ID текущего пользователя.


Этот ID нужно указать в профиле пользователя на портале в поле "ID пользователя Telegram".
Если поле не видно в профиле после установки приложения, нужно выбрать это поле для отображения при помощи кнопки "Выбрать поле".


В коробочной версии добавить пользователю "ID пользователя Telegram" можно в панели администрирования.
Для этого:
  • Перейти в Администрирование -> Настройки -> Пользователи -> Список пользователей;
  • Открыть настройки любого из пользователей;
  • В правом верхнем углу нажать на иконку настройки формы редактирования;
  • Выбрать слева "Доп. поля" и поле "ID пользователя Telegram";
  • Справа выбрать вкладку, на которую необходимо вывести новое поле;
  • Нажать на ">", чтобы перенести поле на вкладку;
  • Сохранить настройки;
  • Теперь на выбранной вкладке появится поле "ID пользователя Telegram".


Теперь вы готовы отправлять пользователям уведомления в Telegram
В качестве получателя можно указать:
  • Конкретного сотрудника;
  • Роль сотрудника в сущности, на которой запускается робот (например, ответственный за сделку или лид);
  • Отдел (с подотделами или без);
  • Группу социальной сети.
Поддерживается отправка нескольким пользователям, поэтому типы получателей можно комбинировать.

Обратите внимание!
Приложение работает с группами социальной сети, но не умеет работать с группами пользователей, которые настраиваются в админке коробочных порталов.
В настройках активити в дизайнере БП в стандартное поле привязки сотрудников можно указать группу (например, группу Сотрудники или Администраторы), но приложение не сможет узнать состав группы в силу ограничений Rest API.

Для отправки контакта необходимо указать и имя, и телефон. Если будет заполнено только одно из полей, контакт не отправится.

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

Если в получателях указываются участники группы социальной сети, рекомендуется в настройках робота указывать, чтобы робот запускался от имени администратора портала. Если робот запустится от имени пользователя, у которого нет доступа к группе, он не сможет получить список сотрудников группы.