unpinChatMessage()
Use this method to remove a message from the list of pinned messages in a chat. In private chats and channel direct messages chats, all messages can be unpinned. Conversely, the bot must be an administrator with the 'can_pin_messages' right or the 'can_edit_messages' right to unpin messages in groups and channels respectively. Returns True on success.
parameters
| parameter | type | required | description |
|---|---|---|---|
business_connection_id | string | optional | Unique identifier of the business connection on behalf of which the message will be unpinned |
chat_id | number | string | required | Unique identifier for the target chat or username of the target channel in the format @username |
message_id | number | optional | Identifier of the message to unpin. Required if business_connection_id is specified. If not specified, the most recent pinned message (by sending date) will be unpinned. |
returns
boolean
usage in yaebal
not (yet) hard-typed on Api — call it through the generic .call<T>() escape hatch documented in @yaebal/types.
import type { UnpinChatMessageParams } from "@yaebal/types";
await bot.api.call<boolean>("unpinChatMessage", {
chat_id: 123456789,
} satisfies UnpinChatMessageParams);context shortcut
also available as ctx.unpin() on
16
context types — see @yaebal/contexts.
/** Use this method to remove a message from the list of pinned messages in a chat. In private chats and channel direct messages chats, all messages can be unpinned. Conversely, the bot must be an administrator with the 'can_pin_messages' right or the 'can_edit_messages' right to unpin messages in groups and channels respectively. Returns *True* on success. */
ctx.unpin(params: Omit<UnpinChatMessageParams, "chat_id" | "message_id">)official Bot API docs: https://core.telegram.org/bots/api/#unpinchatmessage