sendMessage
پیام متنی ارسال می‌کند.
مقدار بازگشتی: در صورت موفقیت، Message برمی‌گرداند.
پارامترها
| پارامتر | نوع | الزامی | توضیحات |
|---|---|---|---|
business_connection_id | String | اختیاری | شناسه اتصال تجاری |
chat_id | Integer or String | بله | شناسه چت یا @username |
message_thread_id | Integer | اختیاری | شناسه تاپیک انجمن |
direct_messages_topic_id | Integer | اختیاری | شناسه تاپیک پیام‌های مستقیم (برای کانال‌ها، Bot API 10.0) |
ephemeral_message_parameters | EphemeralMessageParameters | اختیاری | آبجکت JSON از نوع EphemeralMessageParameters — پیام موقتی که فقط برای یک کاربر نمایش داده می‌شود (Bot API 10.3) |
text | String | بله | متن پیام (1-4096 کاراکتر) |
parse_mode | String | اختیاری | HTML، Markdown یا MarkdownV2 |
entities | Array of MessageEntity | اختیاری | آرایه JSON از نوع MessageEntity |
link_preview_options | LinkPreviewOptions | اختیاری | آبجکت JSON از نوع LinkPreviewOptions |
disable_notification | Boolean | اختیاری | ارسال بی‌صدا |
protect_content | Boolean | اختیاری | محافظت از محتوا |
allow_paid_broadcast | Boolean | اختیاری | اجازه ارسال انبوه پولی (0.1 Stars برای هر پیام) |
message_effect_id | String | اختیاری | شناسه افکت پیام |
suggested_post_parameters | SuggestedPostParameters | اختیاری | آبجکت JSON از نوع SuggestedPostParameters (برای کانال‌ها) |
reply_parameters | ReplyParameters | اختیاری | آبجکت JSON از نوع ReplyParameters |
reply_markup | InlineKeyboardMarkup or ReplyKeyboardMarkup or ReplyKeyboardRemove or ForceReply | اختیاری | آبجکت JSON از نوع InlineKeyboardMarkup / ReplyKeyboardMarkup / ReplyKeyboardRemove / ForceReply |
نمونه درخواست
curl
curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
-H "Content-Type: application/json" \
-d '{"chat_id":123456789,"text":"Hello from the Bot API!"}'Python
import requests
TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.post(
f"https://api.telegram.org/bot{TOKEN}/sendMessage",
json={
"chat_id": 123456789,
"text": "Hello from the Bot API!"
},
timeout=30,
)
print(resp.json())JavaScript
const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"chat_id": 123456789,
"text": "Hello from the Bot API!"
}),
});
console.log(await res.json());راهنمای گام‌به‌گام: ارسال پیام با ربات تلگرام از طریق API تلگرام (sendMessage)
متدهای مرتبط
forwardMessageیک پیام را فوروارد می‌کند.forwardMessagesچند پیام را فوروارد می‌کند.copyMessageیک پیام را بدون لینک فوروارد کپی می‌کند.copyMessagesچند پیام را کپی می‌کند.deleteMessageیک پیام را حذف می‌کند.deleteMessagesچند پیام را حذف می‌کند.sendChatActionوضعیت فعالیت در چت (typing و غیره) را ارسال می‌کند.sendMessageDraftپیش‌نویس پیام را ارسال می‌کند - پیش‌نمایش موقت (Bot API 9.5+).sendContactمخاطب ارسال می‌کند.sendLocationموقعیت مکانی ارسال می‌کند.sendVenueمکان ارسال می‌کند.setMessageReactionروی پیام واکنش می‌گذارد.