Struct grammers_client::types::input_message::InputMessage

source · [−]

pub struct InputMessage { /* private fields */ }

Expand description

Construct and send rich text messages with various options.

Implementations

source

impl InputMessage

source

pub fn background(self, background: bool) -> Self

Whether to “send this message as a background message”.

This description is taken from https://core.telegram.org/method/messages.sendMessage.

source

pub fn clear_draft(self, clear_draft: bool) -> Self

Whether the draft in this chat, if any, should be cleared.

source

pub fn fmt_entities(self, entities: Vec<MessageEntity>) -> Self

The formatting entities within the message (such as bold, italics, etc.).

source

pub fn link_preview(self, link_preview: bool) -> Self

Whether the link preview be shown for the message.

This has no effect when sending media, which cannot contain a link preview.

source

pub fn reply_markup<RM: ReplyMarkup>(self, markup: &RM) -> Self

Defines the suggested reply markup for the message (such as adding inline buttons). This will be displayed below the message.

Only bot accounts can make use of the reply markup feature (a user attempting to send a message with a reply markup will result in the markup being ignored by Telegram).

The user is free to ignore the markup and continue sending usual text messages.

See crate::reply_markup for the different available markups along with how they behave.

source

pub fn reply_to(self, reply_to: Option<i32>) -> Self

The message identifier to which this message should reply to, if any.

Otherwise, this message will not be a reply to any other.

source

pub fn schedule_date(self, schedule_date: Option<SystemTime>) -> Self

If set to a distant enough future time, the message won’t be sent immediately, and instead it will be scheduled to be automatically sent at a later time.

This scheduling is done server-side, and may not be accurate to the second.

Bot accounts cannot schedule messages.

source

pub fn schedule_once_online(self) -> Self

Schedule the message to be sent once the person comes online.

This only works in private chats, and only if the person has their last seen visible.

Bot accounts cannot schedule messages.

source

pub fn silent(self, silent: bool) -> Self

Whether the message should notify people or not.

Defaults to false, which means it will notify them. Set it to true to alter this behaviour.

source

pub fn photo(self, file: Uploaded) -> Self

Include the uploaded file as a photo in the message.

The Telegram server will compress the image and convert it to JPEG format if necessary.

The text will be the caption of the photo, which may be empty for no caption.

source

pub fn photo_url(self, url: impl Into<String>) -> Self

Include an external photo in the message.

The Telegram server will download and compress the image and convert it to JPEG format if necessary.

The text will be the caption of the photo, which may be empty for no caption.

source

pub fn document(self, file: Uploaded) -> Self

Include the uploaded file as a document in the message.

You can use this to send videos, stickers, audios, or uncompressed photos.

The text will be the caption of the document, which may be empty for no caption.

source

pub fn document_url(self, url: impl Into<String>) -> Self

Include an external file as a document in the message.

You can use this to send videos, stickers, audios, or uncompressed photos.

The Telegram server will be the one that downloads and includes the document as media.

The text will be the caption of the document, which may be empty for no caption.

source

pub fn attribute(self, attr: Attribute) -> Self

Add additional attributes to the message.

This must be called after setting a file.

Examples

use std::time::Duration;
use grammers_client::{types::Attribute, InputMessage};

let message = InputMessage::text("").document(audio).attribute(
   Attribute::Audio {
       duration: Duration::new(123, 0),
       title: Some("Hello".to_string()),
       performer: Some("World".to_string()),
   }
);