tgbot-cpp
Loading...
Searching...
No Matches
TgBot::SendAudioArgs Struct Reference

Arguments for Api::sendAudio. More...

#include <Types.h>

Public Attributes

std::variant< std::int64_t, std::string > chatId { }
 Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username.
std::variant< std::shared_ptr< InputFile >, std::string > audio { }
 Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »
std::string caption = ""
 Audio caption, 0-1024 characters after entities parsing.
std::int32_t duration = 0
 Duration of the audio in seconds.
std::string performer = ""
 Performer.
std::string title = ""
 Track name.
std::variant< std::shared_ptr< InputFile >, std::string > thumbnail = { }
 Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »
std::shared_ptr< ReplyParameters > replyParameters = nullptr
 Description of the message to reply to.
std::variant< std::shared_ptr< InlineKeyboardMarkup >, std::shared_ptr< ReplyKeyboardMarkup >, std::shared_ptr< ReplyKeyboardRemove >, std::shared_ptr< ForceReply > > replyMarkup = { }
 Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user.
std::string parseMode = ""
 Mode for parsing entities in the audio caption. See formatting options for more details.
bool disableNotification = false
 Sends the message silently. Users will receive a notification with no sound.
std::vector< std::shared_ptr< MessageEntity > > captionEntities = { }
 A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode.
std::int32_t messageThreadId = 0
 Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only.
bool protectContent = false
 Protects the contents of the sent message from forwarding and saving.
std::string businessConnectionId = ""
 Unique identifier of the business connection on behalf of which the message will be sent.
bool allowPaidBroadcast = false
 Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.
std::string callbackQueryId = ""
 Identifier of the callback query which triggered the ephemeral message.
std::int64_t directMessagesTopicId = 0
 Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat.
std::string messageEffectId = ""
 Unique identifier of the message effect to be added to the message; for private chats only.
std::int64_t receiverUserId = 0
 Identifier of the user who will receive the ephemeral message.
std::shared_ptr< SuggestedPostParameters > suggestedPostParameters = nullptr
 A JSON-serialized object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined.
std::shared_ptr< EphemeralMessageParameters > ephemeralMessageParameters = nullptr
 A JSON-serialized object containing the parameters of the ephemeral message to send.

Detailed Description

Arguments for Api::sendAudio.

Definition at line 17605 of file Types.h.

Member Data Documentation

◆ allowPaidBroadcast

bool TgBot::SendAudioArgs::allowPaidBroadcast = false

Pass True to allow up to 1000 messages per second, ignoring broadcasting limits for a fee of 0.1 Telegram Stars per message. The relevant Stars will be withdrawn from the bot's balance.

Definition at line 17707 of file Types.h.

◆ audio

std::variant<std::shared_ptr<InputFile>, std::string> TgBot::SendAudioArgs::audio { }

Audio file to send. Pass a file_id as String to send an audio file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an audio file from the Internet, or upload a new one using multipart/form-data. More information on Sending Files »

Definition at line 17618 of file Types.h.

◆ businessConnectionId

std::string TgBot::SendAudioArgs::businessConnectionId = ""

Unique identifier of the business connection on behalf of which the message will be sent.

Definition at line 17700 of file Types.h.

◆ callbackQueryId

std::string TgBot::SendAudioArgs::callbackQueryId = ""

Identifier of the callback query which triggered the ephemeral message.

Definition at line 17712 of file Types.h.

◆ caption

std::string TgBot::SendAudioArgs::caption = ""

Audio caption, 0-1024 characters after entities parsing.

Definition at line 17623 of file Types.h.

◆ captionEntities

std::vector<std::shared_ptr<MessageEntity> > TgBot::SendAudioArgs::captionEntities = { }

A JSON-serialized list of special entities that appear in the caption, which can be specified instead of parse_mode.

Definition at line 17682 of file Types.h.

◆ chatId

std::variant<std::int64_t, std::string> TgBot::SendAudioArgs::chatId { }

Unique identifier for the target chat or username of the target bot, supergroup or channel in the format @username.

Definition at line 17610 of file Types.h.

◆ directMessagesTopicId

std::int64_t TgBot::SendAudioArgs::directMessagesTopicId = 0

Identifier of the direct messages topic to which the message will be sent; required if the message is sent to a direct messages chat.

Definition at line 17718 of file Types.h.

◆ disableNotification

bool TgBot::SendAudioArgs::disableNotification = false

Sends the message silently. Users will receive a notification with no sound.

Definition at line 17676 of file Types.h.

◆ duration

std::int32_t TgBot::SendAudioArgs::duration = 0

Duration of the audio in seconds.

Definition at line 17628 of file Types.h.

◆ ephemeralMessageParameters

std::shared_ptr<EphemeralMessageParameters> TgBot::SendAudioArgs::ephemeralMessageParameters = nullptr

A JSON-serialized object containing the parameters of the ephemeral message to send.

Definition at line 17743 of file Types.h.

◆ messageEffectId

std::string TgBot::SendAudioArgs::messageEffectId = ""

Unique identifier of the message effect to be added to the message; for private chats only.

Definition at line 17724 of file Types.h.

◆ messageThreadId

std::int32_t TgBot::SendAudioArgs::messageThreadId = 0

Unique identifier for the target message thread (topic) of a forum; for forum supergroups and private chats of bots with forum topic mode enabled only.

Definition at line 17689 of file Types.h.

◆ parseMode

std::string TgBot::SendAudioArgs::parseMode = ""

Mode for parsing entities in the audio caption. See formatting options for more details.

Definition at line 17670 of file Types.h.

◆ performer

std::string TgBot::SendAudioArgs::performer = ""

Performer.

Definition at line 17633 of file Types.h.

◆ protectContent

bool TgBot::SendAudioArgs::protectContent = false

Protects the contents of the sent message from forwarding and saving.

Definition at line 17694 of file Types.h.

◆ receiverUserId

std::int64_t TgBot::SendAudioArgs::receiverUserId = 0

Identifier of the user who will receive the ephemeral message.

Definition at line 17729 of file Types.h.

◆ replyMarkup

std::variant<std::shared_ptr<InlineKeyboardMarkup>, std::shared_ptr<ReplyKeyboardMarkup>, std::shared_ptr<ReplyKeyboardRemove>, std::shared_ptr<ForceReply> > TgBot::SendAudioArgs::replyMarkup = { }

Additional interface options. A JSON-serialized object for an inline keyboard, custom reply keyboard, instructions to remove a reply keyboard or to force a reply from the user.

Definition at line 17664 of file Types.h.

◆ replyParameters

std::shared_ptr<ReplyParameters> TgBot::SendAudioArgs::replyParameters = nullptr

Description of the message to reply to.

Definition at line 17655 of file Types.h.

◆ suggestedPostParameters

std::shared_ptr<SuggestedPostParameters> TgBot::SendAudioArgs::suggestedPostParameters = nullptr

A JSON-serialized object containing the parameters of the suggested post to send; for direct messages chats only. If the message is sent as a reply to another suggested post, then that suggested post is automatically declined.

Definition at line 17737 of file Types.h.

◆ thumbnail

std::variant<std::shared_ptr<InputFile>, std::string> TgBot::SendAudioArgs::thumbnail = { }

Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>. More information on Sending Files »

Definition at line 17650 of file Types.h.

◆ title

std::string TgBot::SendAudioArgs::title = ""

Track name.

Definition at line 17638 of file Types.h.


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