tgbotxx 1.2.9.2
Telegram Bot C++ Library
Loading...
Searching...
No Matches
Api.hpp
Go to the documentation of this file.
1#pragma once
2#include <cpr/cpr.h>
3#include <functional>
4#include <nlohmann/json.hpp>
5#include <optional>
6#include <string>
7#include <tgbotxx/utils/Ptr.hpp>
8#include <variant>
9namespace nl = nlohmann;
10
11namespace tgbotxx {
13 struct User;
14 struct Message;
15 struct Update;
16 struct Chat;
17 struct MessageEntity;
18 struct IReplyMarkup;
19 struct MessageId;
20 struct InputMedia;
21 struct UserProfilePhotos;
22 struct File;
23 struct ChatMember;
24 struct ChatPermissions;
25 struct ChatInviteLink;
26 struct Sticker;
27 struct ForumTopic;
28 struct BotCommand;
29 struct BotCommandScope;
30 struct BotName;
31 struct BotShortDescription;
32 struct BotDescription;
33 struct InlineQueryResult;
34 struct InlineQueryResultsButton;
35 struct MenuButton;
36 struct ChatAdministratorRights;
37 struct WebhookInfo;
38 struct Poll;
39 struct InputPollOption;
40 struct LabeledPrice;
41 struct ShippingOption;
42 struct SentWebAppMessage;
43 struct ReplyParameters;
44 struct StickerSet;
45 struct InputSticker;
46 struct MaskPosition;
47 struct PassportElementError;
48 struct GameHighScore;
49 struct ReactionType;
50 struct LinkPreviewOptions;
51 struct SuggestedPostParameters;
52 struct InputChecklist;
53 struct UserChatBoosts;
54 struct Gifts;
55 struct InputProfilePhoto;
56 struct AcceptedGiftTypes;
57 struct StarAmount;
58 struct OwnedGifts;
59 struct InputStoryContent;
60 struct Story;
61 struct StoryArea;
62 struct StarTransactions;
63 struct InputPaidMedia;
64
75 class Api {
76 friend class Bot;
77
78 static const std::string DEFAULT_API_URL;
79 static const cpr::ConnectTimeout DEFAULT_CONNECT_TIMEOUT;
80 static const cpr::Timeout DEFAULT_TIMEOUT;
81 static const cpr::Timeout DEFAULT_LONG_POLL_TIMEOUT;
82 static const cpr::Timeout DEFAULT_UPLOAD_FILES_TIMEOUT;
83 static const cpr::Timeout DEFAULT_DOWNLOAD_FILES_TIMEOUT;
84
85 const std::string m_token;
86 std::string m_apiUrl = DEFAULT_API_URL;
87 cpr::ConnectTimeout m_connectTimeout = DEFAULT_CONNECT_TIMEOUT;
88 cpr::Timeout m_timeout = DEFAULT_TIMEOUT;
89 cpr::Timeout m_longPollTimeout = DEFAULT_LONG_POLL_TIMEOUT;
90 std::int32_t m_updatesLimit = 100;
91 cpr::Timeout m_uploadFilesTimeout = DEFAULT_UPLOAD_FILES_TIMEOUT;
92 cpr::Timeout m_downloadFilesTimeout = DEFAULT_DOWNLOAD_FILES_TIMEOUT;
93 cpr::Proxies m_proxies = cpr::Proxies();
94 std::vector<std::string> m_allowedUpdates;
99 struct Cache {
100 explicit Cache(const Api& pApi) noexcept;
101
102 std::span<std::string> getBotCommands() const;
103 std::string_view getBotUsername() const;
104
105 const Api& api;
106 mutable std::string botUsername;
107 mutable std::vector<std::string> botCommands;
108 };
109 Cache m_cache;
110
111 public:
114 explicit Api(const std::string& token);
115
116 public:
120 Ptr<User> getMe() const;
121
128 bool logOut() const;
129
136 bool close() const;
137
160 Ptr<Message> sendMessage(const std::variant<std::int64_t, std::string>& chatId,
161 const std::string& text,
162 std::int32_t messageThreadId = 0,
163 const std::string& parseMode = "",
164 const std::vector<Ptr<MessageEntity>>& entities = std::vector<Ptr<MessageEntity>>(),
165 bool disableNotification = false,
166 bool protectContent = false,
167 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
168 const std::string& businessConnectionId = "",
169 std::int32_t directMessagesTopicId = 0,
170 const Ptr<LinkPreviewOptions>& linkPreviewOptions = nullptr,
171 bool allowPaidBroadcast = false,
172 const std::string& messageEffectId = "",
173 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
174 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
175
191 Ptr<Message> forwardMessage(const std::variant<std::int64_t, std::string>& chatId,
192 const std::variant<std::int64_t, std::string>& fromChatId,
193 std::int32_t messageId,
194 std::int32_t messageThreadId = 0,
195 bool disableNotification = false,
196 bool protectContent = false,
197 std::int32_t directMessagesTopicId = 0,
198 std::time_t videoStartTimestamp = 0,
199 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr) const;
200
201
218 std::vector<Ptr<MessageId>> forwardMessages(const std::variant<std::int64_t, std::string>& chatId,
219 const std::variant<std::int64_t, std::string>& fromChatId,
220 const std::vector<std::int32_t>& messageIds,
221 std::int32_t messageThreadId = 0,
222 bool disableNotification = false,
223 bool protectContent = false,
224 std::int32_t directMessagesTopicId = 0) const;
225
226
251 Ptr<MessageId> copyMessage(const std::variant<std::int64_t, std::string>& chatId,
252 const std::variant<std::int64_t, std::string>& fromChatId,
253 std::int32_t messageId,
254 std::int32_t messageThreadId = 0,
255 const std::string& caption = "",
256 const std::string& parseMode = "",
257 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
258 bool disableNotification = false,
259 bool protectContent = false,
260 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
261 std::int32_t directMessagesTopicId = 0,
262 std::time_t videoStartTimestamp = 0,
263 bool showCaptionAboveMedia = false,
264 bool allowPaidBroadcast = false,
265 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
266 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
267
287 std::vector<Ptr<MessageId>> copyMessages(const std::variant<std::int64_t, std::string>& chatId,
288 const std::variant<std::int64_t, std::string>& fromChatId,
289 const std::vector<std::int32_t>& messageIds,
290 std::int32_t messageThreadId = 0,
291 std::int32_t directMessagesTopicId = 0,
292 bool disableNotification = false,
293 bool protectContent = false,
294 bool removeCaption = false) const;
295
323 Ptr<Message> sendPhoto(const std::variant<std::int64_t, std::string>& chatId,
324 const std::variant<cpr::File, std::string>& photo,
325 std::int32_t messageThreadId = 0,
326 const std::string& caption = "",
327 const std::string& parseMode = "",
328 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
329 bool disableNotification = false,
330 bool protectContent = false,
331 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
332 const std::string& businessConnectionId = "",
333 std::int32_t directMessagesTopicId = 0,
334 bool showCaptionAboveMedia = false,
335 bool hasSpoiler = false,
336 bool allowPaidBroadcast = false,
337 const std::string& messageEffectId = "",
338 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
339 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
340
376 Ptr<Message> sendAudio(const std::variant<std::int64_t, std::string>& chatId,
377 const std::variant<cpr::File, std::string>& audio,
378 std::int32_t messageThreadId = 0,
379 const std::string& caption = "",
380 const std::string& parseMode = "",
381 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
382 std::time_t duration = 0,
383 const std::string& performer = "",
384 const std::string& title = "",
385 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{},
386 bool disableNotification = false,
387 bool protectContent = false,
388 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
389 const std::string& businessConnectionId = "",
390 std::int32_t directMessagesTopicId = 0,
391 bool allowPaidBroadcast = false,
392 const std::string& messageEffectId = "",
393 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
394 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
395
396
426 Ptr<Message> sendDocument(const std::variant<std::int64_t, std::string>& chatId,
427 const std::variant<cpr::File, std::string>& document,
428 std::int32_t messageThreadId = 0,
429 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{},
430 const std::string& caption = "",
431 const std::string& parseMode = "",
432 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
433 bool disableNotification = false,
434 bool protectContent = false,
435 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
436 const std::string& businessConnectionId = "",
437 std::int32_t directMessagesTopicId = 0,
438 bool disableContentTypeDetection = false,
439 bool allowPaidBroadcast = false,
440 const std::string& messageEffectId = "",
441 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
442 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
443
444
482 Ptr<Message> sendVideo(const std::variant<std::int64_t, std::string>& chatId,
483 const std::variant<cpr::File, std::string>& video,
484 std::int32_t messageThreadId = 0,
485 std::time_t duration = 0,
486 std::int32_t width = 0,
487 std::int32_t height = 0,
488 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{},
489 const std::variant<std::monostate, cpr::File, std::string>& cover = std::monostate{},
490 std::time_t startTimestamp = 0,
491 const std::string& caption = "",
492 const std::string& parseMode = "",
493 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
494 bool showCaptionAboveMedia = false,
495 bool hasSpoiler = false,
496 bool supportsStreaming = false,
497 bool disableNotification = false,
498 bool protectContent = false,
499 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
500 const std::string& businessConnectionId = "",
501 std::int32_t directMessagesTopicId = 0,
502 bool allowPaidBroadcast = false,
503 const std::string& messageEffectId = "",
504 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
505 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
506
507
538 Ptr<Message> sendAnimation(const std::variant<std::int64_t, std::string>& chatId,
539 const std::variant<cpr::File, std::string>& animation,
540 std::int32_t messageThreadId = 0,
541 std::time_t duration = 0,
542 std::int32_t width = 0,
543 std::int32_t height = 0,
544 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{},
545 const std::string& caption = "",
546 const std::string& parseMode = "",
547 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
548 bool disableNotification = false,
549 bool protectContent = false,
550 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
551 const std::string& businessConnectionId = "",
552 std::int32_t directMessagesTopicId = 0,
553 bool allowPaidBroadcast = false,
554 const std::string& messageEffectId = "",
555 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
556 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
557
558
582 Ptr<Message> sendVoice(const std::variant<std::int64_t, std::string>& chatId,
583 const std::variant<cpr::File, std::string>& voice,
584 std::int32_t messageThreadId = 0,
585 const std::string& caption = "",
586 const std::string& parseMode = "",
587 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
588 std::time_t duration = 0,
589 bool disableNotification = false,
590 bool protectContent = false,
591 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
592 const std::string& businessConnectionId = "",
593 std::int32_t directMessagesTopicId = 0,
594 bool allowPaidBroadcast = false,
595 const std::string& messageEffectId = "",
596 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
597 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
598
599
627 Ptr<Message> sendVideoNote(const std::variant<std::int64_t, std::string>& chatId,
628 const std::variant<cpr::File, std::string>& videoNote,
629 std::int32_t messageThreadId = 0,
630 std::time_t duration = 0,
631 std::int32_t length = 0,
632 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{},
633 bool disableNotification = false,
634 bool protectContent = false,
635 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
636 const std::string& businessConnectionId = "",
637 std::int32_t directMessagesTopicId = 0,
638 bool allowPaidBroadcast = false,
639 const std::string& messageEffectId = "",
640 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
641 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
642
643
665 Ptr<Message> sendPaidMedia(const std::variant<std::int64_t, std::string>& chatId,
666 std::int32_t starCount,
667 const std::vector<Ptr<InputPaidMedia>>& media,
668 const std::string& payload = "",
669 std::int32_t messageThreadId = 0,
670 const std::string& caption = "",
671 const std::string& parseMode = "",
672 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
673 bool showCaptionAboveMedia = false,
674 bool disableNotification = false,
675 bool protectContent = false,
676 bool allowPaidBroadcast = false,
677 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
678 const std::string& businessConnectionId = "",
679 std::int32_t directMessagesTopicId = 0,
680 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
681 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
682
697 std::vector<Ptr<Message>> sendMediaGroup(const std::variant<std::int64_t, std::string>& chatId,
698 const std::vector<Ptr<InputMedia>>& media,
699 std::int32_t messageThreadId = 0,
700 bool disableNotification = false,
701 bool protectContent = false,
702 const std::string& businessConnectionId = "",
703 std::int32_t directMessagesTopicId = 0,
704 bool allowPaidBroadcast = false,
705 const std::string& messageEffectId = "",
706 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
707
708
728 Ptr<Message> sendLocation(const std::variant<std::int64_t, std::string>& chatId,
729 float latitude,
730 float longitude,
731 std::int32_t messageThreadId = 0,
732 float horizontalAccuracy = 0.0f,
733 std::int32_t livePeriod = 0,
734 std::int32_t heading = 0,
735 std::int32_t proximityAlertRadius = 0,
736 bool disableNotification = false,
737 bool protectContent = false,
738 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
739 const std::string& businessConnectionId = "",
740 std::int32_t directMessagesTopicId = 0,
741 bool allowPaidBroadcast = false,
742 const std::string& messageEffectId = "",
743 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
744 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
745
746
769 Ptr<Message> sendVenue(const std::variant<std::int64_t, std::string>& chatId,
770 float latitude,
771 float longitude,
772 const std::string& title,
773 const std::string& address,
774 std::int32_t messageThreadId = 0,
775 const std::string& foursquareId = "",
776 const std::string& foursquareType = "",
777 const std::string& googlePlaceId = "",
778 const std::string& googlePlaceType = "",
779 bool disableNotification = false,
780 bool protectContent = false,
781 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
782 const std::string& businessConnectionId = "",
783 std::int32_t directMessagesTopicId = 0,
784 bool allowPaidBroadcast = false,
785 const std::string& messageEffectId = "",
786 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
787 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
788
806 Ptr<Message> sendContact(const std::variant<std::int64_t, std::string>& chatId,
807 const std::string& phoneNumber,
808 const std::string& firstName,
809 const std::string& lastName = "",
810 const std::string& vcard = "",
811 std::int32_t messageThreadId = 0,
812 bool disableNotification = false,
813 bool protectContent = false,
814 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
815 const std::string& businessConnectionId = "",
816 std::int32_t directMessagesTopicId = 0,
817 bool allowPaidBroadcast = false,
818 const std::string& messageEffectId = "",
819 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
820 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
821
847 Ptr<Message> sendPoll(const std::variant<std::int64_t, std::string>& chatId,
848 const std::string& question,
849 const std::vector<Ptr<InputPollOption>>& options,
850 std::int32_t messageThreadId = 0,
851 const std::string& questionParseMode = "",
852 const std::vector<Ptr<MessageEntity>>& questionEntities = std::vector<Ptr<MessageEntity>>(),
853 bool isAnonymous = true,
854 const std::string& type = "regular",
855 bool allowsMultipleAnswers = false,
856 std::int32_t correctOptionId = -1,
857 const std::string& explanation = "",
858 const std::string& explanationParseMode = "",
859 const std::vector<Ptr<MessageEntity>>& explanationEntities = std::vector<Ptr<MessageEntity>>(),
860 std::time_t openPeriod = 0,
861 std::time_t closeDate = 0,
862 bool isClosed = false,
863 bool disableNotification = false,
864 bool protectContent = false,
865 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
866 const std::string& businessConnectionId = "",
867 bool allowPaidBroadcast = false,
868 const std::string& messageEffectId = "",
869 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
870
871
882 Ptr<Message> sendChecklist(const std::variant<std::int64_t, std::string>& chatId,
883 const std::string& businessConnectionId,
884 const Ptr<InputChecklist>& checklist,
885 bool disableNotification = false,
886 bool protectContent = false,
887 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
888 const std::string& messageEffectId = "",
889 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
890
891
911 Ptr<Message> sendDice(const std::variant<std::int64_t, std::string>& chatId,
912 const std::string& emoji = "🎲",
913 std::int32_t messageThreadId = 0,
914 bool disableNotification = false,
915 bool protectContent = false,
916 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
917 const std::string& businessConnectionId = "",
918 std::int32_t directMessagesTopicId = 0,
919 bool allowPaidBroadcast = false,
920 const std::string& messageEffectId = "",
921 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
922 const Ptr<ReplyParameters>& replyParameters = nullptr) const;
923
924
947 bool sendChatAction(const std::variant<std::int64_t, std::string>& chatId,
948 const std::string& action,
949 std::int32_t messageThreadId = 0,
950 const std::string& businessConnectionId = "") const;
951
952
964 bool setMessageReaction(const std::variant<std::int64_t, std::string>& chatId,
965 std::int32_t messageId,
966 const std::vector<Ptr<ReactionType>>& reaction = std::vector<Ptr<ReactionType>>(),
967 bool isBig = false) const;
968
969
977 Ptr<UserProfilePhotos> getUserProfilePhotos(std::int64_t userId,
978 std::int32_t offset = 0,
979 std::int32_t limit = 100) const;
980
981
991 Ptr<File> getFile(const std::string& fileId) const;
992
993
1003 std::string downloadFile(const std::string& filePath, const std::function<bool(cpr::cpr_off_t downloadTotal, cpr::cpr_off_t downloadNow)>& progressCallback = nullptr) const;
1004
1005
1018 bool banChatMember(const std::variant<std::int64_t, std::string>& chatId,
1019 std::int64_t userId,
1020 std::time_t untilDate = 0,
1021 bool revokeMessages = false) const;
1022
1023
1035 bool unbanChatMember(const std::variant<std::int64_t, std::string>& chatId,
1036 std::int64_t userId,
1037 bool onlyIfBanned = false) const;
1038
1039
1053 bool restrictChatMember(const std::variant<std::int64_t, std::string>& chatId,
1054 std::int64_t userId,
1055 const Ptr<ChatPermissions>& permissions,
1056 bool useIndependentChatPermissions = false,
1057 std::time_t untilDate = 0) const;
1058
1059
1085 bool promoteChatMember(const std::variant<std::int64_t, std::string>& chatId,
1086 std::int64_t userId,
1087 bool isAnonymous = false,
1088 bool canManageChat = false,
1089 bool canDeleteMessages = false,
1090 bool canManageVideoChats = false,
1091 bool canRestrictMembers = false,
1092 bool canPromoteMembers = false,
1093 bool canChangeInfo = false,
1094 bool canInviteUsers = false,
1095 bool canPostMessages = false,
1096 bool canEditMessages = false,
1097 bool canPinMessages = false,
1098 bool canPostStories = false,
1099 bool canEditStories = false,
1100 bool canDeleteStories = false,
1101 bool canManageTopics = false,
1102 bool canManageDirectMessages = false) const;
1103
1104
1112 bool setChatAdministratorCustomTitle(const std::variant<std::int64_t, std::string>& chatId,
1113 std::int64_t userId,
1114 const std::string& customTitle) const;
1115
1116
1127 bool banChatSenderChat(const std::variant<std::int64_t, std::string>& chatId,
1128 std::int64_t senderChatId) const;
1129
1130
1140 bool unbanChatSenderChat(const std::variant<std::int64_t, std::string>& chatId,
1141 std::int64_t senderChatId) const;
1142
1143
1155 bool setChatPermissions(const std::variant<std::int64_t, std::string>& chatId,
1156 const Ptr<ChatPermissions>& permissions,
1157 bool useIndependentChatPermissions = false) const;
1158
1159
1174 std::string exportChatInviteLink(const std::variant<std::int64_t, std::string>& chatId) const;
1175
1176
1189 Ptr<ChatInviteLink> createChatInviteLink(const std::variant<std::int64_t, std::string>& chatId,
1190 const std::string& name = "",
1191 std::time_t expireDate = 0,
1192 std::int32_t memberLimit = 0,
1193 bool createsJoinRequest = false) const;
1194
1195
1208 Ptr<ChatInviteLink> editChatInviteLink(const std::variant<std::int64_t, std::string>& chatId,
1209 const std::string& inviteLink,
1210 const std::string& name = "",
1211 std::time_t expireDate = 0,
1212 std::int32_t memberLimit = 0,
1213 bool createsJoinRequest = false) const;
1214
1226 Ptr<ChatInviteLink> createChatSubscriptionInviteLink(const std::variant<std::int64_t, std::string>& chatId,
1227 std::time_t subscriptionPeriod,
1228 std::int32_t subscriptionPrice,
1229 const std::string& name = "") const;
1230
1240 Ptr<ChatInviteLink> editChatSubscriptionInviteLink(const std::variant<std::int64_t, std::string>& chatId,
1241 const std::string& inviteLink,
1242 const std::string& name = "") const;
1243
1244
1253 Ptr<ChatInviteLink> revokeChatInviteLink(const std::variant<std::int64_t, std::string>& chatId, const std::string& inviteLink) const;
1254
1255
1264 bool approveChatJoinRequest(const std::variant<std::int64_t, std::string>& chatId, std::int64_t userId) const;
1265
1266
1275 bool declineChatJoinRequest(const std::variant<std::int64_t, std::string>& chatId, std::int64_t userId) const;
1276
1277
1286 bool setChatPhoto(const std::variant<std::int64_t, std::string>& chatId, const cpr::File& photo) const;
1287
1288
1296 bool deleteChatPhoto(const std::variant<std::int64_t, std::string>& chatId) const;
1297
1298
1306 bool setChatTitle(const std::variant<std::int64_t, std::string>& chatId, const std::string& title) const;
1307
1308
1316 bool setChatDescription(const std::variant<std::int64_t, std::string>& chatId, const std::string& description = "") const;
1317
1318
1331 bool pinChatMessage(const std::variant<std::int64_t, std::string>& chatId,
1332 std::int32_t messageId,
1333 bool disableNotification = false,
1334 const std::string& businessConnectionId = "") const;
1335
1336
1347 bool unpinChatMessage(const std::variant<std::int64_t, std::string>& chatId,
1348 std::int32_t messageId = 0,
1349 const std::string& businessConnectionId = "") const;
1350
1351
1360 bool unpinAllChatMessages(const std::variant<std::int64_t, std::string>& chatId) const;
1361
1362
1368 bool leaveChat(const std::variant<std::int64_t, std::string>& chatId) const;
1369
1370
1376 Ptr<Chat> getChat(const std::variant<std::int64_t, std::string>& chatId) const;
1377
1378
1384 std::vector<Ptr<ChatMember>> getChatAdministrators(const std::variant<std::int64_t, std::string>& chatId) const;
1385
1386
1392 std::int32_t getChatMemberCount(const std::variant<std::int64_t, std::string>& chatId) const;
1393
1394
1402 Ptr<ChatMember> getChatMember(const std::variant<std::int64_t, std::string>& chatId, std::int64_t userId) const;
1403
1404
1414 bool setChatStickerSet(const std::variant<std::int64_t, std::string>& chatId, const std::string& stickerSetName) const;
1415
1416
1425 bool deleteChatStickerSet(const std::variant<std::int64_t, std::string>& chatId) const;
1426
1427
1435 std::vector<Ptr<Sticker>> getForumTopicIconStickers() const;
1436
1437
1449 Ptr<ForumTopic> createForumTopic(const std::variant<std::int64_t, std::string>& chatId,
1450 const std::string& name,
1451 std::int32_t iconColor = 0x000000,
1452 const std::string& iconCustomEmojiId = "") const;
1453
1454
1468 bool editForumTopic(const std::variant<std::int64_t, std::string>& chatId,
1469 std::int32_t messageThreadId,
1470 const std::string& name,
1471 const std::optional<std::string>& iconCustomEmojiId = std::nullopt) const;
1472
1473
1483 bool closeForumTopic(const std::variant<std::int64_t, std::string>& chatId, std::int32_t messageThreadId) const;
1484
1485
1495 bool reopenForumTopic(const std::variant<std::int64_t, std::string>& chatId, std::int32_t messageThreadId) const;
1496
1497
1507 bool deleteForumTopic(const std::variant<std::int64_t, std::string>& chatId, std::int32_t messageThreadId) const;
1508
1509
1518 bool unpinAllForumTopicMessages(const std::variant<std::int64_t, std::string>& chatId, std::int32_t messageThreadId) const;
1519
1520
1528 bool editGeneralForumTopic(const std::variant<std::int64_t, std::string>& chatId, const std::string& name) const;
1529
1530
1537 bool closeGeneralForumTopic(const std::variant<std::int64_t, std::string>& chatId) const;
1538
1539
1546 bool reopenGeneralForumTopic(const std::variant<std::int64_t, std::string>& chatId) const;
1547
1548
1555 bool hideGeneralForumTopic(const std::variant<std::int64_t, std::string>& chatId) const;
1556
1557
1564 bool unhideGeneralForumTopic(const std::variant<std::int64_t, std::string>& chatId) const;
1565
1566
1573 bool unpinAllGeneralForumTopicMessages(const std::variant<std::int64_t, std::string>& chatId) const;
1574
1575
1592 bool answerCallbackQuery(const std::string& callbackQueryId,
1593 const std::string& text = "",
1594 bool showAlert = false,
1595 const std::string& url = "",
1596 std::time_t cacheTime = 0) const;
1597
1604 Ptr<UserChatBoosts> getUserChatBoosts(const std::variant<std::int64_t, std::string>& chatId,
1605 std::int64_t userId) const;
1606
1616 bool setMyCommands(const std::vector<Ptr<BotCommand>>& commands,
1617 const Ptr<BotCommandScope>& scope = nullptr,
1618 const std::string& languageCode = "") const;
1619
1620
1629 bool deleteMyCommands(const Ptr<BotCommandScope>& scope = nullptr, const std::string& languageCode = "") const;
1630
1631
1638 std::vector<Ptr<BotCommand>> getMyCommands(const Ptr<BotCommandScope>& scope = nullptr, const std::string& languageCode = "") const;
1639
1640
1647 bool setMyName(const std::string& name = "", const std::string& languageCode = "") const;
1648
1649
1655 Ptr<BotName> getMyName(const std::string& languageCode = "") const;
1656
1657
1664 bool setMyDescription(const std::string& description = "", const std::string& languageCode = "") const;
1665
1666
1672 Ptr<BotDescription> getMyDescription(const std::string& languageCode = "") const;
1673
1680 bool setMyShortDescription(const std::string& shortDescription = "", const std::string& languageCode = "") const;
1681
1687 Ptr<BotShortDescription> getMyShortDescription(const std::string& languageCode = "") const;
1688
1695 bool setChatMenuButton(const std::variant<std::int64_t, std::string>& chatId = std::string{}, const Ptr<MenuButton>& menuButton = nullptr) const;
1696
1702 Ptr<MenuButton> getChatMenuButton(const std::variant<std::int64_t, std::string>& chatId = std::string{}) const;
1703
1711 bool setMyDefaultAdministratorRights(const Ptr<ChatAdministratorRights>& rights = nullptr, bool forChannels = false) const;
1712
1718 Ptr<ChatAdministratorRights> getMyDefaultAdministratorRights(bool forChannels = false) const;
1719
1720 public: // Gifts
1725 Ptr<Gifts> getAvailableGifts() const;
1726
1738 bool sendGift(const std::string& giftId,
1739 std::int64_t userId = 0,
1740 const std::variant<std::int64_t, std::string>& chatId = 0,
1741 bool payForUpgrade = false,
1742 const std::string& text = "",
1743 const std::string& textParseMode = "",
1744 const std::vector<Ptr<MessageEntity>>& textEntities = std::vector<Ptr<MessageEntity>>()) const;
1745
1758 bool giftPremiumSubscription(std::int64_t userId,
1759 std::int32_t monthCount,
1760 std::int32_t starCount,
1761 const std::string& text = "",
1762 const std::string& textParseMode = "",
1763 const std::vector<Ptr<MessageEntity>>& textEntities = std::vector<Ptr<MessageEntity>>()) const;
1764
1765 public: // Verification
1774 bool verifyUser(std::int64_t userId, const std::string& customDescription = "") const;
1775
1784 bool verifyChat(const std::variant<std::int64_t, std::string>& chatId, const std::string& customDescription = "") const;
1785
1792 bool removeUserVerification(std::int64_t userId) const;
1793
1800 bool removeChatVerification(const std::variant<std::int64_t, std::string>& chatId) const;
1801
1802 public: // Business
1811 bool readBusinessMessage(const std::string& businessConnectionId,
1812 const std::variant<std::int64_t, std::string>& chatId,
1813 std::int32_t messageId) const;
1814
1824 bool deleteBusinessMessages(const std::string& businessConnectionId,
1825 const std::vector<std::int32_t>& messageIds) const;
1826
1834 bool setBusinessAccountName(const std::string& businessConnectionId,
1835 const std::string& firstName,
1836 const std::string& lastName = "") const;
1837
1844 bool setBusinessAccountUsername(const std::string& businessConnectionId,
1845 const std::string& username = "") const;
1846
1853 bool setBusinessAccountBio(const std::string& businessConnectionId,
1854 const std::string& bio = "") const;
1855
1863 bool setBusinessAccountProfilePhoto(const std::string& businessConnectionId,
1864 const Ptr<InputProfilePhoto>& photo,
1865 bool isPublic = false) const;
1866
1874 bool removeBusinessAccountProfilePhoto(const std::string& businessConnectionId,
1875 bool isPublic = false) const;
1876
1884 bool setBusinessAccountGiftSettings(const std::string& businessConnectionId,
1885 bool showGiftButton,
1886 const Ptr<AcceptedGiftTypes>& acceptedGiftTypes) const;
1887
1894 Ptr<StarAmount> getBusinessAccountStarBalance(const std::string& businessConnectionId) const;
1895
1902 bool transferBusinessAccountStars(const std::string& businessConnectionId,
1903 std::int32_t starCount) const;
1904
1919 Ptr<OwnedGifts> getBusinessAccountGifts(const std::string& businessConnectionId,
1920 bool excludeUnsaved = false,
1921 bool excludeSaved = false,
1922 bool excludeUnlimited = false,
1923 bool excludeLimited = false,
1924 bool excludeUnique = false,
1925 bool sortByPrice = false,
1926 const std::string& offset = "",
1927 std::int32_t limit = 100) const;
1928
1935 bool convertGiftToStars(const std::string& businessConnectionId, const std::string& ownedGiftId) const;
1936
1947 bool upgradeGift(const std::string& businessConnectionId,
1948 const std::string& ownedGiftId,
1949 bool keepOriginalDetails = false,
1950 std::int32_t starCount = -1) const;
1951
1961 bool transferGift(const std::string& businessConnectionId,
1962 const std::string& ownedGiftId,
1963 std::int64_t newOwnerChatId,
1964 std::int32_t starCount = -1) const;
1965
1966 public: // Story
1980 Ptr<Story> postStory(const std::string& businessConnectionId,
1981 const Ptr<InputStoryContent>& content,
1982 std::time_t activePeriod,
1983 const std::string& caption = "",
1984 const std::string& parseMode = "",
1985 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
1986 const std::vector<Ptr<StoryArea>>& areas = std::vector<Ptr<StoryArea>>(),
1987 bool postToChatPage = false,
1988 bool protectContent = false) const;
1989
2001 Ptr<Story> editStory(const std::string& businessConnectionId,
2002 std::int32_t storyId,
2003 const Ptr<InputStoryContent>& content,
2004 const std::string& caption = "",
2005 const std::string& parseMode = "",
2006 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
2007 const std::vector<Ptr<StoryArea>>& areas = std::vector<Ptr<StoryArea>>()) const;
2008
2015 bool deleteStory(const std::string& businessConnectionId, std::int32_t storyId) const;
2016
2017 public:
2056 Ptr<Message> sendInvoice(const std::variant<std::int64_t, std::string>& chatId,
2057 const std::string& title,
2058 const std::string& description,
2059 const std::string& payload,
2060 const std::string& currency,
2061 const std::vector<Ptr<LabeledPrice>>& prices,
2062 const std::string& providerToken = "",
2063 std::int32_t messageThreadId = 0,
2064 std::int32_t maxTipAmount = 0,
2065 const std::vector<std::int32_t>& suggestedTipAmounts = std::vector<std::int32_t>(),
2066 const std::string& startParameter = "",
2067 const std::string& providerData = "",
2068 const std::string& photoUrl = "",
2069 std::int32_t photoSize = 0,
2070 std::int32_t photoWidth = 0,
2071 std::int32_t photoHeight = 0,
2072 bool needName = false,
2073 bool needPhoneNumber = false,
2074 bool needEmail = false,
2075 bool needShippingAddress = false,
2076 bool sendPhoneNumberToProvider = false,
2077 bool sendEmailToProvider = false,
2078 bool isFlexible = false,
2079 bool disableNotification = false,
2080 bool protectContent = false,
2081 bool allowPaidBroadcast = false,
2082 const std::string& messageEffectId = "",
2083 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr,
2084 const Ptr<IReplyMarkup>& replyMarkup = nullptr) const;
2085
2121 std::string createInvoiceLink(const std::string& title,
2122 const std::string& description,
2123 const std::string& payload,
2124 const std::string& currency,
2125 const std::vector<Ptr<LabeledPrice>>& prices,
2126 const std::string& businessConnectionId = "",
2127 const std::string& providerToken = "",
2128 std::time_t subscriptionPeriod = 0,
2129 std::int32_t maxTipAmount = 0,
2130 const std::vector<std::int32_t>& suggestedTipAmounts = std::vector<std::int32_t>(),
2131 const std::string& providerData = "",
2132 const std::string& photoUrl = "",
2133 std::int32_t photoSize = 0,
2134 std::int32_t photoWidth = 0,
2135 std::int32_t photoHeight = 0,
2136 bool needName = false,
2137 bool needPhoneNumber = false,
2138 bool needEmail = false,
2139 bool needShippingAddress = false,
2140 bool sendPhoneNumberToProvider = false,
2141 bool sendEmailToProvider = false,
2142 bool isFlexible = false) const;
2143
2144
2156 bool answerShippingQuery(const std::string& shippingQueryId,
2157 bool ok,
2158 const std::vector<Ptr<ShippingOption>>& shippingOptions = std::vector<Ptr<ShippingOption>>(),
2159 const std::string& errorMessage = "") const;
2160
2161
2173 bool answerPreCheckoutQuery(const std::string& preCheckoutQueryId,
2174 bool ok,
2175 const std::string& errorMessage = "") const;
2176
2182 Ptr<StarAmount> getMyStarBalance() const;
2183
2191 Ptr<StarTransactions> getStarTransactions(std::int32_t offset = 0, std::int32_t limit = 100) const;
2192
2199 bool refundStarPayment(std::int64_t userId, const std::string& telegramPaymentChargeId) const;
2200
2209 bool editUserStarSubscription(std::int64_t userId,
2210 const std::string& telegramPaymentChargeId,
2211 bool isCancelled) const;
2212
2213
2214 public:
2229 std::vector<Ptr<Update>> getUpdates(std::int32_t offset, const std::shared_ptr<std::atomic<bool>>& cancellationParam = nullptr) const;
2230
2256 bool setWebhook(const std::string& url,
2257 const std::optional<cpr::File>& certificate = std::nullopt,
2258 const std::string& ipAddress = "",
2259 std::int32_t maxConnections = 40,
2260 const std::vector<std::string>& allowedUpdates = std::vector<std::string>(),
2261 bool dropPendingUpdates = false,
2262 const std::string& secretToken = "") const;
2263
2271 bool deleteWebhook(bool dropPendingUpdates = false) const;
2272
2278 Ptr<WebhookInfo> getWebhookInfo() const;
2279
2280 public:
2297 Ptr<Message> editMessageText(const std::string& text,
2298 const std::variant<std::int64_t, std::string>& chatId = 0,
2299 std::int32_t messageId = 0,
2300 const std::string& inlineMessageId = "",
2301 const std::string& parseMode = "",
2302 const std::vector<Ptr<MessageEntity>>& entities = std::vector<Ptr<MessageEntity>>(),
2303 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2304 const std::string& businessConnectionId = "",
2305 const Ptr<LinkPreviewOptions>& linkPreviewOptions = nullptr) const;
2306
2307
2320 Ptr<Message> editMessageCaption(const std::variant<std::int64_t, std::string>& chatId = 0,
2321 std::int32_t messageId = 0,
2322 const std::string& inlineMessageId = "",
2323 const std::string& caption = "",
2324 const std::string& parseMode = "",
2325 const std::vector<Ptr<MessageEntity>>& captionEntities = std::vector<Ptr<MessageEntity>>(),
2326 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2327 const std::string& businessConnectionId = "",
2328 bool showCaptionAboveMedia = false) const;
2329
2330
2342 Ptr<Message> editMessageMedia(const Ptr<InputMedia>& media,
2343 const std::variant<std::int64_t, std::string>& chatId = 0,
2344 std::int32_t messageId = 0,
2345 const std::string& inlineMessageId = "",
2346 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2347 const std::string& businessConnectionId = "") const;
2348
2349
2365 Ptr<Message> editMessageLiveLocation(float latitude,
2366 float longitude,
2367 const std::variant<std::int64_t, std::string>& chatId = 0,
2368 std::int32_t messageId = 0,
2369 const std::string& inlineMessageId = "",
2370 std::int32_t livePeriod = 0,
2371 float horizontalAccuracy = 0.0f,
2372 std::int32_t heading = 0,
2373 std::int32_t proximityAlertRadius = 0,
2374 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2375 const std::string& businessConnectionId = "") const;
2376
2377
2386 Ptr<Message> stopMessageLiveLocation(const std::variant<std::int64_t, std::string>& chatId = 0,
2387 std::int32_t messageId = 0,
2388 const std::string& inlineMessageId = "",
2389 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2390 const std::string& businessConnectionId = "") const;
2391
2400 Ptr<Message> editMessageChecklist(std::int64_t chatId,
2401 std::int32_t messageId,
2402 const Ptr<InputChecklist>& checklist,
2403 const std::string& businessConnectionId,
2404 const Ptr<IReplyMarkup>& replyMarkup = nullptr) const;
2405
2414 Ptr<Message> editMessageReplyMarkup(const std::variant<std::int64_t, std::string>& chatId = 0,
2415 std::int32_t messageId = 0,
2416 const std::string& inlineMessageId = "",
2417 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2418 const std::string& businessConnectionId = "") const;
2419
2420
2428 Ptr<Poll> stopPoll(const std::variant<std::int64_t, std::string>& chatId,
2429 std::int32_t messageId,
2430 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2431 const std::string& businessConnectionId = "") const;
2432
2433
2440 bool approveSuggestedPost(std::int64_t chatId,
2441 std::int32_t messageId,
2442 std::time_t sendDate = 0) const;
2443
2450 bool declineSuggestedPost(std::int64_t chatId,
2451 std::int32_t messageId,
2452 const std::string& comment = "") const;
2453
2468 bool deleteMessage(const std::variant<std::int64_t, std::string>& chatId, std::int32_t messageId) const;
2469
2476 bool deleteMessages(const std::variant<std::int64_t, std::string>& chatId, const std::vector<std::int32_t>& messageIds) const;
2477
2478 public:
2501 Ptr<Message> sendSticker(const std::variant<std::int64_t, std::string>& chatId,
2502 const std::variant<cpr::File, std::string>& sticker,
2503 std::int32_t messageThreadId = 0,
2504 const std::string& emoji = "",
2505 bool disableNotification = false,
2506 bool protectContent = false,
2507 const Ptr<ReplyParameters>& replyParameters = nullptr,
2508 const Ptr<IReplyMarkup>& replyMarkup = nullptr,
2509 const std::string& businessConnectionId = "",
2510 std::int32_t directMessagesTopicId = 0,
2511 const Ptr<LinkPreviewOptions>& linkPreviewOptions = nullptr,
2512 bool allowPaidBroadcast = false,
2513 const std::string& messageEffectId = "",
2514 const Ptr<SuggestedPostParameters>& suggestedPostParameters = nullptr) const;
2515
2521 Ptr<StickerSet> getStickerSet(const std::string& name) const;
2522
2528 std::vector<Ptr<Sticker>> getCustomEmojiStickers(const std::vector<std::string>& customEmojiIds) const;
2529
2539 Ptr<File> uploadStickerFile(std::int64_t userId,
2540 const cpr::File& sticker,
2541 const std::string& stickerFormat) const;
2542
2557 bool createNewStickerSet(std::int64_t userId,
2558 const std::string& name,
2559 const std::string& title,
2560 const std::vector<Ptr<InputSticker>>& stickers,
2561 const std::string& stickerType = "regular",
2562 bool needsRepainting = false) const;
2563
2574 bool addStickerToSet(std::int64_t userId,
2575 const std::string& name,
2576 const Ptr<InputSticker>& sticker) const;
2577
2584 bool setStickerPositionInSet(const std::string& sticker, std::int32_t position) const;
2585
2591 bool deleteStickerFromSet(const std::string& sticker) const;
2592
2603 bool replaceStickerInSet(std::int64_t userId,
2604 const std::string& name,
2605 const std::string& oldSticker,
2606 const Ptr<InputSticker>& sticker) const;
2607
2615 bool setStickerEmojiList(const std::string& sticker, const std::vector<std::string>& emojiList) const;
2616
2624 bool setStickerKeywords(const std::string& sticker, const std::vector<std::string>& keywords = std::vector<std::string>()) const;
2625
2633 bool setStickerMaskPosition(const std::string& sticker,
2634 const Ptr<MaskPosition>& maskPosition = nullptr) const;
2635
2642 bool setStickerSetTitle(const std::string& name, const std::string& title) const;
2643
2660 bool setStickerSetThumbnail(const std::string& name,
2661 std::int64_t userId,
2662 const std::string& format,
2663 const std::variant<std::monostate, cpr::File, std::string>& thumbnail = std::monostate{}) const;
2664
2672 bool setCustomEmojiStickerSetThumbnail(const std::string& name, const std::optional<std::string>& customEmojiId = std::nullopt) const;
2673
2679 bool deleteStickerSet(const std::string& name) const;
2680
2681 public:
2693 bool setPassportDataErrors(std::int64_t userId, const std::vector<Ptr<PassportElementError>>& errors) const;
2694
2695 public:
2708 Ptr<Message> sendGame(const std::variant<std::int64_t, std::string>& chatId,
2709 const std::string& gameShortName,
2710 std::int32_t messageThreadId = 0,
2711 bool disableNotification = false,
2712 bool protectContent = false,
2713 const Ptr<ReplyParameters>& replyParameters = nullptr,
2714 const Ptr<IReplyMarkup>& replyMarkup = nullptr) const;
2715
2727 Ptr<Message> setGameScore(std::int64_t userId,
2728 std::int32_t score,
2729 bool force = false,
2730 bool disableEditMessage = false,
2731 std::int64_t chatId = 0,
2732 std::int32_t messageId = 0,
2733 const std::string& inlineMessageId = "") const;
2734
2735
2747 std::vector<Ptr<GameHighScore>> getGameHighScores(std::int64_t userId,
2748 std::int64_t chatId = 0,
2749 std::int32_t messageId = 0,
2750 const std::string& inlineMessageId = "") const;
2751
2752 public:
2766 bool answerInlineQuery(const std::string& inlineQueryId,
2767 const std::vector<Ptr<InlineQueryResult>>& results,
2768 std::int32_t cacheTime = 300,
2769 bool isPersonal = false,
2770 const std::string& nextOffset = "",
2771 const Ptr<InlineQueryResultsButton>& button = nullptr) const;
2772
2773
2781 Ptr<SentWebAppMessage> answerWebAppQuery(const std::string& webAppQueryId, const Ptr<InlineQueryResult>& result) const;
2782
2783 public:
2785 void setUrl(const std::string& url) noexcept;
2787 const std::string& getUrl() const noexcept;
2788
2790 void setLongPollTimeout(const cpr::Timeout& longPollTimeout);
2792 cpr::Timeout getLongPollTimeout() const noexcept;
2793
2796 void setUpdatesLimit(const std::int32_t limit) noexcept;
2798 std::int32_t getUpdatesLimit() const noexcept;
2799
2801 void setConnectTimeout(const cpr::ConnectTimeout& timeout) noexcept;
2803 cpr::ConnectTimeout getConnectTimeout() const noexcept;
2804
2806 void setTimeout(const cpr::Timeout& timeout);
2808 cpr::Timeout getTimeout() const noexcept;
2809
2811 void setProxies(const cpr::Proxies& proxies);
2813 const cpr::Proxies& getProxies() const noexcept;
2814
2816 void setUploadFilesTimeout(const cpr::Timeout& timeout) noexcept;
2818 cpr::Timeout getUploadFilesTimeout() const noexcept;
2819
2821 void setDownloadFilesTimeout(const cpr::Timeout& timeout) noexcept;
2823 cpr::Timeout getDownloadFilesTimeout() const noexcept;
2824
2829 void setAllowedUpdates(const std::vector<std::string>& allowedUpdates) noexcept;
2831 const std::vector<std::string>& getAllowedUpdates() const noexcept;
2832
2835 const Cache& getCache() const noexcept;
2836
2837 private:
2838 nl::json sendRequest(const std::string& endpoint,
2839 const cpr::Multipart& data = cpr::Multipart({}),
2840 const std::shared_ptr<std::atomic<bool>>& cancellationParam = nullptr) const;
2841 };
2842}
tgbotxx::Api
Api Methods https://core.telegram.org/bots/api#available-methods.
Definition Api.hpp:75
tgbotxx::Api::logOut
bool logOut() const
Use this method to log out from the cloud Bot API server before launching the bot locally....
tgbotxx::Api::setChatTitle
bool setChatTitle(const std::variant< std::int64_t, std::string > &chatId, const std::string &title) const
Use this method to change the title of a chat. Titles can't be changed for private chats....
tgbotxx::Api::getMyCommands
std::vector< Ptr< BotCommand > > getMyCommands(const Ptr< BotCommandScope > &scope=nullptr, const std::string &languageCode="") const
Use this method to get the current list of the bot's commands for the given scope and user language.
tgbotxx::Api::setBusinessAccountProfilePhoto
bool setBusinessAccountProfilePhoto(const std::string &businessConnectionId, const Ptr< InputProfilePhoto > &photo, bool isPublic=false) const
Changes the profile photo of a managed business account. Requires the can_edit_profile_photo business...
tgbotxx::Api::getAvailableGifts
Ptr< Gifts > getAvailableGifts() const
Returns the list of gifts that can be sent by the bot to users and channel chats. Requires no paramet...
tgbotxx::Api::setUpdatesLimit
void setUpdatesLimit(const std::int32_t limit) noexcept
Set the number of long polling updates to be retrieved by getUpdates(). Values between 1-100 are acce...
tgbotxx::Api::editMessageCaption
Ptr< Message > editMessageCaption(const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", bool showCaptionAboveMedia=false) const
Use this method to edit captions of messages.
tgbotxx::Api::reopenGeneralForumTopic
bool reopenGeneralForumTopic(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to reopen a closed 'General' topic in a forum supergroup chat. The bot must be an adm...
tgbotxx::Api::getMyShortDescription
Ptr< BotShortDescription > getMyShortDescription(const std::string &languageCode="") const
Use this method to get the current bot short description for the given user language.
tgbotxx::Api::getForumTopicIconStickers
std::vector< Ptr< Sticker > > getForumTopicIconStickers() const
Use this method to get custom emoji stickers, which can be used as a forum topic icon by any user....
tgbotxx::Api::getTimeout
cpr::Timeout getTimeout() const noexcept
Get Api requests timeout.
tgbotxx::Api::stopPoll
Ptr< Poll > stopPoll(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="") const
Use this method to stop a poll which was sent by the bot.
tgbotxx::Api::setChatPhoto
bool setChatPhoto(const std::variant< std::int64_t, std::string > &chatId, const cpr::File &photo) const
Use this method to set a new profile photo for the chat. Photos can't be changed for private chats....
tgbotxx::Api::copyMessages
std::vector< Ptr< MessageId > > copyMessages(const std::variant< std::int64_t, std::string > &chatId, const std::variant< std::int64_t, std::string > &fromChatId, const std::vector< std::int32_t > &messageIds, std::int32_t messageThreadId=0, std::int32_t directMessagesTopicId=0, bool disableNotification=false, bool protectContent=false, bool removeCaption=false) const
Use this method to copy messages of any kind. /// If some of the specified messages can't be found or...
tgbotxx::Api::setBusinessAccountUsername
bool setBusinessAccountUsername(const std::string &businessConnectionId, const std::string &username="") const
Changes the first and last name of a managed business account. Requires the can_change_name business ...
tgbotxx::Api::setUploadFilesTimeout
void setUploadFilesTimeout(const cpr::Timeout &timeout) noexcept
Set Api file uploads timeout.
tgbotxx::Api::sendChecklist
Ptr< Message > sendChecklist(const std::variant< std::int64_t, std::string > &chatId, const std::string &businessConnectionId, const Ptr< InputChecklist > &checklist, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &messageEffectId="", const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send a checklist on behalf of a connected business account. On success,...
tgbotxx::Api::unbanChatSenderChat
bool unbanChatSenderChat(const std::variant< std::int64_t, std::string > &chatId, std::int64_t senderChatId) const
Use this method to unban a previously banned channel chat in a supergroup or channel....
tgbotxx::Api::sendAudio
Ptr< Message > sendAudio(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &audio, std::int32_t messageThreadId=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), std::time_t duration=0, const std::string &performer="", const std::string &title="", const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send audio files, if you want Telegram clients to display them in the music player...
tgbotxx::Api::editMessageText
Ptr< Message > editMessageText(const std::string &text, const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &entities=std::vector< Ptr< MessageEntity > >(), const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", const Ptr< LinkPreviewOptions > &linkPreviewOptions=nullptr) const
Use this method to edit text and game messages.
tgbotxx::Api::setChatMenuButton
bool setChatMenuButton(const std::variant< std::int64_t, std::string > &chatId=std::string{}, const Ptr< MenuButton > &menuButton=nullptr) const
Use this method to change the bot's menu button in a private chat, or the default menu button.
tgbotxx::Api::getStickerSet
Ptr< StickerSet > getStickerSet(const std::string &name) const
Use this method to get a sticker set. On success, a StickerSet object is returned.
tgbotxx::Api::sendChatAction
bool sendChatAction(const std::variant< std::int64_t, std::string > &chatId, const std::string &action, std::int32_t messageThreadId=0, const std::string &businessConnectionId="") const
Use this method when you need to tell the user that something is happening on the bot's side....
tgbotxx::Api::getChatMenuButton
Ptr< MenuButton > getChatMenuButton(const std::variant< std::int64_t, std::string > &chatId=std::string{}) const
Use this method to get the current value of the bot's menu button in a private chat,...
tgbotxx::Api::editChatInviteLink
Ptr< ChatInviteLink > editChatInviteLink(const std::variant< std::int64_t, std::string > &chatId, const std::string &inviteLink, const std::string &name="", std::time_t expireDate=0, std::int32_t memberLimit=0, bool createsJoinRequest=false) const
Use this method to edit a non-primary invite link created by the bot. The bot must be an administrato...
tgbotxx::Api::sendGame
Ptr< Message > sendGame(const std::variant< std::int64_t, std::string > &chatId, const std::string &gameShortName, std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, const Ptr< ReplyParameters > &replyParameters=nullptr, const Ptr< IReplyMarkup > &replyMarkup=nullptr) const
Use this method to send a game.
tgbotxx::Api::deleteStickerSet
bool deleteStickerSet(const std::string &name) const
Use this method to delete a sticker set that was created by the bot.
tgbotxx::Api::removeChatVerification
bool removeChatVerification(const std::variant< std::int64_t, std::string > &chatId) const
Removes verification from a chat that is currently verified on behalf of the organization represented...
tgbotxx::Api::setTimeout
void setTimeout(const cpr::Timeout &timeout)
Set Api requests timeout.
tgbotxx::Api::setChatDescription
bool setChatDescription(const std::variant< std::int64_t, std::string > &chatId, const std::string &description="") const
Use this method to change the description of a group, a supergroup or a channel. The bot must be an a...
tgbotxx::Api::getStarTransactions
Ptr< StarTransactions > getStarTransactions(std::int32_t offset=0, std::int32_t limit=100) const
Returns the bot's Telegram Star transactions in chronological order. On success, returns a StarTransa...
tgbotxx::Api::sendVideo
Ptr< Message > sendVideo(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &video, std::int32_t messageThreadId=0, std::time_t duration=0, std::int32_t width=0, std::int32_t height=0, const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}, const std::variant< std::monostate, cpr::File, std::string > &cover=std::monostate{}, std::time_t startTimestamp=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool showCaptionAboveMedia=false, bool hasSpoiler=false, bool supportsStreaming=false, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send video files, if you want Telegram clients to display them as a video message.
tgbotxx::Api::pinChatMessage
bool pinChatMessage(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId, bool disableNotification=false, const std::string &businessConnectionId="") const
Use this method to add a message to the list of pinned messages in a chat. If the chat is not a priva...
tgbotxx::Api::setBusinessAccountName
bool setBusinessAccountName(const std::string &businessConnectionId, const std::string &firstName, const std::string &lastName="") const
Changes the first and last name of a managed business account. Requires the can_change_name business ...
tgbotxx::Api::createChatSubscriptionInviteLink
Ptr< ChatInviteLink > createChatSubscriptionInviteLink(const std::variant< std::int64_t, std::string > &chatId, std::time_t subscriptionPeriod, std::int32_t subscriptionPrice, const std::string &name="") const
Use this method to create a subscription invite link for a channel chat. The bot must have the can_in...
tgbotxx::Api::getDownloadFilesTimeout
cpr::Timeout getDownloadFilesTimeout() const noexcept
Get Api file downloads timeout.
tgbotxx::Api::createForumTopic
Ptr< ForumTopic > createForumTopic(const std::variant< std::int64_t, std::string > &chatId, const std::string &name, std::int32_t iconColor=0x000000, const std::string &iconCustomEmojiId="") const
Use this method to create a topic in a forum supergroup chat. The bot must be an administrator in the...
tgbotxx::Api::editUserStarSubscription
bool editUserStarSubscription(std::int64_t userId, const std::string &telegramPaymentChargeId, bool isCancelled) const
Allows the bot to cancel or re-enable extension of a subscription paid in Telegram Stars....
tgbotxx::Api::getChatMemberCount
std::int32_t getChatMemberCount(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to get the number of members in a chat.
tgbotxx::Api::refundStarPayment
bool refundStarPayment(std::int64_t userId, const std::string &telegramPaymentChargeId) const
Refunds a successful payment in Telegram Stars. Returns True on success.
tgbotxx::Api::setStickerPositionInSet
bool setStickerPositionInSet(const std::string &sticker, std::int32_t position) const
Use this method to move a sticker in a set created by the bot to a specific position.
tgbotxx::Api::verifyChat
bool verifyChat(const std::variant< std::int64_t, std::string > &chatId, const std::string &customDescription="") const
Verifies a chat on behalf of the organization which is represented by the bot.
tgbotxx::Api::copyMessage
Ptr< MessageId > copyMessage(const std::variant< std::int64_t, std::string > &chatId, const std::variant< std::int64_t, std::string > &fromChatId, std::int32_t messageId, std::int32_t messageThreadId=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, std::int32_t directMessagesTopicId=0, std::time_t videoStartTimestamp=0, bool showCaptionAboveMedia=false, bool allowPaidBroadcast=false, const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to copy messages of any kind. Service messages, paid media messages,...
tgbotxx::Api::setAllowedUpdates
void setAllowedUpdates(const std::vector< std::string > &allowedUpdates) noexcept
tgbotxx::Api::getBusinessAccountGifts
Ptr< OwnedGifts > getBusinessAccountGifts(const std::string &businessConnectionId, bool excludeUnsaved=false, bool excludeSaved=false, bool excludeUnlimited=false, bool excludeLimited=false, bool excludeUnique=false, bool sortByPrice=false, const std::string &offset="", std::int32_t limit=100) const
Returns the gifts received and owned by a managed business account. Requires the can_view_gifts_and_s...
tgbotxx::Api::getProxies
const cpr::Proxies & getProxies() const noexcept
Get Api requests proxy.
tgbotxx::Api::editChatSubscriptionInviteLink
Ptr< ChatInviteLink > editChatSubscriptionInviteLink(const std::variant< std::int64_t, std::string > &chatId, const std::string &inviteLink, const std::string &name="") const
Use this method to edit a subscription invite link created by the bot. The bot must have the can_invi...
tgbotxx::Api::Api
Api(const std::string &token)
Constructs Api object.
tgbotxx::Api::createInvoiceLink
std::string createInvoiceLink(const std::string &title, const std::string &description, const std::string &payload, const std::string &currency, const std::vector< Ptr< LabeledPrice > > &prices, const std::string &businessConnectionId="", const std::string &providerToken="", std::time_t subscriptionPeriod=0, std::int32_t maxTipAmount=0, const std::vector< std::int32_t > &suggestedTipAmounts=std::vector< std::int32_t >(), const std::string &providerData="", const std::string &photoUrl="", std::int32_t photoSize=0, std::int32_t photoWidth=0, std::int32_t photoHeight=0, bool needName=false, bool needPhoneNumber=false, bool needEmail=false, bool needShippingAddress=false, bool sendPhoneNumberToProvider=false, bool sendEmailToProvider=false, bool isFlexible=false) const
Use this method to create a link for an invoice. Returns the created invoice link as std::string on s...
tgbotxx::Api::getMyDescription
Ptr< BotDescription > getMyDescription(const std::string &languageCode="") const
Use this method to get the current bot description for the given user language.
tgbotxx::Api::postStory
Ptr< Story > postStory(const std::string &businessConnectionId, const Ptr< InputStoryContent > &content, std::time_t activePeriod, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), const std::vector< Ptr< StoryArea > > &areas=std::vector< Ptr< StoryArea > >(), bool postToChatPage=false, bool protectContent=false) const
Posts a story on behalf of a managed business account. Requires the can_manage_stories business bot r...
tgbotxx::Api::setDownloadFilesTimeout
void setDownloadFilesTimeout(const cpr::Timeout &timeout) noexcept
Set Api file downloads timeout.
tgbotxx::Api::transferBusinessAccountStars
bool transferBusinessAccountStars(const std::string &businessConnectionId, std::int32_t starCount) const
Transfers Telegram Stars from the business account balance to the bot's balance. Requires the can_tra...
tgbotxx::Api::setChatPermissions
bool setChatPermissions(const std::variant< std::int64_t, std::string > &chatId, const Ptr< ChatPermissions > &permissions, bool useIndependentChatPermissions=false) const
Use this method to set default chat permissions for all members. The bot must be an administrator in ...
tgbotxx::Api::transferGift
bool transferGift(const std::string &businessConnectionId, const std::string &ownedGiftId, std::int64_t newOwnerChatId, std::int32_t starCount=-1) const
Transfers an owned unique gift to another user. Requires the can_transfer_and_upgrade_gifts business ...
tgbotxx::Api::sendPhoto
Ptr< Message > sendPhoto(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &photo, std::int32_t messageThreadId=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool showCaptionAboveMedia=false, bool hasSpoiler=false, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send photos. On success, the sent Message is returned.
tgbotxx::Api::getUrl
const std::string & getUrl() const noexcept
Get Api URL.
tgbotxx::Api::giftPremiumSubscription
bool giftPremiumSubscription(std::int64_t userId, std::int32_t monthCount, std::int32_t starCount, const std::string &text="", const std::string &textParseMode="", const std::vector< Ptr< MessageEntity > > &textEntities=std::vector< Ptr< MessageEntity > >()) const
Gifts a Telegram Premium subscription to the given user.
tgbotxx::Api::deleteMessages
bool deleteMessages(const std::variant< std::int64_t, std::string > &chatId, const std::vector< std::int32_t > &messageIds) const
Use this method to delete multiple messages simultaneously. If some of the specified messages can't b...
tgbotxx::Api::readBusinessMessage
bool readBusinessMessage(const std::string &businessConnectionId, const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId) const
Marks incoming message as read on behalf of a business account. Requires the can_read_messages busine...
tgbotxx::Api::deleteWebhook
bool deleteWebhook(bool dropPendingUpdates=false) const
Use this method to remove webhook integration if you decide to switch back to getUpdates.
tgbotxx::Api::getCache
const Cache & getCache() const noexcept
Get cached data about this bot e.g: username, commands... Use this when possible to avoid unnecessary...
tgbotxx::Api::unpinAllChatMessages
bool unpinAllChatMessages(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to clear the list of pinned messages in a chat. If the chat is not a private chat,...
tgbotxx::Api::setStickerSetThumbnail
bool setStickerSetThumbnail(const std::string &name, std::int64_t userId, const std::string &format, const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}) const
Use this method to set the thumbnail of a regular or mask sticker set. The format of the thumbnail fi...
tgbotxx::Api::answerInlineQuery
bool answerInlineQuery(const std::string &inlineQueryId, const std::vector< Ptr< InlineQueryResult > > &results, std::int32_t cacheTime=300, bool isPersonal=false, const std::string &nextOffset="", const Ptr< InlineQueryResultsButton > &button=nullptr) const
Use this method to send answers to an inline query. No more than 50 results per query are allowed.
tgbotxx::Api::banChatSenderChat
bool banChatSenderChat(const std::variant< std::int64_t, std::string > &chatId, std::int64_t senderChatId) const
Use this method to ban a channel chat in a supergroup or a channel. Until the chat is unbanned,...
tgbotxx::Api::unhideGeneralForumTopic
bool unhideGeneralForumTopic(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to unhide the 'General' topic in a forum supergroup chat. The bot must be an administ...
tgbotxx::Api::editMessageReplyMarkup
Ptr< Message > editMessageReplyMarkup(const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="") const
Use this method to edit only the reply markup of messages.
tgbotxx::Api::verifyUser
bool verifyUser(std::int64_t userId, const std::string &customDescription="") const
Verifies a user on behalf of the organization which is represented by the bot.
tgbotxx::Api::createNewStickerSet
bool createNewStickerSet(std::int64_t userId, const std::string &name, const std::string &title, const std::vector< Ptr< InputSticker > > &stickers, const std::string &stickerType="regular", bool needsRepainting=false) const
Use this method to create a new sticker set owned by a user. The bot will be able to edit the sticker...
tgbotxx::Api::getMyDefaultAdministratorRights
Ptr< ChatAdministratorRights > getMyDefaultAdministratorRights(bool forChannels=false) const
Use this method to get the current default administrator rights of the bot.
tgbotxx::Api::deleteStickerFromSet
bool deleteStickerFromSet(const std::string &sticker) const
Use this method to delete a sticker from a set created by the bot.
tgbotxx::Api::setChatStickerSet
bool setChatStickerSet(const std::variant< std::int64_t, std::string > &chatId, const std::string &stickerSetName) const
Use this method to set a new group sticker set for a supergroup. The bot must be an administrator in ...
tgbotxx::Api::unpinAllForumTopicMessages
bool unpinAllForumTopicMessages(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageThreadId) const
Use this method to clear the list of pinned messages in a forum topic. The bot must be an administrat...
tgbotxx::Api::answerShippingQuery
bool answerShippingQuery(const std::string &shippingQueryId, bool ok, const std::vector< Ptr< ShippingOption > > &shippingOptions=std::vector< Ptr< ShippingOption > >(), const std::string &errorMessage="") const
If you sent an invoice requesting a shipping address and the parameter isFlexible was specified,...
tgbotxx::Api::setBusinessAccountBio
bool setBusinessAccountBio(const std::string &businessConnectionId, const std::string &bio="") const
Changes the bio of a managed business account. Requires the can_change_bio business bot right.
tgbotxx::Api::sendDocument
Ptr< Message > sendDocument(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &document, std::int32_t messageThreadId=0, const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool disableContentTypeDetection=false, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send general files.
tgbotxx::Api::exportChatInviteLink
std::string exportChatInviteLink(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to generate a new primary invite link for a chat; any previously generated primary li...
tgbotxx::Api::setStickerSetTitle
bool setStickerSetTitle(const std::string &name, const std::string &title) const
Use this method to set the title of a created sticker set.
tgbotxx::Api::declineSuggestedPost
bool declineSuggestedPost(std::int64_t chatId, std::int32_t messageId, const std::string &comment="") const
Use this method to decline a suggested post in a direct messages chat. The bot must have the 'can_man...
tgbotxx::Api::setCustomEmojiStickerSetThumbnail
bool setCustomEmojiStickerSetThumbnail(const std::string &name, const std::optional< std::string > &customEmojiId=std::nullopt) const
Use this method to set the thumbnail of a custom emoji sticker set.
tgbotxx::Api::createChatInviteLink
Ptr< ChatInviteLink > createChatInviteLink(const std::variant< std::int64_t, std::string > &chatId, const std::string &name="", std::time_t expireDate=0, std::int32_t memberLimit=0, bool createsJoinRequest=false) const
Use this method to create an additional invite link for a chat. The bot must be an administrator in t...
tgbotxx::Api::editGeneralForumTopic
bool editGeneralForumTopic(const std::variant< std::int64_t, std::string > &chatId, const std::string &name) const
Use this method to edit the name of the 'General' topic in a forum supergroup chat....
tgbotxx::Api::unpinChatMessage
bool unpinChatMessage(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId=0, const std::string &businessConnectionId="") const
Use this method to remove a message from the list of pinned messages in a chat. If the chat is not a ...
tgbotxx::Api::setPassportDataErrors
bool setPassportDataErrors(std::int64_t userId, const std::vector< Ptr< PassportElementError > > &errors) const
Informs a user that some of the Telegram Passport elements they provided contains errors....
tgbotxx::Api::deleteMyCommands
bool deleteMyCommands(const Ptr< BotCommandScope > &scope=nullptr, const std::string &languageCode="") const
Use this method to delete the list of the bot's commands for the given scope and user language....
tgbotxx::Api::getMyName
Ptr< BotName > getMyName(const std::string &languageCode="") const
Use this method to get the current bot name for the given user language.
tgbotxx::Api::replaceStickerInSet
bool replaceStickerInSet(std::int64_t userId, const std::string &name, const std::string &oldSticker, const Ptr< InputSticker > &sticker) const
Use this method to replace an existing sticker in a sticker set with a new one. The method is equival...
tgbotxx::Api::convertGiftToStars
bool convertGiftToStars(const std::string &businessConnectionId, const std::string &ownedGiftId) const
Converts a given regular gift to Telegram Stars. Requires the can_convert_gifts_to_stars business bot...
tgbotxx::Api::editForumTopic
bool editForumTopic(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageThreadId, const std::string &name, const std::optional< std::string > &iconCustomEmojiId=std::nullopt) const
Use this method to edit name and icon of a topic in a forum supergroup chat. The bot must be an admin...
tgbotxx::Api::revokeChatInviteLink
Ptr< ChatInviteLink > revokeChatInviteLink(const std::variant< std::int64_t, std::string > &chatId, const std::string &inviteLink) const
Use this method to revoke an invite link created by the bot. If the primary link is revoked,...
tgbotxx::Api::sendPoll
Ptr< Message > sendPoll(const std::variant< std::int64_t, std::string > &chatId, const std::string &question, const std::vector< Ptr< InputPollOption > > &options, std::int32_t messageThreadId=0, const std::string &questionParseMode="", const std::vector< Ptr< MessageEntity > > &questionEntities=std::vector< Ptr< MessageEntity > >(), bool isAnonymous=true, const std::string &type="regular", bool allowsMultipleAnswers=false, std::int32_t correctOptionId=-1, const std::string &explanation="", const std::string &explanationParseMode="", const std::vector< Ptr< MessageEntity > > &explanationEntities=std::vector< Ptr< MessageEntity > >(), std::time_t openPeriod=0, std::time_t closeDate=0, bool isClosed=false, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send a native poll. On success, the sent Message is returned.
tgbotxx::Api::getChatAdministrators
std::vector< Ptr< ChatMember > > getChatAdministrators(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to get a list of administrators in a chat, which aren't bots.
tgbotxx::Api::sendDice
Ptr< Message > sendDice(const std::variant< std::int64_t, std::string > &chatId, const std::string &emoji="🎲", std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send an animated emoji that will display a random value. On success,...
tgbotxx::Api::closeForumTopic
bool closeForumTopic(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageThreadId) const
Use this method to close an open topic in a forum supergroup chat. The bot must be an administrator i...
tgbotxx::Api::getLongPollTimeout
cpr::Timeout getLongPollTimeout() const noexcept
Get long polling timeout.
tgbotxx::Api::setMyDescription
bool setMyDescription(const std::string &description="", const std::string &languageCode="") const
Use this method to change the bot's description, which is shown in the chat with the bot if the chat ...
tgbotxx::Api::removeBusinessAccountProfilePhoto
bool removeBusinessAccountProfilePhoto(const std::string &businessConnectionId, bool isPublic=false) const
Removes the current profile photo of a managed business account. Requires the can_edit_profile_photo ...
tgbotxx::Api::deleteStory
bool deleteStory(const std::string &businessConnectionId, std::int32_t storyId) const
Deletes a story previously posted by the bot on behalf of a managed business account....
tgbotxx::Api::getAllowedUpdates
const std::vector< std::string > & getAllowedUpdates() const noexcept
Get list of the update types you want your bot to receive.
tgbotxx::Api::editMessageLiveLocation
Ptr< Message > editMessageLiveLocation(float latitude, float longitude, const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", std::int32_t livePeriod=0, float horizontalAccuracy=0.0f, std::int32_t heading=0, std::int32_t proximityAlertRadius=0, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="") const
Use this method to edit live location messages. A location can be edited until its livePeriod expires...
tgbotxx::Api::forwardMessage
Ptr< Message > forwardMessage(const std::variant< std::int64_t, std::string > &chatId, const std::variant< std::int64_t, std::string > &fromChatId, std::int32_t messageId, std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, std::int32_t directMessagesTopicId=0, std::time_t videoStartTimestamp=0, const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr) const
Use this method to forward messages of any kind. Service messages and messages with protected content...
tgbotxx::Api::unpinAllGeneralForumTopicMessages
bool unpinAllGeneralForumTopicMessages(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to clear the list of pinned messages in a General forum topic. The bot must be an adm...
tgbotxx::Api::approveSuggestedPost
bool approveSuggestedPost(std::int64_t chatId, std::int32_t messageId, std::time_t sendDate=0) const
Use this method to approve a suggested post in a direct messages chat. The bot must have the 'can_pos...
tgbotxx::Api::hideGeneralForumTopic
bool hideGeneralForumTopic(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to hide the 'General' topic in a forum supergroup chat. The bot must be an administra...
tgbotxx::Api::sendMediaGroup
std::vector< Ptr< Message > > sendMediaGroup(const std::variant< std::int64_t, std::string > &chatId, const std::vector< Ptr< InputMedia > > &media, std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send a group of photos, videos, or documents as an album. On success,...
tgbotxx::Api::getBusinessAccountStarBalance
Ptr< StarAmount > getBusinessAccountStarBalance(const std::string &businessConnectionId) const
Returns the amount of Telegram Stars owned by a managed business account. Requires the can_view_gifts...
tgbotxx::Api::uploadStickerFile
Ptr< File > uploadStickerFile(std::int64_t userId, const cpr::File &sticker, const std::string &stickerFormat) const
Use this method to upload a file with a sticker for later use in the createNewStickerSet and addStick...
tgbotxx::Api::deleteChatStickerSet
bool deleteChatStickerSet(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to delete a group sticker set from a supergroup. The bot must be an administrator in ...
tgbotxx::Api::sendAnimation
Ptr< Message > sendAnimation(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &animation, std::int32_t messageThreadId=0, std::time_t duration=0, std::int32_t width=0, std::int32_t height=0, const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send animation files (GIFs or H.264/MPEG-4 AVC videos without sound).
tgbotxx::Api::getUploadFilesTimeout
cpr::Timeout getUploadFilesTimeout() const noexcept
Get Api file uploads timeout.
tgbotxx::Api::leaveChat
bool leaveChat(const std::variant< std::int64_t, std::string > &chatId) const
Use this method for your bot to leave a group, supergroup or channel.
tgbotxx::Api::setMyDefaultAdministratorRights
bool setMyDefaultAdministratorRights(const Ptr< ChatAdministratorRights > &rights=nullptr, bool forChannels=false) const
Use this method to change the default administrator rights requested by the bot when it's added as an...
tgbotxx::Api::getChatMember
Ptr< ChatMember > getChatMember(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId) const
Use this method to get information about a member of a chat. The method is only guaranteed to work fo...
tgbotxx::Api::deleteMessage
bool deleteMessage(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId) const
Use this method to delete a message, including service messages, with the following limitations:
tgbotxx::Api::deleteForumTopic
bool deleteForumTopic(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageThreadId) const
Use this method to delete a forum topic along with all its messages in a forum supergroup chat....
tgbotxx::Api::sendSticker
Ptr< Message > sendSticker(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &sticker, std::int32_t messageThreadId=0, const std::string &emoji="", bool disableNotification=false, bool protectContent=false, const Ptr< ReplyParameters > &replyParameters=nullptr, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, const Ptr< LinkPreviewOptions > &linkPreviewOptions=nullptr, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr) const
Use this method to send static .WEBP, animated .TGS, or video .WEBM stickers. On success,...
tgbotxx::Api::setProxies
void setProxies(const cpr::Proxies &proxies)
Set Api requests proxy.
tgbotxx::Api::sendGift
bool sendGift(const std::string &giftId, std::int64_t userId=0, const std::variant< std::int64_t, std::string > &chatId=0, bool payForUpgrade=false, const std::string &text="", const std::string &textParseMode="", const std::vector< Ptr< MessageEntity > > &textEntities=std::vector< Ptr< MessageEntity > >()) const
Sends a gift to the given user or channel chat. The gift can't be converted to Telegram Stars by the ...
tgbotxx::Api::getUpdates
std::vector< Ptr< Update > > getUpdates(std::int32_t offset, const std::shared_ptr< std::atomic< bool > > &cancellationParam=nullptr) const
Use this method to receive incoming updates using long polling.
tgbotxx::Api::setStickerKeywords
bool setStickerKeywords(const std::string &sticker, const std::vector< std::string > &keywords=std::vector< std::string >()) const
Use this method to change search keywords assigned to a regular or custom emoji sticker....
tgbotxx::Api::answerPreCheckoutQuery
bool answerPreCheckoutQuery(const std::string &preCheckoutQueryId, bool ok, const std::string &errorMessage="") const
Once the user has confirmed their payment and shipping details, the Bot API sends the final confirmat...
tgbotxx::Api::downloadFile
std::string downloadFile(const std::string &filePath, const std::function< bool(cpr::cpr_off_t downloadTotal, cpr::cpr_off_t downloadNow)> &progressCallback=nullptr) const
Use this method to download a file from Telegram and save it in memory. For the moment,...
tgbotxx::Api::setChatAdministratorCustomTitle
bool setChatAdministratorCustomTitle(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId, const std::string &customTitle) const
Use this method to set a custom title for an administrator in a supergroup promoted by the bot.
tgbotxx::Api::promoteChatMember
bool promoteChatMember(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId, bool isAnonymous=false, bool canManageChat=false, bool canDeleteMessages=false, bool canManageVideoChats=false, bool canRestrictMembers=false, bool canPromoteMembers=false, bool canChangeInfo=false, bool canInviteUsers=false, bool canPostMessages=false, bool canEditMessages=false, bool canPinMessages=false, bool canPostStories=false, bool canEditStories=false, bool canDeleteStories=false, bool canManageTopics=false, bool canManageDirectMessages=false) const
Use this method to promote or demote a user in a supergroup or a channel. The bot must be an administ...
tgbotxx::Api::setLongPollTimeout
void setLongPollTimeout(const cpr::Timeout &longPollTimeout)
Set long polling timeout.
tgbotxx::Api::setConnectTimeout
void setConnectTimeout(const cpr::ConnectTimeout &timeout) noexcept
Set Api requests connection timeout.
tgbotxx::Api::sendContact
Ptr< Message > sendContact(const std::variant< std::int64_t, std::string > &chatId, const std::string &phoneNumber, const std::string &firstName, const std::string &lastName="", const std::string &vcard="", std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send phone contacts. On success, the sent Message is returned.
tgbotxx::Api::getCustomEmojiStickers
std::vector< Ptr< Sticker > > getCustomEmojiStickers(const std::vector< std::string > &customEmojiIds) const
Use this method to get information about custom emoji stickers by their identifiers.
tgbotxx::Api::deleteBusinessMessages
bool deleteBusinessMessages(const std::string &businessConnectionId, const std::vector< std::int32_t > &messageIds) const
Delete messages on behalf of a business account. Requires the can_delete_sent_messages business bot r...
tgbotxx::Api::setStickerEmojiList
bool setStickerEmojiList(const std::string &sticker, const std::vector< std::string > &emojiList) const
Use this method to change the list of emoji assigned to a regular or custom emoji sticker....
tgbotxx::Api::unbanChatMember
bool unbanChatMember(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId, bool onlyIfBanned=false) const
Use this method to unban a previously banned user in a supergroup or channel. The user will not retur...
tgbotxx::Api::getWebhookInfo
Ptr< WebhookInfo > getWebhookInfo() const
Use this method to get current webhook status. Requires no parameters. On success,...
tgbotxx::Api::declineChatJoinRequest
bool declineChatJoinRequest(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId) const
Use this method to decline a chat join request. The bot must be an administrator in the chat for this...
tgbotxx::Api::getUserProfilePhotos
Ptr< UserProfilePhotos > getUserProfilePhotos(std::int64_t userId, std::int32_t offset=0, std::int32_t limit=100) const
Use this method to get a list of profile pictures for a user.
tgbotxx::Api::upgradeGift
bool upgradeGift(const std::string &businessConnectionId, const std::string &ownedGiftId, bool keepOriginalDetails=false, std::int32_t starCount=-1) const
Upgrades a given regular gift to a unique gift. Requires the can_transfer_and_upgrade_gifts business ...
tgbotxx::Api::getChat
Ptr< Chat > getChat(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to get up to date information about the chat (current name of the user for one-on-one...
tgbotxx::Api::setUrl
void setUrl(const std::string &url) noexcept
Set Api URL.
tgbotxx::Api::addStickerToSet
bool addStickerToSet(std::int64_t userId, const std::string &name, const Ptr< InputSticker > &sticker) const
Use this method to add a new sticker to a set created by the bot. The format of the added sticker mus...
tgbotxx::Api::setStickerMaskPosition
bool setStickerMaskPosition(const std::string &sticker, const Ptr< MaskPosition > &maskPosition=nullptr) const
Use this method to change the mask position of a mask sticker. The sticker must belong to a sticker s...
tgbotxx::Api::getUserChatBoosts
Ptr< UserChatBoosts > getUserChatBoosts(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId) const
Use this method to get the list of boosts added to a chat by a user. Requires administrator rights in...
tgbotxx::Api::sendVenue
Ptr< Message > sendVenue(const std::variant< std::int64_t, std::string > &chatId, float latitude, float longitude, const std::string &title, const std::string &address, std::int32_t messageThreadId=0, const std::string &foursquareId="", const std::string &foursquareType="", const std::string &googlePlaceId="", const std::string &googlePlaceType="", bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send information about a venue. On success, the sent Message is returned.
tgbotxx::Api::sendLocation
Ptr< Message > sendLocation(const std::variant< std::int64_t, std::string > &chatId, float latitude, float longitude, std::int32_t messageThreadId=0, float horizontalAccuracy=0.0f, std::int32_t livePeriod=0, std::int32_t heading=0, std::int32_t proximityAlertRadius=0, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send a point on the map. On success, the sent Message is returned.
tgbotxx::Api::setBusinessAccountGiftSettings
bool setBusinessAccountGiftSettings(const std::string &businessConnectionId, bool showGiftButton, const Ptr< AcceptedGiftTypes > &acceptedGiftTypes) const
Removes the current profile photo of a managed business account. Requires the can_edit_profile_photo ...
tgbotxx::Api::sendPaidMedia
Ptr< Message > sendPaidMedia(const std::variant< std::int64_t, std::string > &chatId, std::int32_t starCount, const std::vector< Ptr< InputPaidMedia > > &media, const std::string &payload="", std::int32_t messageThreadId=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), bool showCaptionAboveMedia=false, bool disableNotification=false, bool protectContent=false, bool allowPaidBroadcast=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send paid media. On success, an array of the sent Messages is returned.
tgbotxx::Api::banChatMember
bool banChatMember(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId, std::time_t untilDate=0, bool revokeMessages=false) const
Use this method to ban a user in a group, a supergroup or a channel. In the case of supergroups and c...
tgbotxx::Api::removeUserVerification
bool removeUserVerification(std::int64_t userId) const
Removes verification from a user who is currently verified on behalf of the organization represented ...
tgbotxx::Api::setMyShortDescription
bool setMyShortDescription(const std::string &shortDescription="", const std::string &languageCode="") const
Use this method to change the bot's short description, which is shown on the bot's profile page and i...
tgbotxx::Api::setGameScore
Ptr< Message > setGameScore(std::int64_t userId, std::int32_t score, bool force=false, bool disableEditMessage=false, std::int64_t chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="") const
Use this method to set the score of the specified user in a game message.
tgbotxx::Api::approveChatJoinRequest
bool approveChatJoinRequest(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId) const
Use this method to approve a chat join request. The bot must be an administrator in the chat for this...
tgbotxx::Api::getFile
Ptr< File > getFile(const std::string &fileId) const
Use this method to get basic information about a file and prepare it for downloading....
tgbotxx::Api::setMyCommands
bool setMyCommands(const std::vector< Ptr< BotCommand > > &commands, const Ptr< BotCommandScope > &scope=nullptr, const std::string &languageCode="") const
Use this method to change the list of the bot's commands. See this manual for more details about bot ...
tgbotxx::Api::editMessageMedia
Ptr< Message > editMessageMedia(const Ptr< InputMedia > &media, const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="") const
Use this method to edit animation, audio, document, photo, or video messages. If a message is part of...
tgbotxx::Api::stopMessageLiveLocation
Ptr< Message > stopMessageLiveLocation(const std::variant< std::int64_t, std::string > &chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="", const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="") const
Use this method to stop updating a live location message before livePeriod expires.
tgbotxx::Api::answerCallbackQuery
bool answerCallbackQuery(const std::string &callbackQueryId, const std::string &text="", bool showAlert=false, const std::string &url="", std::time_t cacheTime=0) const
Use this method to send answers to callback queries sent from inline keyboards. The answer will be di...
tgbotxx::Api::getUpdatesLimit
std::int32_t getUpdatesLimit() const noexcept
Get Set the number of long polling updates to be retrieved by getUpdates().
tgbotxx::Api::answerWebAppQuery
Ptr< SentWebAppMessage > answerWebAppQuery(const std::string &webAppQueryId, const Ptr< InlineQueryResult > &result) const
Use this method to set the result of an interaction with a Web App and send a corresponding message o...
tgbotxx::Api::getMe
Ptr< User > getMe() const
A simple method for testing your bot's authentication token.
tgbotxx::Api::getGameHighScores
std::vector< Ptr< GameHighScore > > getGameHighScores(std::int64_t userId, std::int64_t chatId=0, std::int32_t messageId=0, const std::string &inlineMessageId="") const
Use this method to get data for high score tables.
tgbotxx::Api::editStory
Ptr< Story > editStory(const std::string &businessConnectionId, std::int32_t storyId, const Ptr< InputStoryContent > &content, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), const std::vector< Ptr< StoryArea > > &areas=std::vector< Ptr< StoryArea > >()) const
Edits a story previously posted by the bot on behalf of a managed business account....
tgbotxx::Api::closeGeneralForumTopic
bool closeGeneralForumTopic(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to close an open 'General' topic in a forum supergroup chat. The bot must be an admin...
tgbotxx::Api::close
bool close() const
Use this method to close the bot instance before moving it from one local server to another....
tgbotxx::Api::sendVideoNote
Ptr< Message > sendVideoNote(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &videoNote, std::int32_t messageThreadId=0, std::time_t duration=0, std::int32_t length=0, const std::variant< std::monostate, cpr::File, std::string > &thumbnail=std::monostate{}, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send video notes. On success, the sent Message is returned. As of v....
tgbotxx::Api::sendInvoice
Ptr< Message > sendInvoice(const std::variant< std::int64_t, std::string > &chatId, const std::string &title, const std::string &description, const std::string &payload, const std::string &currency, const std::vector< Ptr< LabeledPrice > > &prices, const std::string &providerToken="", std::int32_t messageThreadId=0, std::int32_t maxTipAmount=0, const std::vector< std::int32_t > &suggestedTipAmounts=std::vector< std::int32_t >(), const std::string &startParameter="", const std::string &providerData="", const std::string &photoUrl="", std::int32_t photoSize=0, std::int32_t photoWidth=0, std::int32_t photoHeight=0, bool needName=false, bool needPhoneNumber=false, bool needEmail=false, bool needShippingAddress=false, bool sendPhoneNumberToProvider=false, bool sendEmailToProvider=false, bool isFlexible=false, bool disableNotification=false, bool protectContent=false, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< IReplyMarkup > &replyMarkup=nullptr) const
Use this method to send invoices.
tgbotxx::Api::forwardMessages
std::vector< Ptr< MessageId > > forwardMessages(const std::variant< std::int64_t, std::string > &chatId, const std::variant< std::int64_t, std::string > &fromChatId, const std::vector< std::int32_t > &messageIds, std::int32_t messageThreadId=0, bool disableNotification=false, bool protectContent=false, std::int32_t directMessagesTopicId=0) const
Use this method to forward multiple messages of any kind. If some of the specified messages can't be ...
tgbotxx::Api::setMyName
bool setMyName(const std::string &name="", const std::string &languageCode="") const
Use this method to change the bot's name.
tgbotxx::Api::reopenForumTopic
bool reopenForumTopic(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageThreadId) const
Use this method to reopen a closed topic in a forum supergroup chat. The bot must be an administrator...
tgbotxx::Api::editMessageChecklist
Ptr< Message > editMessageChecklist(std::int64_t chatId, std::int32_t messageId, const Ptr< InputChecklist > &checklist, const std::string &businessConnectionId, const Ptr< IReplyMarkup > &replyMarkup=nullptr) const
Use this method to edit a checklist on behalf of a connected business account. On success,...
tgbotxx::Api::sendVoice
Ptr< Message > sendVoice(const std::variant< std::int64_t, std::string > &chatId, const std::variant< cpr::File, std::string > &voice, std::int32_t messageThreadId=0, const std::string &caption="", const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &captionEntities=std::vector< Ptr< MessageEntity > >(), std::time_t duration=0, bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send audio files as voice messages. On success, the sent Message is returned.
tgbotxx::Api::setWebhook
bool setWebhook(const std::string &url, const std::optional< cpr::File > &certificate=std::nullopt, const std::string &ipAddress="", std::int32_t maxConnections=40, const std::vector< std::string > &allowedUpdates=std::vector< std::string >(), bool dropPendingUpdates=false, const std::string &secretToken="") const
Use this method to specify a URL and receive incoming updates via an outgoing webhook....
tgbotxx::Api::getConnectTimeout
cpr::ConnectTimeout getConnectTimeout() const noexcept
Get Api requests connection timeout.
tgbotxx::Api::sendMessage
Ptr< Message > sendMessage(const std::variant< std::int64_t, std::string > &chatId, const std::string &text, std::int32_t messageThreadId=0, const std::string &parseMode="", const std::vector< Ptr< MessageEntity > > &entities=std::vector< Ptr< MessageEntity > >(), bool disableNotification=false, bool protectContent=false, const Ptr< IReplyMarkup > &replyMarkup=nullptr, const std::string &businessConnectionId="", std::int32_t directMessagesTopicId=0, const Ptr< LinkPreviewOptions > &linkPreviewOptions=nullptr, bool allowPaidBroadcast=false, const std::string &messageEffectId="", const Ptr< SuggestedPostParameters > &suggestedPostParameters=nullptr, const Ptr< ReplyParameters > &replyParameters=nullptr) const
Use this method to send text messages. On success, the sent Message is returned.
tgbotxx::Api::setMessageReaction
bool setMessageReaction(const std::variant< std::int64_t, std::string > &chatId, std::int32_t messageId, const std::vector< Ptr< ReactionType > > &reaction=std::vector< Ptr< ReactionType > >(), bool isBig=false) const
Use this method to change the chosen reactions on a message. Service messages can't be reacted to....
tgbotxx::Api::deleteChatPhoto
bool deleteChatPhoto(const std::variant< std::int64_t, std::string > &chatId) const
Use this method to delete a chat photo. Photos can't be changed for private chats....
tgbotxx::Api::restrictChatMember
bool restrictChatMember(const std::variant< std::int64_t, std::string > &chatId, std::int64_t userId, const Ptr< ChatPermissions > &permissions, bool useIndependentChatPermissions=false, std::time_t untilDate=0) const
Use this method to restrict a user in a supergroup. The bot must be an administrator in the supergrou...
tgbotxx::Api::getMyStarBalance
Ptr< StarAmount > getMyStarBalance() const
A method to get the current Telegram Stars balance of the bot. Requires no parameters....
tgbotxx::Ptr
std::shared_ptr< T > Ptr
Definition Ptr.hpp:6
tgbotxx::AcceptedGiftTypes
This object describes the types of gifts that can be gifted to a user or a chat. https://core....
Definition AcceptedGiftTypes.hpp:8
tgbotxx::BotCommand
This object represents a bot command. https://core.telegram.org/bots/api#botcommand.
Definition BotCommand.hpp:8
tgbotxx::BotCommandScope
Base class of all bot commands scopes This object represents the scope to which bot commands are appl...
Definition BotCommandScope.hpp:15
tgbotxx::BotDescription
This object represents the bot's description. https://core.telegram.org/bots/api#botdescription.
Definition BotDescription.hpp:7
tgbotxx::BotName
This object represents the bot's name. https://core.telegram.org/bots/api#botname.
Definition BotName.hpp:7
tgbotxx::BotShortDescription
This object represents the bot's short description. https://core.telegram.org/bots/api#botshortdescri...
Definition BotShortDescription.hpp:7
tgbotxx::ChatAdministratorRights
Represents the rights of an administrator in a chat. https://core.telegram.org/bots/api#chatadministr...
Definition ChatAdministratorRights.hpp:7
tgbotxx::Chat
This object represents a chat. https://core.telegram.org/bots/api#chat.
Definition Chat.hpp:7
tgbotxx::ChatMember
The base class of all chat members objects. This object contains information about one member of a ch...
Definition ChatMember.hpp:15
tgbotxx::ChatPermissions
Describes actions that a non-administrator user is allowed to take in a chat. https://core....
Definition ChatPermissions.hpp:7
tgbotxx::File
This object represents a file ready to be downloaded.
Definition File.hpp:13
tgbotxx::ForumTopic
This object represents a forum topic. https://core.telegram.org/bots/api#forumtopic.
Definition ForumTopic.hpp:7
tgbotxx::GameHighScore
This object represents one row of the high scores table for a game. https://core.telegram....
Definition GameHighScore.hpp:8
tgbotxx::Gifts
This object represents a list of gifts. https://core.telegram.org/bots/api#gifts.
Definition Gifts.hpp:9
tgbotxx::IReplyMarkup
The interface of reply markup objects InlineKeyboardMarkup, ReplyKeyboardMarkup, ReplyKeyboardRemove ...
Definition IReplyMarkup.hpp:7
tgbotxx::InlineQueryResult
Base class of all inline query results This object represents one result of an inline query....
Definition InlineQueryResult.hpp:32
tgbotxx::InlineQueryResultsButton
This object represents a button to be shown above inline query results. You must use exactly one of t...
Definition InlineQueryResultsButton.hpp:9
tgbotxx::InputChecklist
Describes a checklist to create. https://core.telegram.org/bots/api#inputchecklist.
Definition InputChecklist.hpp:9
tgbotxx::InputMedia
This object represents the content of a media message to be sent. It should be one of:
Definition InputMedia.hpp:13
tgbotxx::InputPaidMedia
Base class describing paid media to send https://core.telegram.org/bots/api#inputpaidmedia.
Definition InputPaidMedia.hpp:10
tgbotxx::InputPollOption
This object contains information about one answer option in a poll to be sent. https://core....
Definition InputPollOption.hpp:8
tgbotxx::InputProfilePhoto
Base class for profile photos to set https://core.telegram.org/bots/api#inputprofilephoto.
Definition InputProfilePhoto.hpp:8
tgbotxx::InputSticker
This object describes a sticker to be added to a sticker set. https://core.telegram....
Definition InputSticker.hpp:10
tgbotxx::InputStoryContent
Base class for story content to post https://core.telegram.org/bots/api#inputstorycontentphoto.
Definition InputStoryContent.hpp:8
tgbotxx::LabeledPrice
This object represents a portion of the price for goods or services. https://core....
Definition LabeledPrice.hpp:7
tgbotxx::MaskPosition
This object describes the position on faces where a mask should be placed by default....
Definition MaskPosition.hpp:7
tgbotxx::MenuButton
This object describes the bot's menu button in a private chat. It should be one of:
Definition MenuButton.hpp:14
tgbotxx::MessageEntity
This object represents one special entity in a text message. For example, hashtags,...
Definition MessageEntity.hpp:8
tgbotxx::Message
This object represents a message. https://core.telegram.org/bots/api#message.
Definition Message.hpp:72
tgbotxx::MessageId
This object represents a unique message identifier. https://core.telegram.org/bots/api#messageid.
Definition MessageId.hpp:7
tgbotxx::OwnedGifts
Contains the list of gifts received and owned by a user or a chat. https://core.telegram....
Definition OwnedGifts.hpp:9
tgbotxx::PassportElementError
This object represents an error in the Telegram Passport element which was submitted that should be r...
Definition PassportElementError.hpp:17
tgbotxx::Poll
This object contains information about a poll. https://core.telegram.org/bots/api#poll.
Definition Poll.hpp:10
tgbotxx::ReactionType
This object describes the type of a reaction. Currently, it can be one of:
Definition ReactionType.hpp:9
tgbotxx::ReplyParameters
Describes reply parameters for the message that is being sent. https://core.telegram....
Definition ReplyParameters.hpp:8
tgbotxx::SentWebAppMessage
Describes an inline message sent by a Web App on behalf of a user. https://core.telegram....
Definition SentWebAppMessage.hpp:7
tgbotxx::ShippingOption
This object represents one shipping option. https://core.telegram.org/bots/api#shippingoption.
Definition ShippingOption.hpp:8
tgbotxx::StarAmount
Describes an amount of Telegram Stars. https://core.telegram.org/bots/api#staramount.
Definition StarAmount.hpp:7
tgbotxx::StarTransactions
Contains a list of Telegram Star transactions. https://core.telegram.org/bots/api#startransactions.
Definition StarTransactions.hpp:10
tgbotxx::Sticker
This object represents a sticker. https://core.telegram.org/bots/api#sticker.
Definition Sticker.hpp:10
tgbotxx::StickerSet
This object represents a sticker set. https://core.telegram.org/bots/api#stickerset.
Definition StickerSet.hpp:9
tgbotxx::StoryArea
Describes a clickable area on a story media https://core.telegram.org/bots/api#storyarea.
Definition StoryArea.hpp:10
tgbotxx::Story
This object represents a story. . https://core.telegram.org/bots/api#story.
Definition Story.hpp:8
tgbotxx::SuggestedPostParameters
Contains parameters of a post that is being suggested by the bot. https://core.telegram....
Definition SuggestedPostParameters.hpp:8
tgbotxx::Update
This object represents an incoming update. At most one of the optional parameters can be present in a...
Definition Update.hpp:27
tgbotxx::UserChatBoosts
This object represents a list of boosts added to a chat by a user. https://core.telegram....
Definition UserChatBoosts.hpp:9
tgbotxx::User
This object represents a Telegram user or bot. https://core.telegram.org/bots/api#user.
Definition User.hpp:7
tgbotxx::UserProfilePhotos
This object represent a user's profile pictures. https://core.telegram.org/bots/api#userprofilephotos...
Definition UserProfilePhotos.hpp:8
tgbotxx::WebhookInfo
Describes the current status of a webhook. https://core.telegram.org/bots/api#webhookinfo.
Definition WebhookInfo.hpp:7