زبان سلام
ویرایشگر آنلاین

کتابخانه‌ی استاندارد · وب و سرویس‌ها

بات تلگرام telegram/bot

ساختن بات تلگرام با Bot API: پیام، دکمه، وب‌هوک و حلقه‌ی دریافت.

واردسازی تلگرام.بات تلگرام
در این صفحه
  1. گونه‌ها
  2. پایاها و متغیرها
  3. روال‌ها

برای ساختن بات، از BotFather توکن بگیرید و بات جدید را با آن بسازید. بات دو راه برای گرفتن پیام‌ها دارد: حلقه دریافت که خودش از تلگرام می‌پرسد و برای آزمودن و سرورهای ساده بهتر است، یا وب‌هوک که تلگرام پیام‌ها را با POST به سرور شما می‌فرستد.

در وب‌هوک می‌توانید جواب را مستقیم در بدنه‌ی پاسخ HTTP بفرستید؛ روال‌های پاسخ ... همان متن جیسون را می‌سازند. با تنظیم وب هوک با رمز رمزی بگذارید و در هر درخواست سرآیندش را بررسی کنید.

گونه‌ها

کاربر User

ساختار کاربر
یک کاربر تلگرام.
نامانگلیسیگونهتوضیح
ididصحیح۶۴ = 0شناسه.
is_botis_botمنطقی = نادرستبات است.
first_namefirst_nameرشته = ""نام.
last_namelast_nameرشته = ""نام خانوادگی.
usernameusernameرشته = ""نام کاربری.
language_codelanguage_codeرشته = ""زبان کاربر، مثل fa.
telegram-bot-Parse.salam
واردسازی تلگرام.بات تلگرام

روال ریشه:
    متن := `{"update_id":10,"message":{"message_id":5,"date":1700000000,"text":"/start hello","chat":{"id":42,"type":"private","first_name":"مریم","username":"maryam"},"from":{"id":42,"is_bot":false,"first_name":"مریم","language_code":"fa"},"reply_to_message":{"message_id":4,"from":{"id":7,"first_name":"علی"}}}}`
    ب := بات تلگرام.تجزیه بروزرسانی(متن)
    سرچاپ ب.update_id، ب.has_message، ب.has_callback_query
    پ := ب.message
    سرچاپ پ.message_id، پ.date، پ.text، پ.chat.id، پ.chat.chat_type، پ.chat.first_name، پ.chat.username
    سرچاپ پ.from_user.id، پ.from_user.is_bot، پ.from_user.language_code، پ.reply_to.message_id، پ.reply_to.user_id، پ.reply_to.user_name
    سرچاپ بات تلگرام.دستور است(پ.text)، بات تلگرام.نام دستور(پ.text)، بات تلگرام.آرگومان های دستور(پ.text)
    سرچاپ بات تلگرام.دستور است("سلام")، بات تلگرام.نام دستور("/help@my_bot")

    همه := بات تلگرام.تجزیه بروزرسانی ها(`{"ok":true,"result":[{"update_id":11,"callback_query":{"id":"cq1","data":"yes","from":{"id":42,"first_name":"مریم"},"message":{"message_id":9,"chat":{"id":42,"type":"private"}}}},{"update_id":12,"inline_query":{"id":"iq1","query":"کتاب","offset":"","from":{"id":42,"first_name":"مریم"}}}]}`)
    سرچاپ همه.طول()
    ق := همه[۰].callback_query
    سرچاپ همه[۰].has_callback_query، ق.id، ق.data، ق.from_user.first_name، ق.has_message، ق.message.message_id
    د := همه[۱].inline_query
    سرچاپ همه[۱].has_inline_query، د.id، د.query، د.offset.طول()
    سرچاپ بات تلگرام.تجزیه کاربر(`{"id":1,"first_name":"x","last_name":"y","is_bot":true}`).last_name
    سرچاپ بات تلگرام.تجزیه گفتگو(`{"id":-100,"type":"supergroup","title":"گروه"}`).title
    سرچاپ بات تلگرام.تجزیه پیام(`{"message_id":1,"caption":"عکس","chat":{"id":1}}`).caption
    سرچاپ بات تلگرام.تجزیه پرسمان بازخوان(`{"id":"q","data":"d"}`).data، بات تلگرام.تجزیه پرسمان درون خطی(`{"id":"i","query":"q"}`).query
    سرچاپ بات تلگرام.تجزیه بروزرسانی(`{"update_id":13,"channel_post":{"message_id":1,"text":"خبر","chat":{"id":-5}}}`).channel_post.text

    ناپایا ردیف۱ := وکتور {} برگردان وکتور<رشته>
    ردیف۱.افزودن(بات تلگرام.دکمه درون خطی("بله"، "yes"))
    ردیف۱.افزودن(بات تلگرام.دکمه درون خطی("خیر"، "no"))
    ناپایا ردیف۲ := وکتور {} برگردان وکتور<رشته>
    ردیف۲.افزودن(بات تلگرام.دکمه درون خطی با پیوند("سایت"، "https://salamlang.ir"))
    ناپایا ردیف‌ها := وکتور {} برگردان وکتور<رشته>
    ردیف‌ها.افزودن(بات تلگرام.ردیف(ردیف۱))
    ردیف‌ها.افزودن(بات تلگرام.ردیف(ردیف۲))
    سرچاپ بات تلگرام.صفحه کلید درون خطی(ردیف‌ها)
    ناپایا ساده := وکتور {} برگردان وکتور<رشته>
    ساده.افزودن(بات تلگرام.دکمه صفحه کلید("منو"))
    ناپایا ردیف‌های ساده := وکتور {} برگردان وکتور<رشته>
    ردیف‌های ساده.افزودن(بات تلگرام.ردیف(ساده))
    سرچاپ بات تلگرام.صفحه کلید پاسخ(ردیف‌های ساده)
    سرچاپ بات تلگرام.حذف صفحه کلید()، بات تلگرام.پاسخ اجباری()
    سرچاپ بات تلگرام.دستور بات("start"، "شروع")

    بات := بات تلگرام.بات جدید("123:ABC")
    سرچاپ بات تلگرام.پیوند فایل(بات، "photos/file_1.jpg")
    سرچاپ بات تلگرام.پاسخ پیام(۴۲، "سلام")
    ناپایا گ := بات تلگرام.گزینه های ارسال {}
    گ.parse_mode = "HTML"
    گ.reply_to_message_id = ۵
    گ.disable_notification = درست
    سرچاپ بات تلگرام.پاسخ پیام با گزینه ها(۴۲، "<b>سلام</b>"، گ)
    سرچاپ بات تلگرام.پاسخ فوری پرسمان بازخوان("cq1"، "ثبت شد"، نادرست)
    سرچاپ بات تلگرام.پاسخ کنش گفتگو(۴۲، "typing")
    سرچاپ بات تلگرام.پاسخ ویرایش متن پیام(۴۲، ۹، "به‌روز شد"، بات تلگرام.حذف صفحه کلید())
    سرچاپ بات تلگرام.سرآیند راز
پایان
خروجی10 true false 5 1700000000 /start hello 42 private مریم maryam 42 false fa 4 7 علی true start hello false help 2 true cq1 yes مریم true 9 true iq1 کتاب 0 y گروه عکس d q خبر {"inline_keyboard": [[{"text": "بله", "callback_data": "yes"}, {"text": "خیر", "callback_data": "no"}], [{"text": "سایت", "url": "https://salamlang.ir"}]]} {"keyboard": [["منو"]], "resize_keyboard": true} {"remove_keyboard": true} {"force_reply": true} {"command": "start", "description": "شروع"} https://api.telegram.org/file/bot123:ABC/photos/file_1.jpg {"method": "sendMessage", "chat_id": 42, "text": "سلام"} {"method": "sendMessage", "chat_id": 42, "text": "<b>سلام</b>", "parse_mode": "HTML", "disable_notification": true, "reply_to_message_id": 5} {"method": "answerCallbackQuery", "callback_query_id": "cq1", "text": "ثبت شد"} {"method": "sendChatAction", "chat_id": 42, "action": "typing"} {"method": "editMessageText", "chat_id": 42, "message_id": 9, "text": "به‌روز شد", "reply_markup": {"remove_keyboard": true}} X-Telegram-Bot-Api-Secret-Token

گفتگو Chat

ساختار گفتگو
یک گفتگو: خصوصی، گروه یا کانال.
نامانگلیسیگونهتوضیح
ididصحیح۶۴ = 0شناسه؛ برای گروه‌ها منفی.
chat_typechat_typeرشته = ""نوع: private، group، supergroup یا channel.
titletitleرشته = ""عنوان گروه یا کانال.
usernameusernameرشته = ""نام کاربری.
first_namefirst_nameرشته = ""نام.
last_namelast_nameرشته = ""نام خانوادگی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پاسخ به ReplyTo

ساختار پاسخ به
پیامی که این پیام پاسخ آن است.
نامانگلیسیگونهتوضیح
message_idmessage_idصحیح۶۴ = 0شناسه‌ی آن پیام.
user_iduser_idصحیح۶۴ = 0شناسه‌ی فرستنده‌اش.
user_nameuser_nameرشته = ""نام فرستنده‌اش.
telegram-bot-Bot.salam
واردسازی تلگرام.بات تلگرام
واردسازی محیط

روال رسیدگی(ب: بات تلگرام.بروزرسانی):
    اگر وارونه ب.has_message:
        برگشت
    پایان
    سرچاپ ب.message.from_user.first_name، ب.message.text
پایان

روال ریشه:
    بات := بات تلگرام.بات جدید(محیط.دریافت("TELEGRAM_TOKEN"))
    من := بات تلگرام.دریافت من(بات)
    اگر وارونه بات تلگرام.موفق(من):
        سرچاپ من.error_code، من.description، من.http_status، من.http_err
        برگشت
    پایان
    سرچاپ من.ok، من.result
    گفتگو := ۴۲ برگردان صحیح۶۴
    _ := بات تلگرام.ارسال پیام(بات، گفتگو، "سلام")
    _ := بات تلگرام.ارسال پیام(بات، "@my_channel"، "خبر تازه")
    ناپایا گ := بات تلگرام.گزینه های ارسال {}
    گ.parse_mode = "Markdown"
    گ.reply_markup = بات تلگرام.حذف صفحه کلید()
    _ := بات تلگرام.ارسال پیام با گزینه ها(بات، گفتگو، "*مهم*"، گ)
    _ := بات تلگرام.ارسال عکس(بات، گفتگو، "https://example.com/a.jpg"، "عکس")
    _ := بات تلگرام.ارسال سند(بات، گفتگو، "BQACAgQAAx"، "")
    _ := بات تلگرام.ارسال ویدیو(بات، گفتگو، "https://example.com/v.mp4"، "")
    _ := بات تلگرام.ارسال صدا(بات، گفتگو، "https://example.com/a.mp3"، "")
    _ := بات تلگرام.ارسال پیام صوتی(بات، گفتگو، "AwACAgQ"، "")
    _ := بات تلگرام.ارسال استیکر(بات، گفتگو، "CAACAgI")
    _ := بات تلگرام.ارسال موقعیت(بات، گفتگو، ۳۵.۶۹۹۷، ۵۱.۳۳۸)
    _ := بات تلگرام.ارسال مخاطب(بات، گفتگو، "+989120000000"، "علی")
    _ := بات تلگرام.ارسال کنش گفتگو(بات، گفتگو، "typing")
    _ := بات تلگرام.ویرایش متن پیام(بات، گفتگو، ۱۰، "ویرایش شد")
    _ := بات تلگرام.ارسال دوباره پیام(بات، گفتگو، ۴۳، ۱۱)
    _ := بات تلگرام.سنجاق کردن پیام(بات، گفتگو، ۱۰)
    _ := بات تلگرام.برداشتن سنجاق پیام(بات، گفتگو، ۱۰)
    _ := بات تلگرام.حذف پیام(بات، گفتگو، ۱۰)
    _ := بات تلگرام.پاسخ به پرسمان بازخوان(بات، "cq1"، "ثبت شد")
    _ := بات تلگرام.پاسخ به پرسمان درون خطی(بات، "iq1"، "[]")
    پرونده := بات تلگرام.دریافت فایل(بات، "AgACAgQ")
    سرچاپ پرونده.result.طول() > ۰
    _ := بات تلگرام.دریافت گفتگو(بات، گفتگو)
    _ := بات تلگرام.تعداد اعضای گفتگو(بات، گفتگو)
    _ := بات تلگرام.عضو گفتگو(بات، گفتگو، ۷)
    _ := بات تلگرام.مسدود کردن عضو(بات، گفتگو، ۷)
    _ := بات تلگرام.رفع مسدودیت عضو(بات، گفتگو، ۷)
    _ := بات تلگرام.ترک گفتگو(بات، -۱۰۰)
    ناپایا دستورها := وکتور {} برگردان وکتور<رشته>
    دستورها.افزودن(بات تلگرام.دستور بات("start"، "شروع"))
    _ := بات تلگرام.تنظیم دستورات بات(بات، دستورها)
    _ := بات تلگرام.تنظیم وب هوک(بات، "https://example.com/hook")
    _ := بات تلگرام.تنظیم وب هوک با رمز(بات، "https://example.com/hook"، "راز-من")
    _ := بات تلگرام.دریافت اطلاعات وب هوک(بات)
    _ := بات تلگرام.حذف وب هوک(بات)
    ناپایا پارامتر := نگاشت {} برگردان نگاشت<رشته، رشته>
    پارامتر.درج("chat_id"، "42")
    _ := بات تلگرام.فراخوان(بات، "getChatAdministrators"، پارامتر)
    ب := بات تلگرام.دریافت بروزرسانی ها(بات، ۰، ۱۰، ۳۰)
    سرچاپ بات تلگرام.تجزیه بروزرسانی ها(ب.result).طول()، بات.token.طول() > ۰
    بات تلگرام.حلقه دریافت(بات، ۳۰، (ب: بات تلگرام.بروزرسانی):
        رسیدگی(ب)
    پایان)
پایان

پیام Message

ساختار پیام
یک پیام.
نامانگلیسیگونهتوضیح
message_idmessage_idصحیح۶۴ = 0شناسه.
datedateصحیح۶۴ = 0زمان بر حسب ثانیه‌ی یونیکس.
chatchatگفتگوگفتگو.
from_userfrom_userکاربرفرستنده.
texttextرشته = ""متن.
captioncaptionرشته = ""زیرنویس عکس یا پرونده.
reply_toreply_toپاسخ بهپیام پاسخ‌داده‌شده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پرسمان بازخوان CallbackQuery

ساختار پرسمان بازخوان
فشردن یک دکمه‌ی درون‌خطی.
نامانگلیسیگونهتوضیح
ididرشته = ""شناسه؛ با آن پاسخ دهید.
from_userfrom_userکاربرکاربر.
messagemessageپیامپیامی که دکمه در آن بود.
has_messagehas_messageمنطقی = نادرستپیام دارد.
datadataرشته = ""داده‌ی دکمه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پرسمان درون خطی InlineQuery

ساختار پرسمان درون خطی
پرسمان درون‌خطی، وقتی کاربر @bot می‌نویسد.
نامانگلیسیگونهتوضیح
ididرشته = ""شناسه.
from_userfrom_userکاربرکاربر.
queryqueryرشته = ""متن.
offsetoffsetرشته = ""جای صفحه‌بندی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

بروزرسانی Update

ساختار بروزرسانی
یک رویداد از تلگرام؛ فقط یکی از بخش‌هایش پر است.
نامانگلیسیگونهتوضیح
update_idupdate_idصحیح۶۴ = 0شناسه؛ برای دریافت بروزرسانی ها بعدی یکی بیشتر بدهید.
messagemessageپیامپیام.
has_messagehas_messageمنطقی = نادرستپیام دارد.
channel_postchannel_postپیامپست کانال.
has_channel_posthas_channel_postمنطقی = نادرستپست کانال دارد.
callback_querycallback_queryپرسمان بازخوانفشردن دکمه.
has_callback_queryhas_callback_queryمنطقی = نادرستدکمه دارد.
inline_queryinline_queryپرسمان درون خطیپرسمان درون‌خطی.
has_inline_queryhas_inline_queryمنطقی = نادرستپرسمان درون‌خطی دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پاسخ ای پی آی ApiResponse

ساختار پاسخ ای پی آی
پاسخ Bot API.
نامانگلیسیگونهتوضیح
okokمنطقی = نادرستموفق بود.
resultresultرشته = ""نتیجه به شکل جیسون.
descriptiondescriptionرشته = ""توضیح خطا.
error_codeerror_codeصحیح۶۴ = 0کد خطای تلگرام.
http_statushttp_statusصحیح = 0کد وضعیت HTTP.
http_errhttp_errرشته = ""خطای شبکه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

گزینه های ارسال SendOptions

ساختار گزینه های ارسال
گزینه‌های فرستادن پیام.
نامانگلیسیگونهتوضیح
parse_modeparse_modeرشته = ""قالب متن: HTML یا MarkdownV2.
disable_notificationdisable_notificationمنطقی = نادرستبی صدا فرستاده شود.
reply_to_message_idreply_to_message_idصحیح۶۴ = 0پاسخ به این پیام.
reply_markupreply_markupرشته = ""صفحه‌کلید به شکل جیسون.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

بات Bot

ساختار بات
یک بات.
نامانگلیسیگونهتوضیح
tokentokenرشته = ""توکن از BotFather؛ آن را پنهان نگه دارید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پایاها و متغیرها

سرآیند راز SECRET_HEADER

پایا سرآیند راز: رشته = "X-Telegram-بات-Api-Secret-Token"
نام سرآیندی که رمز وب‌هوک در آن می‌آید.
telegram-bot-Webhook.salam
واردسازی تلگرام.بات تلگرام
واردسازی شبکه.اچ تی تی پی شبکه
واردسازی شبکه.مسیریاب شبکه

روال وب‌هوک(ز: صحیح۶۴):
    اگر اچ تی تی پی شبکه.سرصفحه زمینه(ز، بات تلگرام.سرآیند راز) != "راز-من":
        اچ تی تی پی شبکه.وضعیت زمینه(ز، ۴۰۳)
        اچ تی تی پی شبکه.متن زمینه(ز، "forbidden")
        برگشت
    پایان
    ب := بات تلگرام.تجزیه بروزرسانی(اچ تی تی پی شبکه.بدنه زمینه(ز))
    اگر ب.has_message و بات تلگرام.دستور است(ب.message.text):
        پاسخ := "دستور " + بات تلگرام.نام دستور(ب.message.text) + " رسید"
        اچ تی تی پی شبکه.جیسون زمینه(ز، بات تلگرام.پاسخ پیام(ب.message.chat.id، پاسخ))
    وگرنه ب.has_callback_query:
        اچ تی تی پی شبکه.جیسون زمینه(ز، بات تلگرام.پاسخ فوری پرسمان بازخوان(ب.callback_query.id، "باشه"، درست))
    وگرنه:
        اچ تی تی پی شبکه.متن زمینه(ز، "ok")
    پایان
پایان

روال ریشه:
    ناپایا م := مسیریاب شبکه.مسیریاب جدید()
    مسیریاب شبکه.ارسال(م، "/hook"، وب‌هوک)
    ناپایا س := اچ تی تی پی شبکه.سرور جدید(۱۹۶۱۲)
    اچ تی تی پی شبکه.استفاده(س، م)
    _ := اچ تی تی پی شبکه.اجرا در پس زمینه(س)

    ناپایا سر := اچ تی تی پی شبکه.سرصفحه جدید()
    سر.درج(بات تلگرام.سرآیند راز، "راز-من")
    سر.درج("Content-Type"، "application/json")
    پ := اچ تی تی پی شبکه.ارسال با("http://127.0.0.1:19612/hook"، `{"update_id":1,"message":{"message_id":2,"text":"/start","chat":{"id":42,"type":"private"}}}`، سر)
    سرچاپ اچ تی تی پی شبکه.وضعیت(پ)، اچ تی تی پی شبکه.بدنه(پ)
    پ۲ := اچ تی تی پی شبکه.ارسال با("http://127.0.0.1:19612/hook"، `{"update_id":2,"callback_query":{"id":"cq9","data":"x","from":{"id":42}}}`، سر)
    سرچاپ اچ تی تی پی شبکه.بدنه(پ۲)
    پ۳ := اچ تی تی پی شبکه.ارسال("http://127.0.0.1:19612/hook"، "{}")
    سرچاپ اچ تی تی پی شبکه.وضعیت(پ۳)
پایان
خروجی200 {"method": "sendMessage", "chat_id": 42, "text": "دستور start رسید"} {"method": "answerCallbackQuery", "callback_query_id": "cq9", "text": "باشه", "show_alert": true} 403

روال‌ها

تجزیه کاربر ParseUser

روال تجزیه کاربر(raw: رشته): کاربر
کاربر را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه گفتگو ParseChat

روال تجزیه گفتگو(raw: رشته): گفتگو
گفتگو را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه پیام ParseMessage

روال تجزیه پیام(raw: رشته): پیام
پیام را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه پرسمان بازخوان ParseCallbackQuery

روال تجزیه پرسمان بازخوان(raw: رشته): پرسمان بازخوان
فشردن دکمه را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه پرسمان درون خطی ParseInlineQuery

روال تجزیه پرسمان درون خطی(raw: رشته): پرسمان درون خطی
پرسمان درون‌خطی را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه بروزرسانی ParseUpdate

روال تجزیه بروزرسانی(raw: رشته): بروزرسانی
یک بروزرسانی را از جیسون می‌خواند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تجزیه بروزرسانی ها ParseUpdates

روال تجزیه بروزرسانی ها(raw: رشته): وکتور<بروزرسانی>
نتیجه‌ی getUpdates را به فهرست بروزرسانی‌ها تبدیل می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

بات جدید NewBot

روال بات جدید(token: رشته): بات
بات با توکن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

موفق Ok

روال موفق(resp: پاسخ ای پی آی): منطقی
پاسخ موفق بود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

فراخوان Call

روال فراخوان(bot: بات، method: رشته، params: نگاشت<رشته، رشته>): پاسخ ای پی آی
هر روش Bot API را با پارامترها صدا می‌زند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دریافت من GetMe

روال دریافت من(bot: بات): پاسخ ای پی آی
اطلاعات خود بات؛ برای آزمودن توکن.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دریافت بروزرسانی ها GetUpdates

روال دریافت بروزرسانی ها(bot: بات، offset: صحیح۶۴، limit: صحیح۶۴، timeout: صحیح۶۴): پاسخ ای پی آی
بروزرسانی‌ها را از جای داده‌شده با انتظار طولانی می‌گیرد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال پیام SendMessage

روال ارسال پیام(bot: بات، chat_id: صحیح۶۴، text: رشته): پاسخ ای پی آی
پیام متنی می‌فرستد؛ گفتگو با شناسه‌ی عددی یا نام کانال مثل @channel.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال پیام SendMessage

روال ارسال پیام(bot: بات، chat_id: رشته، text: رشته): پاسخ ای پی آی
پیام متنی می‌فرستد؛ گفتگو با شناسه‌ی عددی یا نام کانال مثل @channel.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال پیام با گزینه ها SendMessageOptions

روال ارسال پیام با گزینه ها(bot: بات، chat_id: صحیح۶۴، text: رشته، opts: گزینه های ارسال): پاسخ ای پی آی
پیام با گزینه‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال عکس SendPhoto

روال ارسال عکس(bot: بات، chat_id: صحیح۶۴، photo: رشته، caption: رشته): پاسخ ای پی آی
عکس را با نشانی یا شناسه‌ی پرونده و زیرنویس می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال سند SendDocument

روال ارسال سند(bot: بات، chat_id: صحیح۶۴، document: رشته، caption: رشته): پاسخ ای پی آی
پرونده را با نشانی یا شناسه‌ی پرونده و زیرنویس می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال ویدیو SendVideo

روال ارسال ویدیو(bot: بات، chat_id: صحیح۶۴، video: رشته، caption: رشته): پاسخ ای پی آی
ویدیو را با نشانی یا شناسه‌ی پرونده و زیرنویس می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال صدا SendAudio

روال ارسال صدا(bot: بات، chat_id: صحیح۶۴، audio: رشته، caption: رشته): پاسخ ای پی آی
آهنگ را با نشانی یا شناسه‌ی پرونده و زیرنویس می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال پیام صوتی SendVoice

روال ارسال پیام صوتی(bot: بات، chat_id: صحیح۶۴، voice: رشته، caption: رشته): پاسخ ای پی آی
پیام صوتی را با نشانی یا شناسه‌ی پرونده و زیرنویس می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال استیکر SendSticker

روال ارسال استیکر(bot: بات، chat_id: صحیح۶۴، sticker: رشته): پاسخ ای پی آی
استیکر.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال موقعیت SendLocation

روال ارسال موقعیت(bot: بات، chat_id: صحیح۶۴، latitude: اعشار۶۴، longitude: اعشار۶۴): پاسخ ای پی آی
موقعیت جغرافیایی.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال مخاطب SendContact

روال ارسال مخاطب(bot: بات، chat_id: صحیح۶۴، phone_number: رشته، first_name: رشته): پاسخ ای پی آی
مخاطب.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال کنش گفتگو SendChatAction

روال ارسال کنش گفتگو(bot: بات، chat_id: صحیح۶۴، action: رشته): پاسخ ای پی آی
وضعیتی مثل «در حال نوشتن» نشان می‌دهد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ویرایش متن پیام EditMessageText

روال ویرایش متن پیام(bot: بات، chat_id: صحیح۶۴، message_id: صحیح۶۴، text: رشته): پاسخ ای پی آی
متن پیام فرستاده‌شده را ویرایش می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

حذف پیام DeleteMessage

روال حذف پیام(bot: بات، chat_id: صحیح۶۴، message_id: صحیح۶۴): پاسخ ای پی آی
پیام را حذف می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ارسال دوباره پیام ForwardMessage

روال ارسال دوباره پیام(bot: بات، chat_id: صحیح۶۴، from_chat_id: صحیح۶۴، message_id: صحیح۶۴): پاسخ ای پی آی
پیامی را از گفتگوی دیگر می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

سنجاق کردن پیام PinChatMessage

روال سنجاق کردن پیام(bot: بات، chat_id: صحیح۶۴، message_id: صحیح۶۴): پاسخ ای پی آی
پیام را سنجاق می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

برداشتن سنجاق پیام UnpinChatMessage

روال برداشتن سنجاق پیام(bot: بات، chat_id: صحیح۶۴، message_id: صحیح۶۴): پاسخ ای پی آی
سنجاق را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

پاسخ به پرسمان بازخوان AnswerCallbackQuery

روال پاسخ به پرسمان بازخوان(bot: بات، callback_query_id: رشته، text: رشته): پاسخ ای پی آی
به فشردن دکمه پاسخ می‌دهد؛ تا پاسخ ندهید، دکمه در حال بارگذاری می‌ماند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

پاسخ به پرسمان درون خطی AnswerInlineQuery

روال پاسخ به پرسمان درون خطی(bot: بات، inline_query_id: رشته، results: رشته): پاسخ ای پی آی
نتیجه‌های پرسمان درون‌خطی را می‌فرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دریافت فایل GetFile

روال دریافت فایل(bot: بات، file_id: رشته): پاسخ ای پی آی
اطلاعات پرونده برای دانلود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

پیوند فایل FileURL

روال پیوند فایل(bot: بات، file_path: رشته): رشته
نشانی دانلود پرونده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

دریافت گفتگو GetChat

روال دریافت گفتگو(bot: بات، chat_id: صحیح۶۴): پاسخ ای پی آی
اطلاعات گفتگو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

تعداد اعضای گفتگو GetChatMemberCount

روال تعداد اعضای گفتگو(bot: بات، chat_id: صحیح۶۴): پاسخ ای پی آی
شمار اعضا.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

عضو گفتگو GetChatMember

روال عضو گفتگو(bot: بات، chat_id: صحیح۶۴، user_id: صحیح۶۴): پاسخ ای پی آی
وضعیت یک عضو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

ترک گفتگو LeaveChat

روال ترک گفتگو(bot: بات، chat_id: صحیح۶۴): پاسخ ای پی آی
بات گفتگو را ترک می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

مسدود کردن عضو BanChatMember

روال مسدود کردن عضو(bot: بات، chat_id: صحیح۶۴، user_id: صحیح۶۴): پاسخ ای پی آی
عضو را مسدود می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

رفع مسدودیت عضو UnbanChatMember

روال رفع مسدودیت عضو(bot: بات، chat_id: صحیح۶۴، user_id: صحیح۶۴): پاسخ ای پی آی
مسدودیت را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

تنظیم وب هوک SetWebhook

روال تنظیم وب هوک(bot: بات، url: رشته): پاسخ ای پی آی
نشانی وب‌هوک را تعیین می‌کند تا تلگرام بروزرسانی‌ها را به آن بفرستد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

حذف وب هوک DeleteWebhook

روال حذف وب هوک(bot: بات): پاسخ ای پی آی
وب‌هوک را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دریافت اطلاعات وب هوک GetWebhookInfo

روال دریافت اطلاعات وب هوک(bot: بات): پاسخ ای پی آی
وضعیت وب‌هوک.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دستور بات BotCommand

روال دستور بات(command: رشته، description: رشته): رشته
یک دستور برای منوی بات.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

تنظیم دستورات بات SetMyCommands

روال تنظیم دستورات بات(bot: بات، commands: وکتور<رشته>): پاسخ ای پی آی
منوی دستورهای بات را تعیین می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

دکمه درون خطی InlineButton

روال دکمه درون خطی(text: رشته، callback_data: رشته): رشته
دکمه‌ی درون‌خطی با داده.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

دکمه درون خطی با پیوند InlineButtonURL

روال دکمه درون خطی با پیوند(text: رشته، url: رشته): رشته
دکمه‌ی درون‌خطی با پیوند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

دکمه صفحه کلید KeyboardButton

روال دکمه صفحه کلید(text: رشته): رشته
دکمه‌ی صفحه‌کلید پاسخ.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

ردیف Row

روال ردیف(buttons: وکتور<رشته>): رشته
یک ردیف دکمه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

صفحه کلید درون خطی InlineKeyboardMarkup

روال صفحه کلید درون خطی(rows: وکتور<رشته>): رشته
صفحه‌کلید درون‌خطی از ردیف‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

صفحه کلید پاسخ ReplyKeyboardMarkup

روال صفحه کلید پاسخ(rows: وکتور<رشته>): رشته
صفحه‌کلید پاسخ از ردیف‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

حذف صفحه کلید RemoveKeyboard

روال حذف صفحه کلید(): رشته
صفحه‌کلید پاسخ را برمی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پاسخ اجباری ForceReply

روال پاسخ اجباری(): رشته
کاربر را به پاسخ دادن وامی‌دارد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

دستور است IsCommand

روال دستور است(text: رشته): منطقی
متن با / آغاز می‌شود.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

نام دستور CommandName

روال نام دستور(text: رشته): رشته
نام دستور، بی / و بی @bot.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

آرگومان های دستور CommandArgs

روال آرگومان های دستور(text: رشته): رشته
بقیه‌ی متن پس از دستور.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

حلقه دریافت Poll

روال حلقه دریافت(bot: بات، timeout: صحیح۶۴، handler: روال(بروزرسانی))
حلقه‌ی دریافت: بروزرسانی‌ها را با انتظار طولانی می‌گیرد و برای هر کدام روال را صدا می‌زند؛ برنمی‌گردد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

تنظیم وب هوک با رمز SetWebhookSecret

روال تنظیم وب هوک با رمز(bot: بات، url: رشته، secret_token: رشته): پاسخ ای پی آی
وب‌هوک با رمزی که تلگرام در سرآیند سرآیند راز می‌فرستد؛ با آن درخواست‌های جعلی را رد کنید.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Bot.salam

پاسخ پیام ReplyMessage

روال پاسخ پیام(chat_id: صحیح۶۴، text: رشته): رشته
پاسخ وب‌هوک که پیام می‌فرستد؛ آن را بدنه‌ی پاسخ HTTP کنید تا درخواست جداگانه لازم نباشد.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Webhook.salam

پاسخ پیام با گزینه ها ReplyMessageOptions

روال پاسخ پیام با گزینه ها(chat_id: صحیح۶۴، text: رشته، opts: گزینه های ارسال): رشته
مثل روال بالا، با گزینه‌ها.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پاسخ ویرایش متن پیام ReplyEditMessageText

روال پاسخ ویرایش متن پیام(chat_id: صحیح۶۴، message_id: صحیح۶۴، text: رشته، reply_markup: رشته): رشته
پاسخ وب‌هوک که متن پیام را ویرایش می‌کند.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam

پاسخ فوری پرسمان بازخوان ReplyAnswerCallbackQuery

روال پاسخ فوری پرسمان بازخوان(callback_query_id: رشته، text: رشته، show_alert: منطقی): رشته
پاسخ وب‌هوک به فشردن دکمه.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Webhook.salam

پاسخ کنش گفتگو ReplyChatAction

روال پاسخ کنش گفتگو(chat_id: صحیح۶۴، action: رشته): رشته
پاسخ وب‌هوک با وضعیت گفتگو.

نمونه‌ی این مورد همراه با موارد بالاتر آمده است: telegram-bot-Parse.salam