Модуль Telegram позволяет вам управлять вашим ботом Telegram. В нем появился блок бизнес-процессов «Отправить сообщение», который добавляет функцию отправки сообщений в телеграм-каналы.
Для работы модуля не нужно программировать бота. Вам нужно только создать его, добавить в телеграм-канал и правильно настроить компоненты Appmaster Studio.
Создать бота
Для создания ботов и управления ими вам необходимо использовать BotFather , бота, разработанного командой Telegram.
Введите в поле поиска имя пользователя «botfather» — скорее всего, оно будет первым в списке (1). Обратите внимание, что официальный бот имеет синий значок подтверждения с галочкой рядом с его именем (2). Под "поиском" будет много других, с такими же именами и похожими юзернеймами - просто игнорируйте их, они вам не нужны.
Нажмите на бота, чтобы открыть с ним чат (1), и нажмите Старт (2).
После этого бот запустится и выведет в сообщении список команд. Для создания нового бота введите последовательно:
- команда /newbot (1);
- имя вашего бота, оно может быть любым (2);
- уникальное имя пользователя, по которому его легко найти (3).
Бот создан. BotFather сообщит вам об этом в сообщении, указав имя пользователя (4) и токен авторизации (5).
Токен нужен для подключения к различным сервисам и программам — он используется для того, чтобы Telegram мог идентифицировать вашего бота и определить, какие у него есть разрешения.
Не разглашайте токен авторизации бота посторонним и не публикуйте его в открытом доступе. Если токен был рассекречен, вы можете отозвать его (команда /revoke) и сгенерировать новый (команда /token).
Для интеграции с Appmaster.io нужно просто добавить бота в телеграм-канал. Вы также можете настроить его, чтобы добавить дополнительные функции. Подробнее о том, что такое бот, что он умеет и как его настроить, можно узнать на официальном сайте Telegram . Он содержит как общую информацию , так и инструкции для разработчиков .
Создать телеграмм канал
Чтобы создать канал, перейдите в меню своей учетной записи и нажмите «Новый канал» .
Введите название канала, если хотите - добавьте описание (1). Нажмите Создать (2).
Выберите, будет ли ваш канал общедоступным или закрытым-частным (1). Введите уникальную ссылку, по которой вы можете ее найти (2). Сохраните изменения (3).
Добавить бота на канал
Сразу после создания канала Telegram предложит добавить в него новых пользователей. Начните вводить имя пользователя вашего бота - оно появится в поиске (1). Нажмите на него (2).
Ваш бот появится в списке пользователей для добавления (1). Щелкните Добавить, чтобы завершить настройку (2).
Выскакивает сообщение, что ботов можно добавлять в каналы только в качестве администраторов. Согласитесь сделать бота администратором, нажав Сделать администратором .
Теперь выберите разрешения на управление каналом, которые вы хотите предоставить своему боту. Выберите то, что вы предпочитаете, но обязательно разрешите боту отправлять сообщения, включив переключатель «Отправлять сообщения» (1). Нажмите Сохранить (2).
Вы можете добавить бота после создания канала. Чтобы добавить бота в уже созданный канал, откройте настройки (1) и нажмите Добавить пользователей (2). Далее - те же действия, что и в предыдущем пункте.
Найдите данные для настройки
Чтобы добавить бота в свое приложение и отправлять сообщения в телеграм-канал, вам нужен токен авторизации бота и адрес канала.
Узнать токен бота можно у BotFather: введите команду /mybots, чтобы получить список всех ваших ботов (1) и выберите нужного. Появится меню, выберите в нем пункт API token (2). BotFather отправит вам сообщение с токеном.
Адрес канала есть в общей информации о нем — Channel Info . Чтобы открыть окно с информацией, зайдите в настройки или просто нажмите на название канала.
Отлично, теперь вы готовы подключить бота к своему приложению. Перейдите в студию Appmaster .
Настроить студию Appmaster
Установите модуль Telegram.
В настройках модуля укажите токен вашего бота (1) и сохраните изменения (2).
Перейдите в конструктор бизнес-логики (1), создайте новый бизнес-процесс (2).
Включите в бизнес-процесс блок « Отправить сообщение », который добавляет модуль Telegram (1). Обратите внимание, что в блоке Start нужно создать две переменные типа string (первая — адрес канала, вторая — текст вашего сообщения) и соединить их с переменными блока Send Message (2,3) . Это нужно для создания формы для отправки сообщения. Не забудьте сохранить схему (4).
На вкладке Конечные точки (1) добавьте новую конечную точку (2). Введите имя и группу, в которой оно будет отображаться (3). Установите тип запроса POST (4). В поле Бизнес-процесс выберите только что созданный бизнес-процесс (5).
Подробнее о конечных точках .
На вкладке Middleware можно разрешить доступ к конечной точке только администраторам — чтобы обычные пользователи не могли отправлять сообщения через бота.
В дизайнере веб-приложений (1) откройте свое приложение и перейдите на страницу, с которой пользователи будут отправлять сообщения в Telegram (2). Создайте в нем форму для отправки сообщения, перетащив элемент Форма в выделенную область страницы (3).
Дополнительную информацию о Конструкторе веб-приложений можно найти здесь .
При создании формы выберите тип « Создать запись » (1) и созданную вами конечную точку (2).
Добавьте кнопку для отправки сообщений в поле под формой.
Введите имя, которое будет отображаться на кнопке (1) и уникальное имя, по которому вы будете искать ее в настройках (2). При желании измените его дизайн.
На вкладке Триггеры (1) добавьте действие для триггера onClick — по клику (2).
Откроется окно настроек. Укажите в поле Целевой компонент созданную вами форму (1) и выберите для нее действие Отправить форму (2).
Теперь сохраните все изменения (1) и опубликуйте проект (2). Нажмите на кнопку, чтобы перейти к опубликованному веб-приложению (3).
Если вы установили ограничение на отправку сообщений только для пользователей группы Admins, вам потребуется войти в приложение под учетной записью администратора.
Откройте страницу отправки бота, введите текст сообщения и название вашего канала.
Убедитесь, что все работает — ваше сообщение должно появиться в Telegram.
Пишите в чат нашего сообщества , если у вас есть вопросы - мы будем рады на них ответить!
Подписывайтесь на нас в мессенджерах и социальных сетях, чтобы не пропустить важное и интересное!
- Новости и обновления — в телеграм-канале Appmaster.io , в Facebook и LinkedIn .
- В нашем блоге вы найдете пошаговые инструкции, руководства и идеи по созданию приложений.
- У нас теперь есть видео инструкции для вас здесь .
