msg Instance¶

The message you're replying to — with helper methods baked in so you don't pass chat_id and message_id on every line.

Read msg.text, reply with msg.reply(), edit with msg.editText(). The boring IDs are already filled in.

What is msg?¶

msg is the current Telegram message with built-in helper methods. Read message fields directly (msg.text, msg.photo) and act on the message without passing chat_id or message_id every time.

How to use it¶

Drop this in any command's Logic field (when msg is available):

await msg.reply("Got it!")
await msg.editText("Updated.")
await msg.react("👍")

Three things worth knowing upfront:

1. Check msg before calling methods — it's null for callbacks, webhooks, and webapps.
2. Reply methods auto-set reply_to_message_id — edits and deletes auto-set chat_id and message_id.
3. Default parse mode is Markdown for shorthand syntax — override per call if needed.

When msg is available¶

Always check before calling methods:

if (!msg) return
await msg.reply("Hello!")

Try it — copy-paste examples¶

Start simple. Each example only introduces what it needs.

Reply to the user's message¶

if (!msg) return
await msg.reply("Hi " + user.first_name + "!")

Read message content¶

let body = msg.text || msg.caption
if (!body) {
  return await msg.reply("Send me some text!")
}
await msg.reply("You said: " + body)

Edit your reply after sending¶

await msg.sendChatAction("typing")
await sleep(1)

let sent = await msg.reply("You said: " + msg.getText())
await sent.react("👍")

Full Telegram API params¶

Every helper accepts shorthand strings or a full params object:

await msg.reply({
  text: "Pick one:",
  parse_mode: "HTML",
  reply_markup: { inline_keyboard: [[{ text: "OK", callback_data: "/ok" }]] }
})

For callback buttons, use Api method chaining instead — see Method Chaining.

What msg contains¶

msg is the raw Telegram Message object plus helper methods attached on top:

Two call styles¶

Every helper accepts string arguments (shorthand) or a full params object (Telegram API format):

// Shorthand — chat_id and reply_to_message_id filled automatically
await msg.reply("Hello!", { parse_mode: "HTML" })

// Full object — pass any Telegram sendMessage param
await msg.reply({
  text: "Hello!",
  parse_mode: "HTML",
  reply_markup: { inline_keyboard: [[{ text: "OK", callback_data: "/ok" }]] }
})

Reply methods automatically set reply_to_message_id to the current message. Edit/delete/pin methods automatically set chat_id and message_id.

Default parse mode¶

Text replies and edits default to parse_mode: "Markdown" when using shorthand syntax. Override per call:

await msg.reply("**bold**", { parse_mode: "HTML" })
await msg.editText("Updated", { parse_mode: "MarkdownV2" })

Short aliases¶

Every method has short aliases. All names are case-insensitive:

await msg.r("Quick reply")
await msg.photo("https://example.com/img.jpg", { caption: "Photo" })

msg vs other variables¶

Rate limit¶

msg methods share a rate limit of 10 calls per second (same bucket as the underlying Api calls they wrap).

Pages in this section¶