Интеграция Telegram Custom для бизнеса

Чтобы подключить отправку уведомлений через интеграцию Telegram Custom, нужно создать Telegram-бот и получить API Token. Это доступно любому пользователю Telegram.

Посмотреть подробную инструкцию, как создать Telegram-бот через BotFather и получить токен >>

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

Если хотя бы один из этих пунктов не был настроен, на этапе подписки на канал вы увидите такое сообщение:

1 Notify.Events - интеграция не настроена.png

Шаг 1. Настройка интеграции

  1. Перейдите на экран Интеграции. Это можно сделать через выпадающее меню в верхнем правом углу экрана. Не забудьте убедиться, что вы залогинены в системе.
  2. 2 Notify.Events - Интеграции.png
  3. Нажмите на кнопку Создать.
  4. 3 Notify.Events - создать интеграцию.png
  5. Кликните по карточке Telegram Custom.
  6. 4 Notify.Events - добавить Telegram Custom.png
  7. Введите API Token вашего чат-бота Telegram и нажмите кнопку Сохранить.

Посмотреть инструкцию, как получить токен >>

5 Notify.Events - ввести токен.png

Теперь созданная интеграция появится на экране Интеграции.

6 Notify.Events - созданная интеграция Telegram Custom .png

Шаг 2. Разрешение подписки

  1. Перейдите в свойства канала через кнопку Редактировать на главном экране Панели управления или на экране канала.
  2. 7 Notify.Events - редактировать канал.png
  3. Поставьте галочку напротив Telegram Custom в поле Разрешить подписку через интеграции и нажмите кнопку Сохранить. Telegram Custom будет отображаться в этом поле только после успешного выполнения Шага 1.
8 Notify.Events - разрешить подписку.png

На следующем этапе вы сможете добавить кастомную интеграцию на канал.

Шаг 3. Добавление кастомной интеграции на канал

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

Так как Telegram Custom предполагает подписку только посредством API, чтобы начать ее использовать, вам потребуется настроить API.

Посмотреть документацию Notify.Events API >>

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



Где взять API Token бота Telegram?

API токен генерируется автоматически после создания бота. Чтобы создать своего Telegram-бота и получить токен, следуйте этой инструкции:

  1. Войдите в Telegram под своим логином, найдите в поиске юзера @BotFather (или просто перейдите по ссылке t.me/botfather) и нажмите кнопку Начать.
  2. BotFather - Шаг 1.png
  3. В открывшемся диалоговом окне выполните команду /newbot.
  4. BotFather - Шаг 2.png
  5. Придумайте и введите название вашего бота в произвольной форме.
  6. BotFather - Шаг 3.png
  7. Придумайте и введите юзернейм вашего бота. Он должен оканчиваться на bot (например, NotifyBot или notify_bot). Если имя уже занято, бот сообщит вам об этом.
  8. BotFather - Шаг 4.png
  9. После создания бота вы получите сообщение с подтверждением, дальнейшими инструкциями по настройке и персональным токеном для доступа к API. Он нам и нужен.
BotFather - Шаг 5.png

В будущем узнать токен можно так: выполните в чате с BotFather команду /mybots и выберите в ответном сообщении API Token.

BotFather - Шаг 6.png

Полная инструкция по созданию Telegram-ботов, а также доступный функционал описаны на официальном сайте мессенджера в разделе API > Bot API.

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