Skip to content

Repository files navigation

tgbot-cpp

Build StatusDocker Hub pullsOpen documentationDonate using PayPal


GitHub contributors 🚀🚀🚀 thanks for the contributing!


C++ library for Telegram bot API.

Documentation is located here.

State

  • Bot API 3.0 ~ 3.6
  • Bot API 4.0 (Implemented all APIs except 'Telegram Passport')

Sample

Simple echo bot which sends everything it receives:

#include<stdio.h>
#include<tgbot/tgbot.h>intmain() {
TgBot::Bot bot("PLACE YOUR TOKEN HERE");
bot.getEvents().onCommand("start", [&bot](TgBot::Message::Ptr message) {
bot.getApi().sendMessage(message->chat->id, "Hi!");
});
bot.getEvents().onAnyMessage([&bot](TgBot::Message::Ptr message) {
printf("User wrote %s\n", message->text.c_str());
if (StringTools::startsWith(message->text, "/start")) {
return;
}
bot.getApi().sendMessage(message->chat->id, "Your message is: " + message->text);
});
try {
printf("Bot username: %s\n", bot.getApi().getMe()->username.c_str());
TgBot::TgLongPoll longPoll(bot);
while (true) {
printf("Long poll started\n");
longPoll.start();
}
} catch (TgBot::TgException& e) {
printf("error: %s\n", e.what());
}
return0;
}

All other samples are located here.

Library compilation

Firstly you need to install some dependencies such as Boost and build tools such as CMake. On Debian-based distibutives you can do it with these commands:

sudo apt-get install g++ make binutils cmake libssl-dev libboost-system-dev

If you want to use curl-based http client CurlHttpClient, you also need to install libcurl4-openssl-dev package.

To compile the library execute this commands:

cd /path/where/you/have/cloned/the/library/repository
cmake .
make -j4
sudo make install

Specific library installation notes

Docker

You can use Docker to build and run your bot. Set the base image of your's Dockerfile to reo7sp/tgbot-cpp.

Arch Linux

A PKGBUILD compiles shared library with header files is hosted on Arch Linux User Repository.

Bot compilation

With CMake

Example CMakeLists.txt

Without CMake

g++ telegram_bot.cpp -o telegram_bot --std=c++11 -I/usr/local/include -lTgBot -lboost_system -lssl -lcrypto -lpthread

Options available when compiling bot

With CMake

add_definitions(-DTGBOT_DISABLE_NAGLES_ALGORITHM) # Disable 'Nagle's algorithm'
add_definitions(-DTGBOT_CHANGE_SOCKET_BUFFER_SIZE) # Socket Buffer Size Expansion
add_definitions(-DTGBOT_CHANGE_READ_BUFFER_SIZE) # Read Buffer Size Expansion

Without CMake

-DTGBOT_DISABLE_NAGLES_ALGORITHM
-DTGBOT_CHANGE_SOCKET_BUFFER_SIZE
-DTGBOT_CHANGE_READ_BUFFER_SIZE

Feedback

Feel free to create new issues on GitHub or contact me on Telegram.

Licence

The MIT License.

About

C++ library for Telegram bot API

Resources

Stars

0 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages