Messages & Content

This section covers all text and non-media interactive message types available via the Bot object.

sendMessage

Sends a text message to a chat.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID or `@username`. Use `u` for the current user.
`text`	String	Yes	The message text. Up to 4096 characters.
`parse_mode`	String	No	Formatting mode: `"HTML"`, `"Markdown"`, or `"MarkdownV2"`.
`disable_web_page_preview`	Boolean	No	If `True`, disables link previews in the message.
`disable_notification`	Boolean	No	Sends the message silently.
`reply_to_message_id`	Integer	No	If set, the message will be sent as a reply.
`reply_markup`	Object	No	Inline or reply keyboard markup (see Keyboards).

BLP Example

# Basic message
Bot.sendMessage(chat_id=u, text="Hello World!")

# Short form (uses current chat automatically)
Bot.sendMessage("Hello World!")

# With formatting and reply
Bot.sendMessage(
    chat_id=u,
    text="<b>Bold</b> and <i>italic</i> text!",
    parse_mode="HTML",
    disable_web_page_preview=True,
    reply_to_message_id=message.message_id
)

copyMessage

Copies any message. Unlike forwardMessage, the copy has no link to the original message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID where the copy will be sent.
`from_chat_id`	Integer or String	Yes	Source chat ID where the original message is.
`message_id`	Integer	Yes	Message ID in the source chat.
`caption`	String	No	New caption to add to the copied message.
`parse_mode`	String	No	Formatting mode for the caption.

BLP Example

Bot.copyMessage(
    chat_id=u,
    from_chat_id=u,
    message_id=message.message_id,
    caption="I copied your message!"
)

copyMessages

Copies multiple messages.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID where the copies will be sent.
`from_chat_id`	Integer or String	Yes	Source chat ID where the original messages are.
`message_ids`	Array of Integer	Yes	Message IDs in the source chat.
`remove_caption`	Boolean	No	If `True`, removes captions from media messages.

BLP Example

Bot.copyMessages(
    chat_id=u,
    from_chat_id=u,
    message_ids=[message.message_id, message.message_id - 1]
)

forwardMessage

Forwards a message from one chat to another. Shows the original sender.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`from_chat_id`	Integer or String	Yes	Source chat ID.
`message_id`	Integer	Yes	Message ID to forward.
`disable_notification`	Boolean	No	Sends message silently.

BLP Example

Bot.forwardMessage(
    chat_id=u,
    from_chat_id=u,
    message_id=message.message_id
)

forwardMessages

Forwards multiple messages from one chat to another.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`from_chat_id`	Integer or String	Yes	Source chat ID.
`message_ids`	Array of Integer	Yes	Message IDs to forward.

BLP Example

Bot.forwardMessages(
    chat_id=u,
    from_chat_id=u,
    message_ids=[message.message_id, message.message_id - 1]
)

sendLocation

Sends a point on a map.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`latitude`	Float	Yes	Latitude of the location.
`longitude`	Float	Yes	Longitude of the location.
`live_period`	Integer	No	Period in seconds for a live location (60–86400).
`heading`	Integer	No	Direction of movement in degrees (1–360).
`proximity_alert_radius`	Integer	No	Alert radius for nearby users in meters (1–100000).

BLP Example

# Static location
Bot.sendLocation(
    chat_id=u,
    latitude=23.8103,
    longitude=90.4125
)

# Live location (updates for 60 seconds)
Bot.sendLocation(
    chat_id=u,
    latitude=23.8103,
    longitude=90.4125,
    live_period=60
)

editMessageLiveLocation

Edits a live location message while it is still active.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	ID of the live location message.
`latitude`	Float	Yes	New latitude.
`longitude`	Float	Yes	New longitude.
`heading`	Integer	No	New direction in degrees (1–360).

BLP Example

Bot.editMessageLiveLocation(
    chat_id=u,
    message_id=message.message_id,
    latitude=23.8110,
    longitude=90.4130
)

stopMessageLiveLocation

Stops updating a live location before its live_period expires.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	ID of the live location message.

BLP Example

Bot.stopMessageLiveLocation(
    chat_id=u,
    message_id=message.message_id
)

sendVenue

Sends information about a venue (location with a name and address).

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`latitude`	Float	Yes	Latitude of the venue.
`longitude`	Float	Yes	Longitude of the venue.
`title`	String	Yes	Name of the venue.
`address`	String	Yes	Address of the venue.
`foursquare_id`	String	No	Foursquare ID of the venue.

BLP Example

Bot.sendVenue(
    chat_id=u,
    latitude=23.8103,
    longitude=90.4125,
    title="Dhaka City",
    address="Dhaka, Bangladesh"
)

sendContact

Sends a phone contact.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`phone_number`	String	Yes	Contact’s phone number.
`first_name`	String	Yes	Contact’s first name.
`last_name`	String	No	Contact’s last name.
`vcard`	String	No	Additional vCard data.

BLP Example

Bot.sendContact(
    chat_id=u,
    phone_number="+8801700000000",
    first_name="John",
    last_name="Doe"
)

sendPoll

Sends a native Telegram poll.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`question`	String	Yes	Poll question (1–300 characters).
`options`	Array of String	Yes	List of answer options (2–10 items).
`is_anonymous`	Boolean	No	If `False`, poll results are visible to all. Default: `True`.
`type`	String	No	`"regular"` or `"quiz"`. Default: `"regular"`.
`allows_multiple_answers`	Boolean	No	Allow multiple choice. Only for regular polls.
`correct_option_id`	Integer	No	Index of the correct answer. Required for quiz polls.
`explanation`	String	No	Explanation shown after a quiz answer.
`open_period`	Integer	No	Poll open time in seconds (5–600).

BLP Example

# Regular poll
Bot.sendPoll(
    chat_id=u,
    question="What is your favorite programming language?",
    options=["Python", "JavaScript", "C++", "Java"],
    is_anonymous=False,
    allows_multiple_answers=True
)

# Quiz poll
Bot.sendPoll(
    chat_id=u,
    question="What is 2 + 2?",
    options=["3", "4", "5"],
    type="quiz",
    correct_option_id=1,
    explanation="2 + 2 = 4!"
)

stopPoll

Stops a poll which was sent by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	Message ID of the poll.

BLP Example

Bot.stopPoll(
    chat_id=u,
    message_id=message.message_id
)

sendDice

Sends an animated emoji that shows a random value.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`emoji`	String	No	Emoji to animate. One of: `🎲`, `🎯`, `🏀`, `⚽`, `🎳`, `🎰`. Default: `🎲`.

BLP Example

Bot.sendDice(chat_id=u, emoji="🎰")
Bot.sendDice(chat_id=u, emoji="🎯")

sendChatAction

Shows the user that the bot is doing something. Status lasts 5 seconds or until the bot sends a message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`action`	String	Yes	Type of action. See options below.

Available actions:

Action	Description
`typing`	Bot is typing a text message
`upload_photo`	Bot is uploading a photo
`record_video`	Bot is recording a video
`upload_video`	Bot is uploading a video
`record_voice`	Bot is recording voice
`upload_voice`	Bot is uploading voice
`upload_document`	Bot is uploading a file
`find_location`	Bot is finding a location

BLP Example

Bot.sendChatAction(chat_id=u, action="typing")

editMessageText

Edits the text of an existing message sent by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Chat ID of the message to edit.
`message_id`	Integer	Yes	ID of the message to edit.
`text`	String	Yes	New text content.
`parse_mode`	String	No	Formatting mode: `"HTML"`, `"Markdown"`, `"MarkdownV2"`.
`reply_markup`	Object	No	New inline keyboard to attach.

BLP Example

Bot.editMessageText(
    chat_id=u,
    message_id=message.message_id,
    text="<b>Updated text!</b>",
    parse_mode="HTML"
)

editMessageCaption

Edits the caption of an existing media message sent by the bot.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Chat ID of the message to edit.
`message_id`	Integer	Yes	ID of the message to edit.
`caption`	String	Yes	New caption content.
`parse_mode`	String	No	Formatting mode: `"HTML"`, `"Markdown"`, `"MarkdownV2"`.
`reply_markup`	Object	No	New inline keyboard to attach.

BLP Example

Bot.editMessageCaption(
    chat_id=u,
    message_id=message.message_id,
    caption="<b>Updated caption!</b>",
    parse_mode="HTML"
)

deleteMessage

Deletes a message. Bots can only delete their own messages or messages in groups where they are admin.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Chat ID.
`message_id`	Integer	Yes	ID of the message to delete.

BLP Example

Bot.deleteMessage(
    chat_id=u,
    message_id=message.message_id
)

deleteMessages

Deletes multiple messages simultaneously.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Chat ID.
`message_ids`	Array of Integer	Yes	IDs of the messages to delete.

BLP Example

Bot.deleteMessages(
    chat_id=u,
    message_ids=[message.message_id, message.message_id - 1]
)

setMessageReaction

Sets or removes a reaction (emoji or custom emoji) on a message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	ID of the message to react to.
`reaction`	Array of Object	No	Array of `ReactionType` objects to set. Pass an empty array to remove all bot reactions.
`is_big`	Boolean	No	Pass `True` to set the reaction with a big animation.

BLP Example

# Set a thumbs up reaction
Bot.setMessageReaction(
    chat_id=u,
    message_id=message.message_id,
    reaction=[{"type": "emoji", "emoji": "👍"}]
)

# Remove reaction
Bot.setMessageReaction(chat_id=u, message_id=message.message_id, reaction=[])

sendMessageDraft

Streams a partial text message. Commonly used for streaming AI-generated text.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	No	The message ID to edit if updating a previously drafted message. If omitted, sends a new message.
`text`	String	Yes	The text content to display. Can be empty.
`can_stop`	Boolean	No	Pass `True` if the user can interrupt the generation.
`keep_on_stop`	Boolean	No	Keep the drafted content if generation is stopped.

BLP Example

draft = Bot.sendMessageDraft(chat_id=u, text="Thinking")
Bot.sendMessageDraft(chat_id=u, message_id=draft.message_id, text="Thinking...")
# Later, commit the final text using editMessageText
Bot.editMessageText(chat_id=u, message_id=draft.message_id, text="Final AI Response")

sendChecklist

Sends a checklist message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`options`	Array of String	Yes	Array of checklist options.
`title`	String	No	Title of the checklist.

BLP Example

Bot.sendChecklist(
    chat_id=u,
    title="Daily Tasks",
    options=["Review code", "Write docs", "Push changes"]
)

editMessageChecklist

Edits a checklist message.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`message_id`	Integer	Yes	ID of the checklist message to edit.
`options`	Array of String	Yes	New array of checklist options.
`title`	String	No	New title of the checklist.

BLP Example

Bot.editMessageChecklist(
    chat_id=u,
    message_id=message.message_id,
    title="Updated Daily Tasks",
    options=["Review code", "Write docs", "Push changes", "Relax"]
)

sendLivePhoto

Sends a live photo.

Parameter	Type	Required	Description
`chat_id`	Integer or String	Yes	Target chat ID.
`live_photo`	String	Yes	File ID or URL of the live photo.
`caption`	String	No	Photo caption (0-1024 characters).

BLP Example

Bot.sendLivePhoto(
    chat_id=u,
    live_photo="FILE_ID_HERE",
    caption="Check out this live photo!"
)

Getting Started

Language Reference

Telegram API Methods

Core Libraries (Libs)

Advanced & Tools

sendMessage

copyMessage

copyMessages

forwardMessage

forwardMessages

sendLocation

editMessageLiveLocation

stopMessageLiveLocation

sendVenue

sendContact

sendPoll

stopPoll

sendDice

sendChatAction

editMessageText

editMessageCaption

deleteMessage

deleteMessages

setMessageReaction

sendMessageDraft

sendChecklist

editMessageChecklist

sendLivePhoto

​sendMessage

​copyMessage

​copyMessages

​forwardMessage

​forwardMessages

​sendLocation

​editMessageLiveLocation

​stopMessageLiveLocation

​sendVenue

​sendContact

​sendPoll

​stopPoll

​sendDice

​sendChatAction

​editMessageText

​editMessageCaption

​deleteMessage

​deleteMessages

​setMessageReaction

​sendMessageDraft

​sendChecklist

​editMessageChecklist

​sendLivePhoto

sendMessage

copyMessage

copyMessages

forwardMessage

forwardMessages

sendLocation

editMessageLiveLocation

stopMessageLiveLocation

sendVenue

sendContact

sendPoll

stopPoll

sendDice

sendChatAction

editMessageText

editMessageCaption

deleteMessage

deleteMessages

setMessageReaction

sendMessageDraft

sendChecklist

editMessageChecklist

sendLivePhoto