pin_chat_message

template<class Agent>
api_result<boolean_t, Agent&&> pin_chat_message(Agent &&agent, pin_chat_message_args_t args)
template<class Agent, class F>
void pin_chat_message(Agent &&agent, pin_chat_message_args_t args, F &&callback)

agent is any object satisfying agent concept.

callback is any callable object accepting expected<boolean_t>.

Use this method to add a message to the list of pinned messages in a chat. If the chat is not a private chat, the bot must be an administrator in the chat for this to work and must have the ‘can_pin_messages’ administrator right in a supergroup or ‘can_edit_messages’ administrator right in a channel. Returns True on success.

struct pin_chat_message_args_t

Arguments that should be passed to pin_chat_message().

variant_t<integer_t, string_t> chat_id

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

integer_t message_id

Identifier of a message to pin

optional_t<boolean_t> disable_notification

Pass True if it is not necessary to send a notification to all chat members about the new pinned message. Notifications are always disabled in channels and private chats.