- کار با API های تلگرام :
بعد از مطالعه دو قسمت قبل وقت آن رسیده که اولین پیام را بوسیله ربات برای خود و دیگر کاربرانتان ارسال کنید ، برای این منظور ما در این قسمت نحوه کار با دو متد getUpdates و sendMessage را آموزش میدهیم.
برای شروع ، شما ابتدا باید با دستور ارسال پیام بوسیله ربات در تلگرام آشنا شوید و بتوانید بدون یک خط برنامه نویسی ، توانایی ارسال پیام متنی (البته فعلا) به کاربر را داشته باشید ، برای ارسال پیام متنی بوسیله ربات شما دو پارامتر را لازم دارید که به متد ارسال پیام بدهید (sendMessage) ، این دو پارامتر به ترتیب chat_id و text هستند که text همان پیام متنی شما برای ارسال است و chat_id چیست ؟!
chat_id :
درواقع chat_id ، ای دی منحصر به فردی (primaryKey) است که برای هر حساب کاربری در تلگرام تعریف شده است ، لازم است بگویم این chat_id با شماره تلفن و یوزرنیم (همان به اصطلاح ای دی هایی که با کاراکتر @ تعریف شده اند) متفاوت است و حتی پس از حذف حساب کاربری (Delete Account) هم از بین نمیرود ! برای بدست آوردن chat_id دو راه را پیشنهاد میکنم ، راه اول استفاده از متد getUpdates تلگرام است که در ادامه به آن می پردازیم و راه دوم استفاده از ربات ForwardConverter_bot است که به سادگی می توانید به chat_id خودتان دست پیدا کنید.
کار با متد getUpdates :
خب وقت آن رسیده پیام های دریافت شده بوسیله ربات خود را مشاهده کنید ، برای این کار شما نیاز به داشتن Token ربات خود (در قسمت دوم نحوه دریافت توکن را توضیح دادیم) می باشید ، با وارد کردن آدرس زیر در مرورگر خود :
https://api.telegram.org/bot<-Token->/getupdatesو جایگزین کردن Token ربات خود با مقدار <-Token-> ، به چنین خروجی بر میخورید ! (البته اگر کسی start نکرده باشد)
{
"ok": true,
"result": []
}و بعد از start ربات ، خروجی مانند زیر است :
{
"ok": true,
"result": [
{
"update_id": 282474990,
"message": {
"message_id": 13,
"from": {
"id": 116589236,
"is_bot": false,
"first_name": "Mohammad",
"last_name": "Zarchi",
"language_code": "en-US"
},
"chat": {
"id": 116589236,
"first_name": "Mohammad",
"last_name": "Zarchi",
"type": "private"
},
"date": 1536464070,
"text": "/start",
"entities": [
{
"offset": 0,
"length": 6,
"type": "bot_command"
}
]
}
}
]
}شاید این خروجی برای شما تا حدودی نا مفهوم باشد ، اما ما در این قسمت قصد تحلیل بررسی این خروجی که از نوع جیسون (json) را نداریم و فقط قصد بدست آوردن chat_id را داریم تا بتوانیم بوسیله مرورگر برای خودمان یک پیام ساده ارسال کنیم. برای بدست آوردن chat_id از روی این خروجی باید به قسمتی از خروجی بالا که در زیر دوباره بازنویسی شده توجه کنید :
"chat": {
"id": 116589236,
"first_name": "Mohammad",
"last_name": "Zarchi",
"type": "private"
}مقدار فیلد id در واقع همان chat_id است که ما از آن صحبت می کردیم ، حال وقت آن است که با استفاده از متد sendMessage یک پیام ساده برای خود ارسال کنیم.
کار با متد sendMessage :
همانطور که ابتدای صحبت گفته شد این متد دو پارامتر ضروری دارد که به ترتیب chat_id و text است که برای ارسال پیام به کار میرود ، که هم اکنون chat_id را در اختیار داریم (البته فعلا چت ای دی خودمون ?) ، پارامتر دوم text یک مقدار دلخواه است و هر نوع متن (به هر زبانی) را شامل می شود ، در نهایت با داشتن این متد و پارامترهایش برای ارسال پیام بوسیله مرورگر به طریق زیر عمل میکنیم :
https://api.telegram.org/bot<-Token->/sendMessage?chat_id=116589236&text=Hiبا دقت به آدرس بالا و دو پارامتر chat_id و text خواهید فهمید که چگونه با استقاده از متد sendMessage به کاربر پیام ارسال شد ، خروجی آدرس بالا در صورت موفقیت آمیز بودن ، مانند خروجی زیر است :
{
"ok": true,
"result": {
"message_id": 14,
"from": {
"id": 595663424,
"is_bot": true,
"first_name": "Test Telegram API",
"username": "TestTelegramMethodes_bot"
},
"chat": {
"id": 116589236,
"first_name": "Mohammad",
"last_name": "Zarchi",
"type": "private"
},
"date": 1536465206,
"text": "Hi"
}
}تبریک ! شما تا این مرحله توانستید بوسیله ربات برای خود یک پیغام (هر چند ساده مانند Hi) ارسال کنید ، در قسمت بعد به تحلیل و بررسی خروجی ها و ساخت ربات آینه می پردازیم.
پایان قسمت سوم
موفق باشید.
