Sending Messages¶

The bread and butter of every bot: sending stuff to the chat. Bot gives you shorthand methods for text, keyboards, and media — all auto-targeted to the current chat. No chat_id required. Less typing, more chatting.

For inline buttons, message edits, and other Telegram power moves, see Api. Bot is your fast lane for everyday output.

What can Bot send?¶

All send methods use the current chat from command context. Method names are case-sensitive — Bot.sendMessage works, Bot.sendmessage does not. The universe is cruel but consistent.

How to use it¶

Text messages¶

Simplest possible send:

Bot.sendMessage("Hello!")

Defaults to parse_mode: "Markdown". Keep formatting simple — unclosed * or _ markers are the #1 reason messages fail to send.

Object format works too:

Bot.sendMessage({ text: "Hello!" })

Custom parse mode or no formatting at all:

await Bot.sendMessage("Hello friend", { parse_mode: "HTML" })

// Literal asterisks — no Markdown interpretation
Bot.sendMessage("Price: $5 * 2", { parse_mode: undefined })

Reply keyboards¶

Comma-separated button labels at the bottom of the screen:

// String format
Bot.sendKeyboard("Choose an option:", "Yes,No,Maybe")

// Object format
Bot.sendKeyboard({
  text: "Choose an option:",
  keyboard: "Yes,No,Maybe"
})

For inline buttons (tappable buttons inside the message bubble), use Api.sendMessage with reply_markup instead.

Media¶

String (URL or path) or object with options:

Bot.sendPhoto("photo.jpg")
Bot.sendPhoto({ photo: "photo.jpg", caption: "Nice shot!" })

Bot.sendDocument("file.pdf")
Bot.sendVideo({ video: "video.mp4", caption: "Watch this" })

Captions default to Markdown when provided.

Try it — copy-paste examples¶

Welcome message¶

Bot.sendMessage("*Welcome!* Type /help for commands.")

Quick menu with reply keyboard¶

Bot.sendKeyboard("What would you like?", "Shop,Support,About")

Send then edit (with await)¶

await is optional — but when you use it, send methods return a chainable object:

let sent = await Bot.sendMessage("Working on it...")
await sent.editText("Done!")
await sent.delete()

See Method Chaining for all chained methods.

Debug with Bot.inspect¶

Formats values and sends them to the current chat. console.log routes here in command Logic fields:

Bot.inspect(user)
Bot.inspect("Step:", 2, "Result:", someArray)

What's not on Bot?¶

Telegram read/query methods aren't on Bot:

• getChat, getMe, getUserProfilePhotos, etc.

Use the Api instance for those. Bot is for sending output and controlling bot flow.

Method reference¶

Important notes¶

• All send methods target the current chat — no chat_id needed
• Errors from Telegram are logged; use await and check res.ok when failures matter
• For inline keyboards, message edits, and rich messages, use Api