Подробная инструкция о том, как создать бота для предоставления демо-доступа и контроля подписок на приватный канал в Telegram.
Александр Волков
Руководитель отдела разработки программного обеспечения компании «Синимекс»
Telegram набирает популярность не только у пользователей, но и у разработчиков. Многие создают там свои каналы и ботов. В этой статье мы создадим приватный канал с фасадом для него — ботом.
Возможности бота
Через бота можно будет:
- получить полную информацию о канале;
- получить демо-доступ на канал. Пользователь в автоматическом режиме получит ссылку на вступление в приватный канал. Через n дней демо-доступа пользователь будет удалён из канала;
- выдать полный доступ для пользователей. Пользователь сможет отправить данные для получения полного доступа. Данные могут быть проверены как в автоматическом режиме, так и в ручном — самим администратором. По итогам пользователю выдаётся полный доступ.
Дополнительно к этому мы создадим интерфейс на React для управления подписками и сбором аналитики по каналу. Особенность этого решения — простота. Время на его создание — около 4 часов. Все компоненты решения для удобства будут развёрнуты в docker-контейнерах. Схема нашего решения будет выглядеть так:
Добавление Бота в Администраторы канала Телеграм
Создание бота
Начнём с самого простого шага — создания бота в Telegram. Для этого достаточно написать команду /newbot боту по созданию других ботов BotFather и следовать инструкциям:
После успешного создания бота вы получите сообщение:
Также появится токен, который мы будем использовать для подключения к боту из своего приложения.
Бот для приватного канала с информацией о самых вкусных плюшечках и пирожочках создан. Далее создадим сам канал и добавим туда нашего бота в качестве администратора.
Создание базы данных
Для простоты решения поднимем PostgreSQLв docker-контейнере:
docker network create buns-net docker run -d —network=»buns-net» —name bot-postgres -e POSTGRES_PASSWORD=Pass2020! -p 5432:5432 postgres
Контейнер запущен, БД готова к работе.
Для минимальной аналитики и контроля подписок нам хватит одной таблицы. Заполним её модель и далее в миграции lequibase создадим:
Создание бэкенда
Перейдём на Spring Initializr и сгенерируем каркас бэкенд-приложения. Достаточно выбрать следующие библиотеки:
Развернём сгенерированный проект в среде разработки и добавим туда зависимость для работы с Telegram:
compile «org.telegram:telegrambots-spring-boot-starter:5.0.1»
Также добавим библиотеку для мапинга, которая нам пригодится при мапинге сущностей БД в REST-модели:
compile(«net.rakugakibox.spring.boot:orika-spring-boot-starter:1.9.0»)
Создадим миграцию для таблицы, добавим описание подключения к БД и запустим приложение:
1-add-tables.yaml databaseChangeLog: — changeSet: id: 1-add-tables author: avolkov changes: — createTable: tableName: subscriber columns: — column: name: id type: bigint autoIncrement: true constraints: primaryKey: true nullable: false — column: name: name type: varchar(255) constraints: nullable: true — column: name: login type: varchar(255) constraints: nullable: true — column: name: telegram_id type: varchar(100) constraints: nullable: false — column: name: start_subscribe type: timestamp constraints: nullable: false — column: name: end_subscribe type: timestamp constraints: nullable: false — column: name: type_subscribe type: varchar(50) constraints: nullable: false — column: name: enable type: boolean constraints: nullable: false db.changelog-master.yaml databaseChangeLog: — include: file: db/changelog/1-add-tables.yaml
application.yaml server: servlet: context-path: /api spring: datasource: driver-class-name: org.postgresql.Driver url: jdbc:postgresql://bot-postgres:5432/postgres — при локальной разработке поменять на localhost username: postgres password: Pass2020! jpa: properties: hibernate.dialect: org.hibernate.dialect.PostgreSQLDialect hibernate.globally_quoted_identifiers: true
После успешного запуска приложения накатится миграция и создастся таблица:
Таблица создана, приложение успешно запустилось. Теперь можно приступить к описанию Data Access Layer. Для этого опишем сущность, репозиторий и сервис:
Подключение к API Telegram
Чтобы можно было получать данные из бота в наше приложение, достаточно унаследовать от абстрактного класса org.telegram.telegrambots.bots.TelegramLongPollingBot и реализовать три метода:
public String getBotUsername(); // логин бота, который устанавливался при создании бота public String getBotToken(); // токен, полученный при создании от BotFather public void onUpdateReceived(Update update); // метод срабатывает каждый раз, когда боту отправляется сообщение
Добавим в application.yaml данные бота, которые получили от BotFather:
telegram: name: bot_login token: 164024384:AAFHwer2342pVF3zm_wZ45454554JVr_I chanel-id: -1001415979632 — id приватного канала, куда будет даваться доступ
Реализуем поддержку 5 команд:·
- /info — запрос информации о боте и канале;
- /start — такая же, как и info. Нужна для первого сообщения с ботом;
- /demo — получение демо-доступа на канал;
- /access — запрос на получение информации о полном доступе;
- /success — запрос на получение полного доступа.
Чтобы всеми этими командами было удобно пользоваться, реализуем их в виде кнопок, используя org.telegram.telegrambots.meta.api.objects.replykeyboard.InlineKeyboardMarkup.
Готово! Теперь бот умеет обрабатывать следующие команды.
Как получить доступ?
Хочу демо-доступ на 3 дня.
После получения демо-доступа информация об этом сохраняется в БД. При повторном запросе на демо-доступ пользователю отобразится ошибка:
Если пользователи могут получать временный доступ, то появляется задача проверки истечения этого доступа. К сожалению, не получится создать планировщик, который будет раз в день отписывать пользователей с истекшим доступом. Поэтому надо реализовать поддержку ещё одной команды для чистки подписчиков.
Чтобы этой командой мог пользоваться только администратор, его Chat ID надо добавить в application.yaml. Далее этот идентификатор будет использоваться при проверке, от кого пришла команда и имеет ли этот пользователь права на выполнение этой команды.
telegram: name: bot_login token: 164024384:AAFHwer2342pVF3zm_wZ45454554JVr_I chanel-id: -1001415979632 — id приватного канала, куда будет выдаваться доступ support: chat-id: 14334538544
Дополнительно к этому требуется реализовать команду выдачи полного доступа. Класс поменяется следующим образом:
Появилась обработка команд от администратора.
Если пользователь отправит сообщение message please, то администратору от бота придет сообщение:
После этого администратор может отправить боту команду на выдачу прав пользователю:
И пользователю от бота придет сообщение:
Таким образом, мы реализовали следующие возможности для пользователя:
- пользователь может узнать подробную информацию о канале и понять, подходит ли он ему;
- пользователь может получить временный доступ к каналу;
- пользователь может получить информацию о дальнейших действиях для получения полного доступа к каналу;
- пользователь может отправить запрос на предоставление полного доступа.
В свою очередь, у администратора канала появились следующие возможности:
- проверить предоставляемые пользователем данные для полного доступа и выдать полный доступ;
- очистить канал от пользователей с истекшим доступом.
Для удобства развёртывания упакуем наше приложение в Docker и развернём. Добавим в build.gradle:
bootJar
FROM openjdk:8-jdk-alpine COPY build/libs/buns.jar buns.jar EXPOSE 8081 ENTRYPOINT [«java»,»-jar»,»/buns.jar»]
Далее выполним следующие команды для создания образа и запуска его в докере:
Создание фронтенда
После того, как мы создали handler для обработки команд бота, хочется визуально контролировать подписки и смотреть графики по приросту подписок в разрезе месяца. Для этого создадим отдельное приложение на React с использованием Ant Design. Выполним команду:
npx create-react-app my-app
После этого у нас будет сгенерировано приложение с минимальной функциональностью. Однако требуется установить ещё несколько библиотек:
После этого основной компонент надо изменить на:
App.js import ‘./App.css’; import < QueryClient, QueryClientProvider >from ‘react-query’ import SubscriberTable from «./SubscriberTable»; import React from «react»; import ‘antd/dist/antd.css’; const queryClient = new QueryClient(); function App() < return > ; > export default App;
И добавить новый компонент:
Дополнительно к этому добавить функции для выполнения запросов:
axiosInstance.js import axios from ‘axios’; const host = process.env.REACT_APP_API_ENDPOINT; export const baseUrl = `http://localhost:8080/api/`; const instance = axios.create(< baseURL: `$`, withCredentials: true, headers: < ‘Cache-Control’: ‘no-store, no-cache, must-revalidate’, Pragma: ‘no-cache’, >, >); instance.defaults.headers.common[‘Accept-Language’] = ‘ru-RU, ru’; instance.interceptors.request.use(config => < return < . config, url: encodeURI(config.url), >; >); export default instance;
subscribersApi.js import * as log from ‘loglevel’; import instance from ‘./axiosInstance’; const SUBSCRIBER_PATH = ‘/subscribers’; const SubscribersApi = < name: ‘SubscribersApi’, async getAll() < return instance .get(`$`, < auth: < username: ‘admin’, password: ‘admin’ >>) .then(response => < log.info(`All Lines`, response); return response.data; >) .catch([]); >, async getStatistic() < return instance .get(`$/stat`) .then(response => < return response.data; >) .catch([]); >, >; export default SubscribersApi;
Это личный проект, аутентификация зашита, можно с ней особо не заморачиваться. Также в бэкенд требуется добавить конфигурацию Spring Security:
В итоге после выполнения команды npm start откроется http://localhost:3000/ с отображением списка подписок и статистикой. Статистику можно выводить в любом разрезе. В текущей реализации показывается, в каком месяце сколько полных подписок было оформлено.
А теперь для удобства упакуем и развернём UI в docker-контейнере. Для этого создадим DockerFile:
Dockerfile FROM nginx:1.19.5 COPY build /usr/share/nginx/html/ COPY nginx.conf /etc/nginx/ RUN chown -R nginx:nginx /var/cache/nginx /etc/nginx/ /var/run/ USER nginx EXPOSE 80 ENTRYPOINT [«nginx», «-g», «daemon off;»]
nginx.conf worker_processes 1; pid /tmp/nginx.pid; events < worker_connections 1024; >http < proxy_temp_path /tmp/proxy_temp; client_body_temp_path /tmp/client_temp; fastcgi_temp_path /tmp/fastcgi_temp; uwsgi_temp_path /tmp/uwsgi_temp; scgi_temp_path /tmp/scgi_temp; include /etc/nginx/mime.types; default_type application/octet-stream; log_format main ‘$remote_addr — $remote_user [$time_local] ‘ ‘$server_name to: $proxy_host [$upstream_addr] «$request» ‘ ‘$status $body_bytes_sent «$http_referer» ‘ ‘»$http_user_agent» «$http_x_forwarded_for»‘; access_log /var/log/nginx/access.log main; sendfile on; #tcp_nopush on; keepalive_timeout 65; #gzip on; include /etc/nginx/conf.d/*.conf; >
И выполним команды для сборки и развертывания:
Вывод
Используя Spring Вoot, React и Docker, можно быстро создать небольшую систему для контроля подписок и подписчиков на канале в Telegram. Исходный код двух приложений можно посмотреть здесь и здесь.
Следите за новыми постами по любимым темам
Подпишитесь на интересующие вас теги, чтобы следить за новыми постами и быть в курсе событий.
Источник: tproger.ru
Как добавить кнопку «предложить новость» в телеграмм канале
Телеграмм — это популярный мессенджер, который позволяет пользователям общаться в текстовом и голосовом режиме, а также обмениваться медиафайлами. Каналы в Телеграмме — это особые публичные страницы, где пользователи могут подписываться на получение новостей и обновлений от различных источников. Каналы часто используются компаниями, блогерами и СМИ для распространения информации. В этой статье мы расскажем о том, как добавить кнопку «предложить новость» в Телеграмм канале.
Добавление кнопки «предложить новость» в Телеграмм канале может быть полезным для пользователей, которые хотят поделиться своими идеями, новостями или материалами с администратором канала. Это также может помочь в создании взаимодействия между администратором канала и его подписчиками, что способствует росту активности и интереса канала.
Предложить новость — это функция, которая позволяет пользователям отправлять свои идеи или материалы владельцу канала. Обычно она реализуется через специальную кнопку или команду в описании канала. Когда пользователь нажимает на эту кнопку, открывается форма, где он может ввести текст сообщения и добавить прикрепленные файлы, если это необходимо.
Создание телеграмм канала
Создание телеграмм канала — это простой и эффективный способ делиться информацией с широкой аудиторией. Для создания канала вам потребуется аккаунт в телеграм и доступ к мобильному или веб-приложению.
В первую очередь, вы должны зарегистрироваться в телеграм и создать свой аккаунт. Затем, перейдите в настройки и выберите опцию «Создать канал». Введите название канала и описание, которые будут отображаться в шапке канала.
После создания канала, вам следует добавить имидж и оформление, чтобы привлечь внимание пользователей. Вы можете добавить изображение канала, а также заголовок и описание, чтобы обозначить тему и цель вашего канала.
После завершения настройки внешнего вида канала, вы можете начать публиковать сообщения и контент. Для этого вам достаточно нажать на кнопку «Сообщение», чтобы создать новый пост.
Если вы хотите, чтобы другие люди могли вносить вклад в ваш канал, вы можете добавить администраторов. Они смогут публиковать сообщения, редактировать настройки и управлять участниками канала. Для этого перейдите в настройки канала и выберите опцию «Добавить администратора».
Создание телеграмм канала предоставляет возможность делиться информацией с людьми со всего мира. Он является мощным инструментом для продвижения вашего бренда или идеи. Чтобы привлечь больше аудитории, регулярно публикуйте интересный и полезный контент, взаимодействуйте с подписчиками и отвечайте на их вопросы.
Настройка канала в режиме «для бизнеса»
Настройка телеграм канала в режиме «для бизнеса» является важным шагом для эффективной коммуникации с аудиторией и предоставления возможности предложить новость. Использование данного режима позволяет упростить процесс обратной связи и сотрудничества с пользователями.
Для начала настройки канала в режиме «для бизнеса» необходимо открыть раздел «Настройки» в административной панели канала. Там вы найдете различные опции для настройки канала и управления его функциональностью.
Одной из ключевых функций режима «для бизнеса» является добавление кнопки «предложить новость». Эта кнопка позволяет пользователям отправлять вам свои новости и идеи напрямую через телеграм канал. Для добавления этой кнопки необходимо перейти в раздел «Редактировать канал» в административной панели и выбрать опцию «Настройки добавления новостей».
В этом разделе вы сможете выбрать различные параметры для кнопки «предложить новость», такие как название кнопки, текст приглашения пользователя к отправке новостей и т.д. Также вы можете настроить уведомления о новых предложениях и выбрать, кому будут отправлены эти уведомления.
После настройки кнопки «предложить новость» она автоматически появится на вашем телеграм канале, и пользователи смогут отправлять вам свои новости и идеи. Вы сможете просмотреть и обработать эти предложения в административной панели канала и отвечать на них. Таким образом, настройка канала в режиме «для бизнеса» позволит вам упростить обратную связь с аудиторией и стимулировать сотрудничество с пользователями.
Создание бота для канала
Создание бота для канала в Telegram — это отличный способ анализировать и обрабатывать входящие сообщения, а также взаимодействовать с пользователями вашего канала. Для создания бота, вам потребуется зарегистрировать его в Telegram и получить API-ключ.
После регистрации бота в Telegram, вы можете начать разрабатывать его функционал. Для этого, вам понадобится язык программирования, поддерживающий работу с Telegram API, такой как Python. Можете использовать уже существующую библиотеку для работы с Telegram API, такую как python-telegram-bot.
Процесс создания бота для канала включает несколько шагов. Сначала, вы должны добавить вашего бота в ваш канал. Затем, вы должны настроить бота для получения и обработки сообщений из вашего канала. Вы можете настроить бота для автоматической публикации сообщений, отслеживания определенных ключевых слов или фильтрации контента.
Ваш бот может выполнять различные функции, в зависимости от ваших потребностей. Вы можете создать бота, который будет автоматически публиковать новости, анонсы или обновления на вашем канале. Бот также может отвечать на сообщения пользователей, предоставлять информацию, анализировать запросы и многое другое.
Создание бота для канала является мощным инструментом для повышения взаимодействия с пользователями и улучшения опыта использования вашего канала в Telegram. Необходимо только определить цели и задачи вашего бота, а затем приступить к его разработке, используя соответствующие инструменты и технологии.
Создание кнопки «предложить новость»
Добавление кнопки «предложить новость» в телеграмм канал позволяет подписчикам канала активно участвовать в формировании контента, добавлять новости и делиться своими идеями. Это создает более интерактивную и взаимодействующую атмосферу на канале, улучшает его вовлеченность и помогает привлечь новых подписчиков.
Для создания кнопки используется HTML-код, который можно вставить в описание или оформление канала. Сначала необходимо определить, где будет располагаться кнопка — например, под описанием канала или в боковой панели. Затем можно использовать тег для создания кнопки и указать ссылку для перехода на страницу с предложением новости.
Пример HTML-кода для создания кнопки:
Здесь «ссылка_на_страницу_с_предложением» заменяется на реальную ссылку, которая ведет на страницу, где пользователь может оставить свое предложение для новости. Класс «btn btn-primary» определяет стиль кнопки — он может быть заменен на любой другой класс, чтобы соответствовать общему стилю вашего канала.
После добавления кнопки пользователям будет легко предложить новость — им нужно всего лишь нажать на кнопку, чтобы перейти на страницу с формой предложения. Это позволит делать общение с подписчиками более активным и участвовать в формировании контента канала.
Важно помнить, что после добавления кнопки «предложить новость» необходимо создать механизм обработки предложенных новостей. Это может быть автоматическая обработка или проверка администратором канала перед публикацией. Таким образом, кнопка «предложить новость» станет не только удобным инструментом для подписчиков, но и средством для активного участия пользователей в формировании контента канала.
Добавление кнопки в описание канала
Один из способов добавить кнопку «предложить новость» в описание телеграмм канала — это использовать HTML разметку.
Прежде всего, нужно открыть раздел редактирования описания канала и найти место, где вы хотите разместить кнопку.
Затем, для создания кнопки, можно использовать тег с атрибутом href, указывающим ссылку на форму предложения новости. Например:
Этот тег создаст текстовую ссылку, которая будет отображаться в описании канала.
Если желательно добавить стиль кнопки, можно использовать CSS код внутри тега или создать класс кнопки внутри .
Примеры кода для стилизации кнопки:
После добавления разметки и стилей, нажмите кнопку «Сохранить», чтобы применить изменения. Теперь в описании канала должна отображаться кнопка «Предложить новость».
Учитывайте, что пользователи могут размещать только текстовые ссылки в описании канала. Не все клиенты Телеграмм поддерживают отображение кнопок.
Получение и обработка предложенных новостей
Предложенные новости от подписчиков канала могут стать отличным источником информации, который можно использовать для обновления контента и улучшения взаимодействия с аудиторией. Чтобы получать предложения от пользователей, в телеграмм канале можно создать кнопку «Предложить новость».
1. Добавление кнопки «Предложить новость»
Добавление кнопки «Предложить новость» в телеграмм канале можно выполнить с помощью бота-администратора. Для этого необходимо создать нового бота в Telegram и назначить его администратором канала.
2. Получение предложенных новостей
После того как кнопка «Предложить новость» добавлена в канал, подписчики смогут отправлять свои предложения. Предложенные новости будут появляться в специальном разделе «Предложенные» в админ-панели канала.
3. Обработка предложенных новостей
Полученные предложения можно обрабатывать различными способами. Например, можно регулярно проверять список предложенных новостей и выбирать самые интересные и актуальные для публикации. Также можно добавить возможность голосования за предложенные новости среди подписчиков канала и опубликовывать только те новости, которые набрали достаточное количество голосов.
4. Связь с подписчиками
Предложенные новости могут стать отличным способом взаимодействия с подписчиками и повышения их участия в жизни канала. Можно организовать конкурсы на лучшую предложенную новость, обсуждение и комментирование предложений подписчиков. Таким образом, канал станет не только источником информации, но и местом общения и обмена мнениями.
В результате, добавление кнопки «Предложить новость» и обработка предложенных новостей позволит каналу стать более интересным и активным для аудитории.
Источник: food-receptkphoto.ru