telebotxx

Telegram Bot API 2.0 for C++17. It uses C++ Requests library to perform HTTP requests and RapidJSON to work with JSON data. In development, so you are welcome to contribute.

Requirements

C++17-compatible compiler
CMake 3.15 or newer

Integration

CMake (recommended)

Assuming you have your third-party dependencies in external directory relative to project's root. You can add telebotxx to your Git repository as submodule.

git submodule add https://github.com/UltraCoderRU/telebotxx.git external/telebotxx
git submodule update --init --recursive

Then integrate telebotxx into your CMake project as subdirectory and link with telebotxx target.

# You can configure available options by setting cached variables before add_subdirectory()
# set(TELEBOTXX_USE_LIBCXX ON CACHE INTERNAL "")
add_subdirectory(external/telebotxx)

add_executable(myapp ...)
target_link_libraries(myapp telebotxx)

Separate building

Of course, you can build and install library separately.

git clone https://github.com/UltraCoderRU/telebotxx.git
cd telebotxx
mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local ..
cmake --build .
sudo cmake --build . --target install

Usage

Sending text message

Here is a simple example of how to send text message:

#include <telebotxx/BotApi.hpp>

std::string token = "YOUR:BOT:TOKEN";
int main()
{
  using namespace telebotxx;
  BotApi bot(token);
  Message answer = bot.sendMessage(ChatId{"@chat_name"},
                                   Text{"Hello, world!"}
                                  );
  return 0;
}

Member function BotApi::sendMessage() returns information about sent message on success or throws an exception.

You can pass additional options in any combination and order:

int messageId = ...; // ID of the original message to reply
Message answer = bot.sendMessage(ChatId{"@chat_name"},
                                 Text{"Hello, world!"},
                                 ReplyTo{messageId},
                                 ParseMode::Markdown,
                                 DisableNotification(),
                                 DisableWebPagePreview()
                                );

Note, that ChatId argument can be specified with its name or id:

ChatId{"@chat_name"}
ChatId{123456}

Sending images

To send a photo use any of the folowing variants depending of image source:

// for local file
Message answer = bot.sendPhoto(ChatId{"@chat_name"}, Photo{File{"photo.jpg"}});

// for in-memory image stored in std::vector
std::vector<char> photo = ...;
Message answer = bot.sendPhoto(ChatId{"@chat_name"},
                               Photo{Buffer{photo, "photo.jpg"}}
                              );

// for in-memory image stored in C-array
Message answer = bot.sendPhoto(ChatId{"@chat_name"},
                               Photo{Buffer{photo.data(), photo.size(), "photo.jpg"}}
                              );

// for image available by URL
Message answer = bot.sendPhoto(ChatId{"@chat_name"},
                               Photo{Url{"http://sample.com/sample.jpg"}}
                              );

// for already uploaded photo you can send it by id
Message answer = bot.sendPhoto(ChatId{"@chat_name"}, Photo{123456});

As in the case of messages, you can pass additional options:

Message answer = bot.sendPhoto(ChatId{"@chat_name"},
                               Photo{File{"photo.jpg"}}
                               Caption{"Sample photo"},
                               ReplyTo(messageId),
                               DisableNotification()
                              );

3.8 KiB Raw Permalink Blame History