定时消息

Telegram 允许定时发送消息。

message#9815cec8 flags:# out:flags.1?true mentioned:flags.4?true media_unread:flags.5?true silent:flags.13?true post:flags.14?true from_scheduled:flags.18?true legacy:flags.19?true edit_hide:flags.21?true pinned:flags.24?true noforwards:flags.26?true invert_media:flags.27?true flags2:# offline:flags2.1?true video_processing_pending:flags2.4?true paid_suggested_post_stars:flags2.8?true paid_suggested_post_ton:flags2.9?true id:int from_id:flags.8?Peer from_boosts_applied:flags.29?int peer_id:Peer saved_peer_id:flags.28?Peer fwd_from:flags.2?MessageFwdHeader via_bot_id:flags.11?long via_business_bot_id:flags2.0?long reply_to:flags.3?MessageReplyHeader date:int message:string media:flags.9?MessageMedia reply_markup:flags.6?ReplyMarkup entities:flags.7?Vector<MessageEntity> views:flags.10?int forwards:flags.10?int replies:flags.23?MessageReplies edit_date:flags.15?int post_author:flags.16?string grouped_id:flags.17?long reactions:flags.20?MessageReactions restriction_reason:flags.22?Vector<RestrictionReason> ttl_period:flags.25?int quick_reply_shortcut_id:flags.30?int effect:flags2.2?long factcheck:flags2.3?FactCheck report_delivery_until_date:flags2.5?int paid_message_stars:flags2.6?long suggested_post:flags2.7?SuggestedPost = Message;updateNewScheduledMessage#39a51dfb message:Message = Update; updateDeleteScheduledMessages#f2a71983 flags:# peer:Peer messages:Vector<int> sent_messages:flags.0?Vector<int> = Update;---functions---messages.sendMessage#fe05dc9a flags:# no_webpage:flags.1?true silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long suggested_post:flags.22?SuggestedPost = Updates;messages.sendMedia#ac55d9c1 flags:# silent:flags.5?true background:flags.6?true clear_draft:flags.7?true noforwards:flags.14?true update_stickersets_order:flags.15?true invert_media:flags.16?true allow_paid_floodskip:flags.19?true peer:InputPeer reply_to:flags.0?InputReplyTo media:InputMedia message:string random_id:long reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.10?int send_as:flags.13?InputPeer quick_reply_shortcut:flags.17?InputQuickReplyShortcut effect:flags.18?long allow_paid_stars:flags.21?long suggested_post:flags.22?SuggestedPost = Updates;

要安排发送消息，只需在messages.sendMessage或messages.sendMediaschedule_date的标志中提供一个未来的 Unix 时间即可。

指定的消息或媒体文件将被添加到当前聊天的服务器端调度队列中，并在指定时间自动发送。
该方法调用会生成以下更新：

• 立即执行updateNewScheduledMessage，其中包含一条消息，该消息的 ID 等于当前聊天的调度队列中的消息 ID（每个 PM、聊天、超级群组和频道都有自己的调度队列和 ID 序列），并且date等于schedule_date。
• 在 时schedule_date，会发出一个设置了标志的updateNewMessage或updateNewChannelMessagefrom_scheduled，向发送者指示指定的计划消息已发送。
• 在`updateDeleteScheduledMessages`schedule_date事件中，表示消息已从调度队列中清除。`scheduledMessages`字段将包含已发送消息的调度消息 ID（最初在`updateNewScheduledMessage`事件中返回），而 `scheduledMessages` 字段将包含已发送消息的实际消息 ID。给定消息的调度消息 ID 和实际消息 ID 将位于同一向量索引处，分别位于 `scheduledMessages`和 `scheduledMessages`中。
  messagessent_messages
  messagessent_messages

如果schedule_date距离未来不到 10 秒，则立即发送消息，生成正常的updateNewMessage/updateNewChannelMessage。

注意：即使是未安排的视频，向大型频道发送也会自动触发服务器端处理（即生成替代质量，这些质量将包含在最终的消息媒体文档中）alt_document。

这些消息不会立即发送，而是像计划消息一样添加到计划队列中，但也有一些区别：

• 立即执行updateNewScheduledMessage，其中包含一条消息，该消息的 ID 等于当前聊天的计划队列中的消息 ID（每个 PM、聊天、超级群组和频道都有自己的计划队列和 ID 序列），标志video_processing_pending设置为date估计的转换日期（而不是计划日期）。
• 大约在 时date，会发送一个设置了标志的updateNewMessage或updateNewChannelMessagefrom_scheduled，向发送者指示已发送了带有待处理视频的指定消息。
• 大约在某个时刻date，会执行`updateDeleteScheduledMessages`操作，表明消息已从调度队列中清除。
  该messages字段将包含已发送消息的调度消息 ID（最初在`updateNewScheduledMessage`中返回），以及sent_messages已发送消息的实际消息 ID。
  给定消息的调度消息 ID 和实际消息 ID 将位于同一向量索引处，分别位于 `updateNewScheduledMessages`messages和 `updateNewScheduledMessages`中sent_messages。

操作调度队列

updateNewScheduledMessage#39a51dfb message:Message = Update; updateDeleteScheduledMessages#f2a71983 flags:# peer:Peer messages:Vector<int> sent_messages:flags.0?Vector<int> = Update;---functions---messages.getScheduledHistory#f516760b peer:InputPeer hash:long = messages.Messages; messages.getScheduledMessages#bdbb0464 peer:InputPeer id:Vector<int> = messages.Messages; messages.sendScheduledMessages#bd38850a peer:InputPeer id:Vector<int> = Updates; messages.deleteScheduledMessages#59ae2b16 peer:InputPeer id:Vector<int> = Updates;messages.editMessage#dfd14005 flags:# no_webpage:flags.1?true invert_media:flags.16?true peer:InputPeer id:int message:flags.11?string media:flags.14?InputMedia reply_markup:flags.2?ReplyMarkup entities:flags.3?Vector<MessageEntity> schedule_date:flags.15?int quick_reply_shortcut_id:flags.17?int = Updates;

客户可以通过提供从updateNewScheduledMessage获取的计划消息 ID，手动编辑特定聊天的计划队列。

• messages.getScheduledHistory获取指定聊天中调度队列中的所有消息
• messages.getScheduledMessages获取指定聊天中调度队列中特定消息的信息
• messages.sendScheduledMessages会将消息从调度队列中清除，并立即发送它们。
• messages.deleteScheduledMessages从计划队列中删除消息，但不发送它们。
• messages.editMessage可用于修改计划队列中特定消息的计划日期。

修改计划消息会生成一个具有相同 ID 和更新信息的updateNewScheduledMessage 事件
。 删除计划消息会生成一个updateDeleteScheduledMessage 事件。