Actions¶

Delete, pin, react, forward, copy, and send chat actions on the current message or chat. Side effects without sending a new message.

await msg.delete()
await msg.react("👍")
await msg.pin()
await msg.forward(user.id)

Delete¶

delete(messageId?) — alias: del, remove¶

Delete a message in the current chat. Defaults to the current message.

await msg.delete()              // delete the message that triggered the command
await msg.delete(msg.message_id) // same — explicit id
await msg.del(otherMessageId)   // delete a different message in this chat

Reactions¶

react(emoji, isBig?) — alias: reaction¶

Add an emoji reaction to the current message:

await msg.react("👍")
await msg.react("🔥", true)   // large animation
await msg.reaction("❤️")

removeReaction(options?) — alias: unreact¶

Remove the bot's reaction from the current message:

await msg.removeReaction()
await msg.unreact()

Pin and unpin¶

pin(disableNotification?)¶

Pin the current message in the chat:

await msg.pin()           // with notification
await msg.pin(true)       // silently

Requires bot admin rights with can_pin_messages in groups.

unpin(messageId?)¶

Unpin a message. Defaults to the current message:

await msg.unpin()
await msg.unpin(specificMessageId)

Forward and copy¶

forward(toChatId, options?) — alias: fwd¶

Forward the current message to another chat:

await msg.forward(user.id)
await msg.fwd(chat.id, { disable_notification: true })

copy(toChatId, options?) — alias: cp¶

Copy (send without forward header) to another chat:

await msg.copy(user.id)
await msg.cp(chat.id, { caption: "Copied for you" })

Chat actions¶

sendChatAction(action, options?) — alias: action, typing¶

Show a status indicator in the chat:

await msg.sendChatAction("typing")
await msg.typing()
await msg.action("upload_photo")

Chat actions expire after ~5 seconds. Send again for longer operations.

await msg.sendChatAction("typing")
await sleep(2)
await msg.reply("Here's the answer...")

Business messages¶

read(options?) — alias: markRead, markAsRead¶

Mark the current business message as read. Only works when msg.isBusiness() is true.

if (msg.isBusiness()) {
  await msg.read()
}

Throws read is only available for business messages on normal messages.

Method reference¶

Try it — copy-paste examples¶

Self-destructing command response¶

let notice = await msg.reply("Processing...")
// ... do work ...
await notice.delete()
await msg.reply("Done!")

Forward user message to admin¶

let adminId = process.env.ADMIN_CHAT_ID
await msg.forward(adminId)
await msg.reply("Reported to admin.")

React to confirm¶

await msg.react("✅")
await msg.reply("Marked as complete.")

Typing indicator during slow work¶

await msg.sendChatAction("typing")
let result = await HTTP.get("https://api.example.com/data")
await msg.reply("Result: " + result.data.value)

Notes¶

• delete() can remove the triggering message or any message in the same chat (with permission)
• Reactions require Telegram Premium in some private chat contexts
• forward shows "Forwarded from" header; copy does not
• Rate limit: 10 msg method calls per second
• For actions on messages sent via Api, use method chaining on the returned object

See also¶

• Replying
• Editing
• Message Data