send_message()¶
-
Client.
send_message
()¶ Send text messages.
- Parameters
chat_id (
int
|str
) – Unique identifier (int) or username (str) of the target chat. For your personal cloud (Saved Messages) you can simply use “me” or “self”. For a contact that exists in your Telegram address book you can use his phone number (str).text (
str
) – Text of the message to be sent.parse_mode (
str
, optional) – By default, texts are parsed using both Markdown and HTML styles. You can combine both syntaxes together. Pass “markdown” or “md” to enable Markdown-style parsing only. Pass “html” to enable HTML-style parsing only. Pass None to completely disable style parsing.disable_web_page_preview (
bool
, optional) – Disables link previews for links in this message.disable_notification (
bool
, optional) – Sends the message silently. Users will receive a notification with no sound.reply_to_message_id (
int
, optional) – If the message is a reply, ID of the original message.schedule_date (
int
, optional) – Date when the message will be automatically sent. Unix time.reply_markup (
InlineKeyboardMarkup
|ReplyKeyboardMarkup
|ReplyKeyboardRemove
|ForceReply
, optional) – Additional interface options. An object for an inline keyboard, custom reply keyboard, instructions to remove reply keyboard or to force a reply from the user.
- Returns
Message
– On success, the sent text message is returned.
Example
# Simple example app.send_message("haskell", "Thanks for creating **Pyrogram**!") # Disable web page previews app.send_message("me", "https://docs.pyrogram.org", disable_web_page_preview=True) # Reply to a message using its id app.send_message("me", "this is a reply", reply_to_message_id=12345) # Force HTML-only styles for this request only app.send_message("me", "**not bold**, <i>italic<i>", parse_mode="html") ## # For bots only, send messages with keyboards attached ## from pyrogram import ( ReplyKeyboardMarkup, InlineKeyboardMarkup, InlineKeyboardButton) # Send a normal keyboard app.send_message( chat_id, "Look at that button!", reply_markup=ReplyKeyboardMarkup([["Nice!"]])) # Send an inline keyboard app.send_message( chat_id, "These are inline buttons", reply_markup=InlineKeyboardMarkup( [ [InlineKeyboardButton("Data", callback_data="hidden_callback_data")], [InlineKeyboardButton("Docs", url="https://docs.pyrogram.org")] ]))