Как подключить и настроить коннектор Telegram?

18.08.2023

Для того чтобы установить коннектор, потребуется совершить несколько операций: 

  1. Создать бота, нам понадобится и API и ID этого канала.

  2. Создать (или отредактировать стандартный) новый шаблон задач с новыми полями. 

  3. Установить коннектор и подключить между собой Планфикс и Telegram 

В поиске Telegram найдите бота с именем @BotFather. Он поможет вам в создании и управлении вашим ботом.

2. Введите команду: /start, и бот покажет все возможные команды, которыми он может управлять.

3. Отправьте команду /newbot. BotFather предложит выбрать имя для вашего бота.

4. Назовите бота и отправьте его имя в чат.

5. Далее бот запрашивает имя пользователя, обязательным условием является окончание " _bot": "заданное имя пользователя«_bot.

6. Следующим сообщением бот пришлет токен.

Он нам понадобиться. Не забудьте где его искать)

7. Найдите и запустите вашего бота командой /start

Создание канала Telegram

1. В меню «Telegram» выберите «Создать канал», введите название.

2. В новом канале перейдите в раздел «Управление каналом» — «Администраторы» — «Добавить администратора».

3. Выберите созданного бота в качестве администратора и сохраните данные.


Создаем новый шаблон или редактируем стандартный.

Переходим в Планфикс. 

Можно использовать Стандартный шаблон, но для удобства предлагаю создать шаблон  Автопостинг Telegram. В любом случае в шаблон задачи нам нужно добавить новые поля. Если вы выбрали Стандартный шаблон, нажмите кнопку Редактировать. 

Здесь мы будем создавать новый шаблон для публикаций постов в Telegram.

Для этого нам нужно создать новые поля: Текст, Изображения, ID канала, Дата публикации.

Нажимаем на кнопку Новое поле

В Тип поля выбираем Текст. В окне Новое поле прописываем название, в нашем случае это название Текст. И переводим триггер Использовать редактор текста, в состояние Включен. Сохраняем.

Снова нажимаем кнопку Новое поле. В Тип поля выбираем Файлы. В окне Новое поле прописываем название, в нашем случае это название Изображение. Сохраняем.

Снова нажимаем кнопку Новое поле. В Тип поля выбираем Число. В окне Новое поле прописываем название, в нашем случае это название ID канала. Сохраняем.

Снова нажимаем кнопку Новое поле. В Тип поля выбираем Дата и время. В окне Новое поле прописываем название, в нашем случае это название Дата публикации. Сохраняем.


Создав новые поля в шаблоне, нам нужно добавить в поле ID канала. 


Как это сделать: в Telegram находим любого бота который, в ответ на запрос отправляет нам ID, например IDBot. Получив наше сообщение бот отправит ответ

ID канала не меняется. И это поле обязательно должно быть заполнено перед сохранением всего шаблона. 

Нажимаем кнопку Создать шаблон.

Теперь нам доступен новый шаблон задач Автопостинг Telegram


Подключаем Telegram в Планфикс.

Управление аккаунтом — интеграции — мессенджеры –- Telegram –- Собственный бот — Добавить бота. Появиться окно настроек

Даем имя боту и в ключ доступа вставляем токен из BotFather. И обращаем внимание, если мы создали новый шаблон для Telegram, в поле Шаблон для создания новых задач нам нужно выбрать необходимый шаблон. 

Мы создали бота в Telegram, мы создали бота в Планфикс и теперь мы подключаем коннектор.

Добавление коннектора Telegramm невозможно без подключения сервиса Планфикс. Как добавить Планфикс на getupd.io смотрим по ссылке

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


Аккаунты у нас уже добавлены, нажимаем Добавить.


Открывается большое окно, не пугаемся. Отсюда мы будем копировать данные, и выбирать параметры.



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


Настройки / Процессы задач / Стандартный / Кнопки / Нажимаем создать Новую кнопку. Появляется окно настроек


В поле 3 “Кто видит кнопку и может ее нажать” выбираем пункт “Выбранные пользователи”

Затем, в поле ниже, выбираем себя



В поле 4 можно задать цвет кнопки, текст. Для удобства я назову Telegram и пропишу это название в поле Текст на кнопке. 



Переходим к полю 5. Сюда мы будем копировать данные из настроек коннектора с сайта getupd.io


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



Переходим к сайту getupd.io и настройкам коннектора, нам понадобятся вот эти данные:



Копируем URL с сайта getupd.io и вставляем в поле URL в ПланФикс 

В поле Содержимое запроса копируем Параметр с сайта getupd.io . Вставляем в поле Параметр. И затем копируем  Значение. Вставляем в поле Значение

Следующее поле Заголовки, нажимаем Добавить , появляется два поля в которые нам нужно скопировать данные. Сам заголовок и его значение. 


ВАЖНО! Для корректной работы в поле Авторизация нужно поставить галочки в пункты “Добавлять комментарий в задачу если сервер не отвечает” и в “Не повторять запрос если сервер возвращает ошибочный код ответа”. 




Все. На сайт Планфикс мы скопировали и вставили все нужные нам данные, для создания кнопки, нажимаем Сохранить.

Возвращаемся в Настройки коннектора на сайте getupd.io (если вдруг вы закрыли настройки, не отчаивайтесь их можно открыть нажав на иконку шестеренки созданного коннектора)

Будем выбирать созданные нами ранее поля: 

В Шаблоны задач выбираем Telegram если вы создавали новый шаблон, либо Стандартный шаблон, если вы просто добавили новые поля. У меня это отдельный шаблон Автопостинг Telegram.

Теперь Поля задачи у нас должны соответствовать друг другу.

Поле Текст, выбираем Текст, в поле Изображение выбираем Изображение и т.д. 

Эти данные прописываются автоматически для сценария.

Все, сохраняем изменения, проверяем чтобы триггер коннектора был в состоянии Включен. 

Готово! Коннектор подключен и  настроен.


С дополнительными вопросами по работе сервиса обращайтесь на почту mailbox@getupd.io или нажмите на кнопку «Обратиться за помощью». Служба поддержки поможет разобраться с первичной настройкой коннекторов.

Вернуться назад