推荐帖子

电报Telegram 为频道管理员提供了一个强大的盈利功能：推荐帖子。

suggestedPost#e8e37e5 flags:# accepted:flags.1?true rejected:flags.2?true price:flags.3?StarsAmount schedule_date:flags.0?int = SuggestedPost;draftMessage#96eaa5eb flags:# no_webpage:flags.1?true invert_media:flags.6?true reply_to:flags.4?InputReplyTo message:string entities:flags.3?Vector<MessageEntity> media:flags.5?InputMedia date:int effect:flags.7?long suggested_post:flags.8?SuggestedPost = DraftMessage;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;messageActionSuggestedPostApproval#ee7a1596 flags:# rejected:flags.0?true balance_too_low:flags.1?true reject_comment:flags.2?string schedule_date:flags.3?int price:flags.4?StarsAmount = MessageAction; messageActionSuggestedPostSuccess#95ddcf69 price:StarsAmount = MessageAction; messageActionSuggestedPostRefund#69f916f8 flags:# payer_initiated:flags.0?true = MessageAction;---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.toggleSuggestedPostApproval#8107455c flags:# reject:flags.1?true peer:InputPeer msg_id:int schedule_date:flags.0?int reject_comment:flags.2?string = Updates;

订阅者现在可以通过透明且自动化的界面，将内容作为建议帖子提交到他们喜欢的频道：只需使用suggestPost构造函数填充messages.sendMessage（或任何其他与发送消息相关的方法）suggested_post的标志，然后将消息发送到与频道关联的monoforum »即可。

在这种情况下，发送者只能（可选地）填充suggestPost的以下标志：

• price- 为推荐的帖子提供报酬（也可以免费推荐帖子，无需设置此标志）。如果已设置并在Stars
  中指定
  • 价格必须介于stars_suggested_post_amount_min和stars_suggested_post_amount_max之间。
  • 成功完成后，频道将获得price*stars_suggested_post_commission_permille/1000星星，请参阅 stars_suggested_post_commission_permille »。
    如果设置并以纳吨（toncoin）为单位指定：
  • 价格必须介于ton_suggested_post_amount_min和ton_suggested_post_amount_max之间。
  • 成功完成后，该通道将获得price*ton_suggested_post_commission_permille/1000纳吨，请参阅 ton_suggested_post_commission_permille »。
• schedule_date- 指定消息的发布时间（可选，如果消息可以随时发布，则可以省略）；在这种情况下，消息经批准后将自动安排发布时间。如果指定了此值，则允许的范围为未来秒数stars_suggested_post_future_min和stars_suggested_post_future_max
  之间。

频道管理员（或用户本人，如果是频道向用户推荐的帖子；无论如何，对于付费推荐帖子，始终是用户向频道付费，反之则不然）可以选择：

• 接受建议的帖子，方法是调用`messages.toggleSuggestedPostApproval` ，仅设置`<command>` 和 `<command>`peer，msg_id并可选择性地设置 `<command>`schedule_date来修改发布日期。
  这将发出一条`messageActionSuggestedPostApproval`服务消息来回复建议（如果该建议未被删除），其中 `<command>`schedule_date和 `price<command>` 标志已正确填充，而`<command>reject` 标志未设置。
  如果用户的余额不足以支付建议的价格，则该帖子将不会被安排/发布，直到用户的余额中增加足够的星星为止。此时，将发出一条`messageActionSuggestedPostApproval`服务消息来回复建议（如果该建议未被删除），其中 `<command>`balance_too_low和 `price<command>` 标志已填充，而 `reject<command>` 标志未设置。
  一旦用户的余额中增加了更多星星，负责审批的人员必须重新调用`messages.toggleSuggestedPostApproval`。

  频道将在帖子在频道上发布后，按照stars_suggested_post_age_min 客户端配置参数中指定的秒数（即从帖子实际发布时开始，而不是从添加到调度队列时开始）收到付款（对于付费建议帖子）：如果帖子在规定的秒数之前被删除，则会发出messageActionSuggestedPostRefund ，并且不会设置任何标志来回复建议（如果帖子未被删除）。

  如果付款人退还了用于支付帖子费用的星星的款项，则会发出带有该标志的messageActionSuggestedPostRefund。payer_initiated

  如果一切顺利，经过上述指定时间后，将发出messageActionSuggestedPostSuccess 。

• 如需修改价格、消息内容或发布日期，请回复消息并根据需要进行调整；同时，必须将相同或修改后的suggestPost构造函数传递给该函数suggested_post。
  在这种情况下，接收方将决定接受、请求修改或拒绝建议的帖子，流程与频道管理员之前使用的流程相同（如果需要进一步修改，则再次轮到频道处理，依此类推）。
  请注意，频道也可能在用户未提出任何建议的情况下（即不回复用户建议的帖子）向用户推荐帖子。

• 调用`messages.toggleSuggestedPostApproval`函数，仅peer设置`--reject`、msg_id`--reject` 和reject可选的reject_comment`--reject` 参数，即可拒绝建议的帖子。
  这将向建议发送一条 `messageActionSuggestedPostApproval`服务消息作为回复（如果建议未被删除），其中 `--reject`rejected和 `reject_comment--reject` 参数会相应地填充。

accepted/rejected/schedule_date已批准/已拒绝的建议帖子的标记将在消息历史记录中相应更新。

一旦发布，建议的频道帖子将设置消息“.”paid_suggested_post_stars或消息“.”paid_suggested_post_ton标志，表明指定的帖子是使用 Telegram Stars 或 toncoin（以纳诺顿为单位）支付的建议帖子。