Sending Messages (simplified way)

Sending Messages and Media with Bot¶

These Bot methods send messages or media to the current chat.

Bot.sendMessage("Hello user!")

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

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

Bot.sendKeyboard("Choose an option:", "Yes,No")

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

All media methods support string and object formats.

Bot.sendPhoto("photo.jpg")

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

Bot.sendDocument("file.pdf", "Here is your pdf")

Bot.sendDocument({
  document: "file.pdf",
  caption: "Here is your file"
})

Bot.sendAudio("music.mp3")

Bot.sendAudio({
  audio: "music.mp3",
  caption: "Here is your music"
})

Bot.sendVideo("video.mp4")

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

Bot.sendVoice("voice.ogg")

Bot.sendVoice({
  voice: "voice.ogg",
  caption: "Voice note"
})

Only specific Bot methods return a response that supports chained methods
(when used with await).

Example:

let data = await Bot.sendMessage("Pinned message")

data.pin()

Note

Not all Bot methods support chaining. Chaining works only when the method returns a Telegram message object.

Bot.inspect() sends inspect data to the current chat.

It is mainly used for debugging and checking values quickly.

Bot.inspect({ user: "Alice", id: 123 })

Bot.inspect(
  "User data:",
  user,
  { id: 123 },
  someArray
)

The inspected data is formatted and sent as a message in the chat.

Tip

Use Bot.inspect() only during development. Avoid using it in production bots for users.

Only the following Bot methods are available for sending output:

These methods are intentionally limited and focused on output and flow control.

Methods that read or query Telegram data, such as:

are not available in the Bot instance.

Info

The Bot instance is designed for sending responses and controlling bot behavior, not for querying Telegram data.