mailing-telegram-bot

Описание

Телеграмм-бот, который рассылает сообщение всем зарегистрированным пользователям.

Используемые библиотеки и зависимости

Компилятор - g++ или clang++
Система сборки - Make
Telegram Bot API - tgbot-cpp (MIT LICENSE)
Fast C++ logging library - spdlog (MIT LICENSE)

Инструкция для чайников

Создать бота у Bot Father:
1. Запустите бота (Bot Father)
2. Напишите в чате с Bot Father команду /newbot
3. Напишите имя своего бота (название должно быть на английском и конец названия должен содержать bot)
4. Если всё получилось, то Bot Father должен предоставить вам токен (на картинке выделено красным) для того, чтобы управлять ботом
Получить ID админа, для того, чтобы рассылать сообщение централизованно:
1. Написать этому боту
2. В поле ID - ваш ID

Как собрать и запустить проект

Клонировать проект:

git clone https://github.com/tstuteam/mailing-telegram-bot.git

Установить зависимости.

Запустить терминал и написать следующее:

make all
touch users.db
TELEGRAM_BOT_TOKEN=<токен бота> TELEGRAM_BOT_ADMIN_ID=<user id админа> ./bot users.db

Алгоритм работы

На команду /start
1. Бот начинает беседу с пользователем
На команду /register
1. Регистрировать пользователя в системе
2. Если пользователь это админ, тогда игнорировать
На команду /unregister
1. Удалить зарегистрированного пользователя из системы
2. Если пользователь это админ, тогда игнорировать
3. Если пользователь не был зарегистрирован, тогда игнорировать
На любое сообщение от пользователя бот повторяет сообщение пользователя
На любое сообщение от админа бот рассылает всем зарегистрированным пользователям это сообщение
На любые картинки от пользователя бот сохраняет картинки

Как бот на C++ общается с API Telegram

Чтобы общаться с сервером Telegram бот-клиент должен посылать http запросы по адресу https://api.telegram.org. Библиотека tgbot-cpp облегчает работу программисту, так как она может парсить, хранить ответы сервера Telegram в удобном виде.

Если более подробно, то при каждом обращении к API Telegram бот формирует запрос с необходимым действием. Например, чтобы отправить сообщение пользователю бот построит примерно такой запрос: https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/sendMessage?chat_id=123124&text=Hello_World. При успешном выполнении запроса Telegram API отправит в ответ JSON, в котором будет сформирован объект Message.

Репозиторий tgbot-cpp имеет много примеров кода использования библиотеки, что облегчает знакомство с библиотекой.

tstuteam / mailing-telegram-bot