1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165
use super::base::{Request, TelegramMethod};
use crate::{
client::Bot,
types::{ChatIdKind, MessageId},
};
use serde::Serialize;
use serde_with::skip_serializing_none;
/// Use this method to copy messages of any kind. If some of the specified messages can't be found or copied, they are skipped. Service messages, giveaway messages, giveaway winners messages, and invoice messages can't be copied. A quiz [`poll`](crate::types::Poll) can be copied only if the value of the field `correct_option_id` is known to the bot. The method is analogous to the method [`ForwardMessages`](crate::methods::ForwardMessages), but the copied messages don't have a link to the original message. Album grouping is kept for copied messages.
/// # Documentation
/// <https://core.telegram.org/bots/api#copymessages>
/// # Returns
/// On success, an array of [`MessageId`] of the sent messages is returned.
#[skip_serializing_none]
#[derive(Debug, Clone, Hash, PartialEq, Eq, Serialize)]
pub struct CopyMessages {
/// Unique identifier for the target chat or username of the target channel (in the format `@channelusername`)
pub chat_id: ChatIdKind,
/// Unique identifier for the target message thread (topic) of the forum; for forum supergroups only
pub message_thread_id: Option<i64>,
/// Unique identifier for the chat where the original messages were sent (or channel username in the format `@channelusername`)
pub from_chat_id: ChatIdKind,
/// MIdentifiers of 1-100 messages in the chat `from_chat_id` to copy. The identifiers must be specified in a strictly increasing order.
pub message_ids: Vec<i64>,
/// Sends the messages [silently](https://telegram.org/blog/channels-2-0#silent-messages). Users will receive a notification with no sound
pub disable_notification: Option<bool>,
/// Protects the contents of the sent messages from forwarding and saving
pub protect_content: Option<bool>,
/// Pass `true` to copy the messages without their captions
pub remove_caption: Option<bool>,
}
impl CopyMessages {
#[must_use]
pub fn new(
chat_id: impl Into<ChatIdKind>,
from_chat_id: impl Into<ChatIdKind>,
message_ids: impl IntoIterator<Item = i64>,
) -> Self {
Self {
chat_id: chat_id.into(),
message_thread_id: None,
from_chat_id: from_chat_id.into(),
message_ids: message_ids.into_iter().collect(),
disable_notification: None,
protect_content: None,
remove_caption: None,
}
}
#[must_use]
pub fn chat_id(self, val: impl Into<ChatIdKind>) -> Self {
Self {
chat_id: val.into(),
..self
}
}
#[must_use]
pub fn message_thread_id(self, val: i64) -> Self {
Self {
message_thread_id: Some(val),
..self
}
}
#[must_use]
pub fn from_chat_id(self, val: impl Into<ChatIdKind>) -> Self {
Self {
from_chat_id: val.into(),
..self
}
}
#[must_use]
pub fn message_id(self, val: i64) -> Self {
Self {
message_ids: self.message_ids.into_iter().chain(Some(val)).collect(),
..self
}
}
#[must_use]
pub fn message_ids(self, val: impl IntoIterator<Item = i64>) -> Self {
Self {
message_ids: self.message_ids.into_iter().chain(val).collect(),
..self
}
}
#[must_use]
pub fn disable_notification(self, val: bool) -> Self {
Self {
disable_notification: Some(val),
..self
}
}
#[must_use]
pub fn protect_content(self, val: bool) -> Self {
Self {
protect_content: Some(val),
..self
}
}
#[must_use]
pub fn remove_caption(self, val: bool) -> Self {
Self {
remove_caption: Some(val),
..self
}
}
}
impl CopyMessages {
#[must_use]
pub fn message_thread_id_option(self, val: Option<i64>) -> Self {
Self {
message_thread_id: val,
..self
}
}
#[must_use]
pub fn disable_notification_option(self, val: Option<bool>) -> Self {
Self {
disable_notification: val,
..self
}
}
#[must_use]
pub fn protect_content_option(self, val: Option<bool>) -> Self {
Self {
protect_content: val,
..self
}
}
#[must_use]
pub fn remove_caption_option(self, val: Option<bool>) -> Self {
Self {
remove_caption: val,
..self
}
}
}
impl TelegramMethod for CopyMessages {
type Method = Self;
type Return = Vec<MessageId>;
fn build_request<Client>(&self, _bot: &Bot<Client>) -> Request<Self::Method> {
Request::new("copyMessages", self, None)
}
}
impl AsRef<CopyMessages> for CopyMessages {
fn as_ref(&self) -> &Self {
self
}
}