#include <Bot.hpp>

Inheritance diagram for tgbotxx::Bot:

Public Member Functions
	Bot (const std::string &token)
	Constructs a new Bot object.

virtual	~Bot ()

void	start ()
	Start the long polling.

void	stop ()
	Stop the long polling.

virtual void	onStart ()
	Bot Callbacks.

virtual void	onStop ()
	Called when Bot is about to be stopped (triggered by Bot::stop()) Cleanup your code in this callback (close handles, backup data...)

virtual void	onAnyMessage (const Ptr< Message > &message)
	Called when a new message is received of any kind - text, photo, sticker, etc.

virtual void	onNonCommandMessage (const Ptr< Message > &message)
	Called when a non-command message is received of any kind - text, photo, sticker, etc.

virtual void	onCommand (const Ptr< Message > &command)
	Called when a new command is received (messages with leading '/' char).

virtual void	onUnknownCommand (const Ptr< Message > &message)
	Called when an unknown command is received (messages with leading '/' char).

virtual void	onMessageEdited (const Ptr< Message > &editedMessage)
	Called when a new version of a message that is known to the bot and was edited.

virtual void	onChannelPost (const Ptr< Message > &channelPost)
	Called when a new incoming channel post of any kind (text, photo, sticker, etc.) is received.

virtual void	onChannelPostEdited (const Ptr< Message > &editedChannelPost)
	Called when a new version of a channel post that is known to the bot and was edited.

virtual void	onBusinessConnection (const Ptr< BusinessConnection > &businessConnection)
	Called when the bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot.

virtual void	onBusinessMessage (const Ptr< Message > &businessMessage)
	Called when a new message from a connected business account is received.

virtual void	onBusinessMessageEdited (const Ptr< Message > &editedBusinessMessage)
	Called when a new version of a message from a connected business account is received.

virtual void	onBusinessMessagesDeleted (const Ptr< BusinessMessagesDeleted > &deletedBusinessMessages)
	Called when Messages were deleted from a connected business account.

virtual void	onMessageReactionUpdated (const Ptr< MessageReactionUpdated > &messageReaction)
	Called when a reaction to a message was changed by a user.

virtual void	onMessageReactionCountUpdated (const Ptr< MessageReactionCountUpdated > &messageReactionCount)
	Called when reactions to a message with anonymous reactions were changed.

virtual void	onInlineQuery (const Ptr< InlineQuery > &inlineQuery)
	Called when a new incoming inline query is received.

virtual void	onChosenInlineResult (const Ptr< ChosenInlineResult > &chosenInlineResult)
	Called when the result of an inline query that was chosen by a user and sent to their chat partner.

virtual void	onCallbackQuery (const Ptr< CallbackQuery > &callbackQuery)
	Called when a new incoming callback query is received.

virtual void	onShippingQuery (const Ptr< ShippingQuery > &shippingQuery)
	Called when a new incoming shipping query is received.

virtual void	onPreCheckoutQuery (const Ptr< PreCheckoutQuery > &preCheckoutQuery)
	Called when a new incoming pre-checkout query is received. Contains full information about checkout.

virtual void	onPaidMediaPurchased (const Ptr< PaidMediaPurchased > &purchasedPaidMedia)
	Called when a user purchased paid media with a non-empty payload sent by the bot in a non-channel chat.

virtual void	onPoll (const Ptr< Poll > &poll)
	Called when a new poll state is received.

virtual void	onPollAnswer (const Ptr< PollAnswer > &pollAnswer)
	Called when a user changed their answer in a non-anonymous poll.

virtual void	onMyChatMemberUpdated (const Ptr< ChatMemberUpdated > &myChatMember)
	Called when the bot's chat member status was updated in a chat.

virtual void	onChatMemberUpdated (const Ptr< ChatMemberUpdated > &chatMember)
	Called when a chat member's status was updated in a chat.

virtual void	onChatJoinRequest (const Ptr< ChatJoinRequest > &chatJoinRequest)
	Called when a request to join the chat has been sent.

virtual void	onChatBoostUpdated (const Ptr< ChatBoostUpdated > &chatBoost)
	Called when a chat boost was added or changed.

virtual void	onChatBoostRemoved (const Ptr< ChatBoostRemoved > &removedChatBoost)
	Called when a boost was removed from a chat.

virtual void	onLongPollError (const std::string &errorMessage, ErrorCode errorCode)
	Called when the long polling getUpdates fails.

Protected Member Functions
const Ptr< Api > &	getApi () const noexcept
	Returns Api object.

const Ptr< Api > &	api () const noexcept
	Returns Api object.

bool	isRunning () const noexcept
	Returns true if the Bot long polling is currently running.

Detailed Description

Definition at line 30 of file Bot.hpp.

Constructor & Destructor Documentation

◆ Bot()

tgbotxx::Bot::Bot ( const std::string & token )

explicit

Constructs a new Bot object.

Parameters

token Bot token from the BotFather

◆ ~Bot()

virtual tgbotxx::Bot::~Bot ( )

virtual

Member Function Documentation

◆ api()

const Ptr< Api > & tgbotxx::Bot::api ( ) const

protectednoexcept

Returns Api object.

◆ getApi()

const Ptr< Api > & tgbotxx::Bot::getApi ( ) const

protectednoexcept

Returns Api object.

Getters

◆ isRunning()

bool tgbotxx::Bot::isRunning ( ) const

protectednoexcept

Returns true if the Bot long polling is currently running.

◆ onAnyMessage()

virtual void tgbotxx::Bot::onAnyMessage ( const Ptr< Message > & message )

inlinevirtual

Called when a new message is received of any kind - text, photo, sticker, etc.

Parameters

message Received message object

Definition at line 64 of file Bot.hpp.

◆ onBusinessConnection()

virtual void tgbotxx::Bot::onBusinessConnection ( const Ptr< BusinessConnection > & businessConnection )

inlinevirtual

Called when the bot was connected to or disconnected from a business account, or a user edited an existing connection with the bot.

Parameters

businessConnection BusinessConnection object

Definition at line 98 of file Bot.hpp.

◆ onBusinessMessage()

virtual void tgbotxx::Bot::onBusinessMessage ( const Ptr< Message > & businessMessage )

inlinevirtual

Called when a new message from a connected business account is received.

Parameters

businessMessage Message object

Definition at line 102 of file Bot.hpp.

◆ onBusinessMessageEdited()

virtual void tgbotxx::Bot::onBusinessMessageEdited ( const Ptr< Message > & editedBusinessMessage )

inlinevirtual

Called when a new version of a message from a connected business account is received.

Parameters

editedBusinessMessage Message object

Definition at line 106 of file Bot.hpp.

◆ onBusinessMessagesDeleted()

virtual void tgbotxx::Bot::onBusinessMessagesDeleted ( const Ptr< BusinessMessagesDeleted > & deletedBusinessMessages )

inlinevirtual

Called when Messages were deleted from a connected business account.

Parameters

deletedBusinessMessages BusinessMessagesDeleted object

Definition at line 110 of file Bot.hpp.

◆ onCallbackQuery()

virtual void tgbotxx::Bot::onCallbackQuery ( const Ptr< CallbackQuery > & callbackQuery )

inlinevirtual

Called when a new incoming callback query is received.

Parameters

callbackQuery CallbackQuery object

Definition at line 139 of file Bot.hpp.

◆ onChannelPost()

virtual void tgbotxx::Bot::onChannelPost ( const Ptr< Message > & channelPost )

inlinevirtual

Called when a new incoming channel post of any kind (text, photo, sticker, etc.) is received.

Parameters

channelPost Message object

Definition at line 87 of file Bot.hpp.

◆ onChannelPostEdited()

virtual void tgbotxx::Bot::onChannelPostEdited ( const Ptr< Message > & editedChannelPost )

inlinevirtual

Called when a new version of a channel post that is known to the bot and was edited.

Parameters

editedChannelPost Message object

Definition at line 91 of file Bot.hpp.

◆ onChatBoostRemoved()

virtual void tgbotxx::Bot::onChatBoostRemoved ( const Ptr< ChatBoostRemoved > & removedChatBoost )

inlinevirtual

Called when a boost was removed from a chat.

Parameters

removedChatBoost ChatBoostRemoved object

Definition at line 191 of file Bot.hpp.

◆ onChatBoostUpdated()

virtual void tgbotxx::Bot::onChatBoostUpdated ( const Ptr< ChatBoostUpdated > & chatBoost )

inlinevirtual

Called when a chat boost was added or changed.

Parameters

chatBoost ChatBoostUpdated object

Definition at line 187 of file Bot.hpp.

◆ onChatJoinRequest()

virtual void tgbotxx::Bot::onChatJoinRequest ( const Ptr< ChatJoinRequest > & chatJoinRequest )

inlinevirtual

Called when a request to join the chat has been sent.

Note: The bot must have the can_invite_users administrator right in the chat to receive these updates.

Parameters

chatJoinRequest ChatJoinRequest object

Definition at line 183 of file Bot.hpp.

◆ onChatMemberUpdated()

virtual void tgbotxx::Bot::onChatMemberUpdated ( const Ptr< ChatMemberUpdated > & chatMember )

inlinevirtual

Called when a chat member's status was updated in a chat.

Note: The bot must be an administrator in the chat and must explicitly specify “chat_member” in the list of allowed_updates to receive these updates.

Parameters

chatMember ChatMemberUpdated object

Definition at line 178 of file Bot.hpp.

◆ onChosenInlineResult()

virtual void tgbotxx::Bot::onChosenInlineResult ( const Ptr< ChosenInlineResult > & chosenInlineResult )

inlinevirtual

Called when the result of an inline query that was chosen by a user and sent to their chat partner.

Note: Please see our documentation on the feedback collecting for details on how to enable these updates for your bot. https://core.telegram.org/bots/inline#collecting-feedback

Parameters

chosenInlineResult ChosenInlineResult object

Definition at line 135 of file Bot.hpp.

◆ onCommand()

virtual void tgbotxx::Bot::onCommand ( const Ptr< Message > & command )

inlinevirtual

Called when a new command is received (messages with leading '/' char).

Parameters

command Received command object

Definition at line 72 of file Bot.hpp.

◆ onInlineQuery()

virtual void tgbotxx::Bot::onInlineQuery ( const Ptr< InlineQuery > & inlineQuery )

inlinevirtual

Called when a new incoming inline query is received.

Parameters

inlineQuery InlineQuery object

Definition at line 130 of file Bot.hpp.

◆ onLongPollError()

virtual void tgbotxx::Bot::onLongPollError	(	const std::string &	errorMessage,
		ErrorCode	errorCode
	)

inlinevirtual

Called when the long polling getUpdates fails.

Parameters

errorMessage	the reason of failure
errorCode	ErrorCode enum from Telegram Api

Definition at line 198 of file Bot.hpp.

◆ onMessageEdited()

virtual void tgbotxx::Bot::onMessageEdited ( const Ptr< Message > & editedMessage )

inlinevirtual

Called when a new version of a message that is known to the bot and was edited.

Parameters

editedMessage Edited Message object

Definition at line 81 of file Bot.hpp.

◆ onMessageReactionCountUpdated()

virtual void tgbotxx::Bot::onMessageReactionCountUpdated ( const Ptr< MessageReactionCountUpdated > & messageReactionCount )

inlinevirtual

Called when reactions to a message with anonymous reactions were changed.

Note: The bot must be an administrator in the chat and must explicitly specify "message_reaction_count" in the list of allowed_updates to receive these updates using Api::setAllowedUpdates(). The updates are grouped and can be sent with delay up to a few minutes.

Parameters

messageReactionCount MessageReactionCountUpdated object

Definition at line 124 of file Bot.hpp.

◆ onMessageReactionUpdated()

virtual void tgbotxx::Bot::onMessageReactionUpdated ( const Ptr< MessageReactionUpdated > & messageReaction )

inlinevirtual

Called when a reaction to a message was changed by a user.

Note: The bot must be an administrator in the chat and must explicitly specify "message_reaction" in the list of allowed_updates to receive these updates using Api::setAllowedUpdates(). The update isn't received for reactions set by bots.

Parameters

messageReaction MessageReactionUpdated object

Definition at line 118 of file Bot.hpp.

◆ onMyChatMemberUpdated()

virtual void tgbotxx::Bot::onMyChatMemberUpdated ( const Ptr< ChatMemberUpdated > & myChatMember )

inlinevirtual

Called when the bot's chat member status was updated in a chat.

Note: For private chats, this update is received only when the bot is blocked or unblocked by the user.

Parameters

myChatMember ChatMemberUpdated object

Definition at line 173 of file Bot.hpp.

◆ onNonCommandMessage()

virtual void tgbotxx::Bot::onNonCommandMessage ( const Ptr< Message > & message )

inlinevirtual

Called when a non-command message is received of any kind - text, photo, sticker, etc.

Parameters

message Received non-command message object

Definition at line 68 of file Bot.hpp.

◆ onPaidMediaPurchased()

virtual void tgbotxx::Bot::onPaidMediaPurchased ( const Ptr< PaidMediaPurchased > & purchasedPaidMedia )

inlinevirtual

Called when a user purchased paid media with a non-empty payload sent by the bot in a non-channel chat.

Parameters

purchasedPaidMedia PaidMediaPurchased object

Definition at line 154 of file Bot.hpp.

◆ onPoll()

virtual void tgbotxx::Bot::onPoll ( const Ptr< Poll > & poll )

inlinevirtual

Called when a new poll state is received.

Note: Bots receive only updates about stopped polls and polls, which are sent by the bot

Parameters

poll	Poll object

Definition at line 161 of file Bot.hpp.

◆ onPollAnswer()

virtual void tgbotxx::Bot::onPollAnswer ( const Ptr< PollAnswer > & pollAnswer )

inlinevirtual

Called when a user changed their answer in a non-anonymous poll.

Note: Bots receive new votes only in polls that were sent by the bot itself.

Parameters

pollAnswer PollAnswer object

Definition at line 166 of file Bot.hpp.

◆ onPreCheckoutQuery()

virtual void tgbotxx::Bot::onPreCheckoutQuery ( const Ptr< PreCheckoutQuery > & preCheckoutQuery )

inlinevirtual

Called when a new incoming pre-checkout query is received. Contains full information about checkout.

Parameters

preCheckoutQuery PreCheckoutQuery object

Definition at line 148 of file Bot.hpp.

◆ onShippingQuery()

virtual void tgbotxx::Bot::onShippingQuery ( const Ptr< ShippingQuery > & shippingQuery )

inlinevirtual

Called when a new incoming shipping query is received.

Note: Only for invoices with flexible price

Parameters

shippingQuery ShippingQuery object

Definition at line 144 of file Bot.hpp.

◆ onStart()

virtual void tgbotxx::Bot::onStart ( )

inlinevirtual

Bot Callbacks.

Called before Bot starts receiving updates (triggered by Bot::start()) Use this callback to initialize your code, set commands..

Definition at line 54 of file Bot.hpp.

◆ onStop()

virtual void tgbotxx::Bot::onStop ( )

inlinevirtual

Called when Bot is about to be stopped (triggered by Bot::stop()) Cleanup your code in this callback (close handles, backup data...)

Definition at line 58 of file Bot.hpp.

◆ onUnknownCommand()

virtual void tgbotxx::Bot::onUnknownCommand ( const Ptr< Message > & message )

inlinevirtual

Called when an unknown command is received (messages with leading '/' char).

Parameters

message Received unknown command object

Note: Known commands are set with Bot::setCommands()

Definition at line 77 of file Bot.hpp.

◆ start()

void tgbotxx::Bot::start ( )

Start the long polling.

Exceptions

Exception on failure

◆ stop()

void tgbotxx::Bot::stop ( )

Stop the long polling.

The documentation for this class was generated from the following file:

include/tgbotxx/Bot.hpp

Public Member Functions

Protected Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ Bot()

◆ ~Bot()

Member Function Documentation

◆ api()

◆ getApi()

◆ isRunning()

◆ onAnyMessage()

◆ onBusinessConnection()

◆ onBusinessMessage()

◆ onBusinessMessageEdited()

◆ onBusinessMessagesDeleted()

◆ onCallbackQuery()

◆ onChannelPost()

◆ onChannelPostEdited()

◆ onChatBoostRemoved()

◆ onChatBoostUpdated()

◆ onChatJoinRequest()

◆ onChatMemberUpdated()

◆ onChosenInlineResult()

◆ onCommand()

◆ onInlineQuery()

◆ onLongPollError()

◆ onMessageEdited()

◆ onMessageReactionCountUpdated()

◆ onMessageReactionUpdated()

◆ onMyChatMemberUpdated()

◆ onNonCommandMessage()

◆ onPaidMediaPurchased()

◆ onPoll()

◆ onPollAnswer()

◆ onPreCheckoutQuery()

◆ onShippingQuery()

◆ onStart()

◆ onStop()

◆ onUnknownCommand()

◆ start()

◆ stop()