#include <Bot.hpp>

Inheritance diagram for tgbotxx::Bot:

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

	~Bot ()

void	start ()
	Start the long polling.

void	stop ()
	Stop the long polling.

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

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	onEditedMessage (const Ptr< Message > &editedMessage)
	Called when a new version of a message that is known to the bot and was edited.

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	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	onMyChatMember (const Ptr< ChatMemberUpdated > &myChatMemberUpdated)
	Called when the bot's chat member status was updated in a chat.

virtual void	onChatMember (const Ptr< ChatMemberUpdated > &chatMemberUpdated)
	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 > &chatBoostUpdated)
	Called when a chat boost was added or changed.

virtual void	onChatBoostRemoved (const Ptr< ChatBoostRemoved > &chatBoostRemoved)
	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 27 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()

tgbotxx::Bot::~Bot ( )

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 58 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 100 of file Bot.hpp.

◆ onChatBoostRemoved()

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

inlinevirtual

Called when a boost was removed from a chat.

Parameters

chatBoostRemoved ChatBoostRemoved object

Definition at line 142 of file Bot.hpp.

◆ onChatBoostUpdated()

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

inlinevirtual

Called when a chat boost was added or changed.

Parameters

chatBoostUpdated ChatBoostUpdated object

Definition at line 138 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 134 of file Bot.hpp.

◆ onChatMember()

virtual void tgbotxx::Bot::onChatMember ( const Ptr< ChatMemberUpdated > & chatMemberUpdated )

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

chatMemberUpdated ChatMemberUpdated object

Definition at line 129 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 96 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 66 of file Bot.hpp.

◆ onEditedMessage()

virtual void tgbotxx::Bot::onEditedMessage ( 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 75 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 91 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 147 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 87 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 81 of file Bot.hpp.

◆ onMyChatMember()

virtual void tgbotxx::Bot::onMyChatMember ( const Ptr< ChatMemberUpdated > & myChatMemberUpdated )

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

myChatMemberUpdated ChatMemberUpdated object

Definition at line 124 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 62 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 114 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 119 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 109 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 105 of file Bot.hpp.

◆ onStart()

virtual void tgbotxx::Bot::onStart ( )

inlinevirtual

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

Bot Callbacks

Definition at line 50 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 54 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 71 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()

◆ onCallbackQuery()

◆ onChatBoostRemoved()

◆ onChatBoostUpdated()

◆ onChatJoinRequest()

◆ onChatMember()

◆ onChosenInlineResult()

◆ onCommand()

◆ onEditedMessage()

◆ onInlineQuery()

◆ onLongPollError()

◆ onMessageReactionCountUpdated()

◆ onMessageReactionUpdated()

◆ onMyChatMember()

◆ onNonCommandMessage()

◆ onPoll()

◆ onPollAnswer()

◆ onPreCheckoutQuery()

◆ onShippingQuery()

◆ onStart()

◆ onStop()

◆ onUnknownCommand()

◆ start()

◆ stop()