پست‌های انتشارات توسعه ربات تلگرام

مستندات ربات تلگرام : نوع User

alireza — Sun, 02 Feb 2020 11:41:07 +0330

درچند پست درمورد چندین متد تلگرام مطلب نوشتیم , الان نوبت نوع هاس, داده هایی که برای ما از سمت تلگرام ارسال میشن.شاید بگید بحث متد ها , همه متد هارو کامل توضیح ندادم , دلیلش اینه که بنده دارم طبق مستندات تلگرام پیش میرم و بعد از متد های مربوط به وبهوک درمورد نوع (Types) ها مطلب نوشته , البته ممکنه عنوانی مناسب نباشه و اگه عنوانی مناسب در نظر دارید لطفا بگیدخب بگذریم , نوع User دقیقا چیو به ما نمایش میده ؟اگه یک ذره انگلیسی بلد باشید میدونید User به معنی کاربره پس در نتیجه اطلاعاتی رو که برگشت میده درمورد کاربریه که یک درخواست رو به ربات ارسال کرده.در متن زیر پارامتر های مهمشو نام برده و توضیح دادم :id:این پارامتر از نوع عدد صحیح (Integer) می باشد که بدون شک در هر آپدیت حضور داره و ایدی منحصر به فرد هر کاربره و یکسان هم نیست.is_bot :تعیین میکنه که کاربر ربات یا نه (متاسفانه فقط در ورود و خروج میشه بررسیش کرد در حالت عادی ربات ها همو نمیشناسند) و نوع این این پارامتر بولینه (Boolean) یعنی یا True در بر میگیره یا Falsefirst_name: اسم کوچک کاربر رو نمایش میدهlast_name:اسم بزرگ(فامیلی) کاربر رو نمایش میدهusername:نام کاربری کاربر در صورت ست بودنlanguage_code:کد زبان کاربر رو نمایش میده (برای فارسی Fa نمایش میده)can_join_groups:بررسی میکنه کاربر میتونه عضو گروه بشه یا نه(اگه اشتباه نکنم فقط برای رباته)can_read_all_group_messages: بررسی میکنه کاربر میتونه به پیام های گروه دسترسی داشته باشه یا نه(مخصوص ربات)supports_inline_queries:بررسی میکنه ببینه کاربر میتونه از حالت اینلاین استفاده کنه یا خیراما نوع User کجا دریافت میشه ؟ این نوع زیر مجموعه نوع هایی مانند Message می باشد که در خروجی وجود داره و User اغلب در پارامتر from نوع Message میشه مشاهده کردش.برای درک بهتر تصاویر زیر رو نگاه کنید :اگه خوندن Json رو بلد باشید متوجه میشید که from زیر مجموعه Message هستش, پارامتر های From همون نوع User ما هستش.به نمونه دوم هم دقت کنید :اگه به عکس دقت کنید new_chat_participant و new_chat_member و new_chat_members هم پارامتر های User رو داره پس در نتیجه User فقط در From به کار نمیره.اما به طور کلی User زیر مجموعه کدوم پارامتر ها هستش؟ برای یافتن این جواب باید به آدرس https://core.telegram.org/bots/api#update برید و روی Type تک تک پارامتر های Update کلیک کنید و ببینید پارامتر های موجود در نوع کلیک کرده چه نوع هستند.برای مثال در عکس زیر پارامتر های Message رو مشاهده می کنید:همانطور که در عکس می بینید دو نوع User و Chat به چشم میخورن اما در پایین تر نوع های بیشتری هم هستند که برای مشاهده یک سر به مستندات خود تلگرام بزنید.امیدوارم از این مطلب بهره برده باشید.پست های مرتبط :آموزش ساخت ربات تلگراممستندات ربات تلگرام : وبهوک و دریافت بروزرسانیمستندات ربات تلگرام : متد getUpdatesمستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfoمستندات ربات تلگرام : پارامتر های آپدیت

مستندات ربات تلگرام : پارامتر های آپدیت

alireza — Sun, 02 Feb 2020 11:36:31 +0330

در هر آپدیت ( Update ) یک سری پارامتر هایی برای ما ارسال میشن که لیست پارامتر هارو میتونید در https://core.telegram.org/bots/api#update مشاهده کنید.این پارامتر ها , پارامتر های دیگری رو در زیر مجموعه دارند.برای مثال در پارامتر message طبق توضیحاتی که در https://core.telegram.org/bots/api#message داده شده دارای چندین پارامتر دیگری هست که باز هم برخی از پارامتر های اون تشکیل شده از اجزای برخی نوع های دیگه هستنبرای مثال پارامتر From موجود در message تشکیل شده از نوع User می باشد.یعنی اینکه اجزای پارامتر From موجود در message از اجزای User تشکیل شده است. (User در خروجی نمایش داده نمیشه و فقط اجزایش در پارامترهای دیگه نمایش داده میشه)بالاترین مجموعه در خروجی ما مجموعه Update هستش که میتونید در لینک https://core.telegram.org/bots/api#update زیرمجموعه هاشو ببینید.با کلیک برروی Type هر پارامتر مجموعه Update, میتونید زیرمجموعه های مربوطه رو ببینید.میدونم الان مغزتون سوت میزنه و گیج شدید پس به عکس زیر توجه کنید:کل اجزای موجود در عکس زیر مجموعه ی بالاترین مجموعه ما هستن یعنی Update به زبان ساده هر آپدیتی برای ما ارسال میشه میتونه شامل پارامتر های در تصویر باشه و نکته ی دیگه اینکه همه ی پارامتر های در تصویر در هر آپدیت ارسال نمیشن و بسته به نوع پیام کاربر این پارامتر ها برای ما ارسال میشن.برای نمونه من یک پیام به ربات ارسال کردم و ساختار آپدیت دریافتی به شکل زیر هستش : همانطور که میبینید ما دو پارامتر در مجموعه Update داریم که دو مجموعه ی update_id و message هستن که در این میان باید بدونید که update_id در هر آپدیت وجود داره.بعداز این به message دقت کنید , در message مجموعه هایی وجود داره که شاملmessage_id و from و chat و date و text هستش.باز هم اگه دقت کنید from و chat هم زیرمجموعه دارند.این مجموعه تو مجموعه ها رو میتونید در مستند های تلگرام نگاه کنید اما بنده در پست های آینده درمورد پارامتر های موجود در هر آپدیت مطلب خواهم نوشت.اگه نظری سوالی دارید لطفا در بخش کامنت ها مطرح کنید و امیدوارم به بهترین شکل توضیح داده باشم که لپ مطلب رو متوجه شده باشید.آموزش ساخت ربات تلگراممستندات ربات تلگرام : وبهوک و دریافت بروزرسانیمستندات ربات تلگرام : متد getUpdatesمستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfoمستندات ربات تلگرام : نوع User

مستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfo

alireza — Fri, 31 Jan 2020 12:14:12 +0330

در پست مستندات ربات تلگرام : وبهوک و دریافت بروزرسانی درمورد دو نوع حالت دریافت آپدیت نوشتیم.اما در روش وبهوک چطور میتونیم به تلگرام بفهمونیم آپدیت هارو به کدوم آدرس ارسال کنه ؟تلگرام علم غیب نداره که در روش وبهوک باید به کدوم آدرس آپدیت هارو ارسال کنه, در این زمان ما باید آدرسی رو به تلگرام ارسال کنیم که به اصطلاح بهش میگیم ست وبهوک(setWebhook) کردن.برای ست کردن وبهوکمون باید از متد setWebhook استفاده کنیم.روش کلی نحوه ارسال درخواست رو در آخر پست مستندات ربات تلگرام : وبهوک و دریافت بروزرسانی توضیح داده ام و اگر نمیدونید چطور درخواستی رو ارسال کنید این پست رو بخونید.متد setWebhook یک پارامتر اجباری و 3 پارامتر غیر اجباری داره که مهم هاشو در زیر نام می برم :url:این پارامتر برای ارسال آدرس سورس ربات استفاده میشه و حتما هم باید دارای گواهی ssl یا به زبان ساده پروتکل https برای این آدرس فعال باشه.allowed_updates :این پارامتر هم قبلا در مستندات ربات تلگرام : وبهوک و دریافت بروزرسانی باهاش آشنا شده اید , کارکرد این پارامتر مانند پارامتر متد getUpdates می باشد.متد بعدی که میخوام درموردش توضیح بدم متد deleteWebhook می باشد.کار این متد اینه که وبهوک فعلی رو حذف می کنه , وبهوکی رو که با متد setWebhook ست کرده اید رو حذف و نحوه دریافت آپدیت هارو به متد getUpdates سوئیچ میکنه.متد بعدی متد getWebhookInfo ء کار این متد اینه که اطلاعات وبهوک جاری رو در صورت ست بودن نمایش میده , خروجی این متد شامل ,max_connections,allowed_updates,url,pending_update_count,last_error_date,last_error_message می باشد که مهم ترین هاشو در متن زیر توضیح میدم :pending_update_count:یکی از مهم ترین خروجی این متد , این پارامتر می باشد که وقتی تلگرام نتونه ارتباط درستی رو با آدرس سورس پیدا کنه درخواست هارو ذخیره میکنه تا بعدا دوباره ارسال کنه, تعداد موجود در این پارامتر تعداد درخواست های فریز شدست یعنی همون درخواست هایی رو که در زمان وقوع مشکل ذخیره کرده تا بعدا بفرسته.last_error_date:این خروجی زمان آخرین خطا در ارتباط با ربات رو نمایش میدهlast_error_message:این خروجی آخرین پیام خطا در ارتباط با ربات رو نمایش میدهallowed_updates:اینم که احتمالا آشنایی دارید , در ست وبهوک اگه مقداری تنظیم کرده باشید اون مقدار رو برمیگردونه.امیدوارم این مطلب هم برای شما مفید بوده باشه.پست های مرتبط :آموزش ساخت ربات تلگراممستندات ربات تلگرام : وبهوک و دریافت بروزرسانیمستندات ربات تلگرام : متد getUpdates

مستندات ربات تلگرام : متد getUpdates

alireza — Wed, 29 Jan 2020 10:39:03 +0330

همانطور که در پست های قبل گفته شد, این متد برای دریافت آپدیت های ربات استفاده میشه.با هربار ارسال درخواست با متد getUpdates به تلگرام شما یک آرایه دریافت می کنید.این آرایه شامل تمامی بروز رسانی های دریافت شده ربات می باشد مانند اطلاعات فایل ها,اطلاعات چتی که این آپدیت ارسال شده و... که مهم ترین بخش این آرایه update_id می باشد که در ادامه درمورد اهمیت این پارامتر اطلاعات بیشتری کسب خواهید کرد.همانطور که اگه به مستند های تلگرام سر زده باشید , این متد 4 پارامتر اختیاری داره ( به ستون Required دقت کنید , Optional به معنی اختیاری می باشد) که در زیر ما به توضیح اونها می پردازیم :offset:مقداری که این پارامتر میگیره (در ستون Type تعیین شده) یک عدد صحیح هستش , اگر داده ای به این پارامتر ارسال کنید, آپدیت هارو از داده ی ارسالی به بعد دریافت خواهید کرد.اما ما باید چه دادی برای این پارامتر ارسال کنیم؟ طبق توضیحات خود تلگرام شما باید update_id آپدیتی که میخواهید آپدیت های بعد از آن نمایش داده بشه رو ارسال کنید.یعنی اگه آپدیت ایدی ما 1 تا 456 باشه ما ایدی 100 رو ارسال کنیم خروجی از آپدیت 100 تا 456 خواهد بود و آپدیت های قبلی منسوخ خواهد شد.limit:به طور ساده با ارسال یک عدد صحیح به این پارامتر تعیین می کنیم چه تعداد خروجی برای ما نمایش بده و عددی که میگیره حتما باید بین 1 تا 100 باشه , به طور پیشفرض این عدد روی 100 می باشد.برای مثال اگه من عدد 20 رو ارسال کنم خروجی من 20 تا آپدیت می باشد.timeout:مدت زمانی است که منتظر درخواست میمونهallowed_updates:با استفاده از این پارامتر تعیین می کنید که چه آپدیت هایی را دریافت کنید.برای ارسال اطلاعات به این پارامتر میتونید به دو شکل آرایه و استرینگ اطلاعات رو پاس بدید ولی دقت کنید اطلاعات شما باید به صورت json باشهمنظور ما از چه اپدیت هایی پارامتر های Update دریافتی می باشد که شامل message , edited_message و.. می شود که ما تعیین می کنیم کدوم از اینهارا میخواهیم دریافت کنیم.ما به طور پیشفرض تمامی آپدیت هارو دریافت می کنیم.امیدوارم از این مطلب بهره برده باشید اگه سوالی داشتید توی کامنت ها یا از این لینک در تلگرام سوالتونو مطرح کنید.موفق باشید.پست های مرتبط :آموزش ساخت ربات تلگرام مستندات ربات تلگرام : وبهوک و دریافت بروزرسانیمستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfo

مستندات ربات تلگرام : وبهوک و دریافت بروزرسانی

alireza — Mon, 27 Jan 2020 14:13:38 +0330

نکته : برای خواندن قسمت قبل ( آموزش ساخت ربات تلگرام ) روی نوشته کلیک کنید.اگه تازه کار باشید و پست قبلی بنده رو خونده باشید حتما براتون سوال پیش اومده , خب ربات رو ساختیم , چرا کار نمی کنه ؟ دلیلش اینه که شما فقط یک ربات خام رو ساختید.برای اینکه بتونید داده هارو پردازش و دستوراتی رو ارسال و دریافت کنید یا باید برنامه نویسی کنید یا از سرویس های ربات ساز استفاده کنید.از اونجایی که مطلب ما درمورد برنامه نویسی هستش پس درمورد ربات ساز توضیحی نمی دیم.برای اینکه کاربر از ربات ما جوابی دریافت کنه , نیاز داریم داده ارسالی توسط کاربر رو دریافت کنیم.تلگرام دو راه رو برای دریافت آپدیت(بخونید داده) برای ما پیشنهاد کرده. یکی getUpdates هست و یکی وبهوک (Webhook) حالا چه فرقی باهم دارن ؟در getUpdates شما باید هربار یک درخواست ارسال کنید تا آپدیت هارو دریافت کنید و خروجی اون یک آرایه به صورت json می باشد مانند تصویر :(پارامترهای تصویر رو در آخر توضیح میدم)در تصویر بالا من از قبل چند متن برای ربات ارسال کردم و با استفاده از یک درخواست پیام هارو دریافت کردم. همانطور که می بینید result در تصویر بالا 5 آرایه داره که پیام های ربات هستند و من یکی از پیام هارو برای شما به نمایش گذاشتم.اما وبهوک چیه ؟ در روش وبهوک , ما یک آدرس رو برای تلگرام ارسال می کنیم که آپدیت هارو به اون بفرسته.هروقت کاربری متن و سایر پیام هارا به ربات ارسال میکنه دیگه نیاز نیست ما هربار یک درخواست به تلگرام ارسال کنیم.تلگرام خودش برطبق آدرسی که ما تعیین کردیم آپدیت هارو میفرسته.چه داده هایی برای ما ارسال میشه ؟این داده ها(پارامترها) در وبهوک و getupdate یکیه و به صورت json برای ما ارسال خواهد شد.برای مشاهده پارامتر هایی که برای ما ارسال میشن به لینک https://core.telegram.org/bots/api#update سر بزنید.در ادامه برخی از فیلدهایی که دریافت می کنیم رو براتون توضیح دادم.update_id:این پارامتر یک شناسه غیرتکراری و عدد صحیح برای هر آپدیت هستش message:این پارامتر اطلاعات پیام مانند متن,ایدی کاربر و.. نمایش میدهedited_message:موقعی که یک پیام ویرایش بشه این پارامتر ارسال میشه.channel_post:موقعی که یک پیام در کانال ارسال بشه این پارامتر ارسال میشه.edited_channel_post:موقعی که یک پیام در کانال ویرایش بشه این پارامتر ارسال میشهinline_query:موقعی که درخواست به صورت اینلاین ارسال بشه این پارامتر برای شما فرستاده خواهد شد.callback_query:موقعی که روی دکمه شیشه ای ضربه ای زده بشه این پارامتر برای شما ارسال خواهد شد.poll:هروقت پیامی نظرسنجی باشه این پارامتر برای شما ارسال میشهpoll_answer:پاسخ های نظرسنجی هستش.نحوه کار با متد های تلگرام برای ارسال درخواست به تلگرام مانند توضیحی که خود تلگرام داده : https://core.telegram.org/bots/api#making-requests ساختار کلی درخواست به شکل :https://api.telegram.org/bot/METHOD_NAMEهستش که به جای توکن خودمان و به جای METHOD_NAME نام متد رو قرار میدیم.برای مشاهده متد های تلگرام به آدرس https://core.telegram.org/bots/api#available-methods سر بزنید.یکی از نمونه متدی که در این مطلب بااون آشنا شدید متد getupdate هستش که شکل درخواست این متد مانند شکل زیر هست :https://api.telegram.org/bot/getupdateهرمتد هم شامل پارامتر هایی هست که یا اجباری هستند یا اختیاری یعنی اینکه اگر اجباری بود باید اون پارامتر رو ارسال کنید.در پست های بعدی درمورد هر متد توضیح خواهم داد.پست های مرتبط : آموزش ساخت ربات تلگرام مستندات ربات تلگرام : متد getUpdatesمستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfo

آموزش ساخت ربات تلگرام

alireza — Mon, 27 Jan 2020 10:43:08 +0330

با سلام خدمت دوستان , میدونم این نمونه پست زیاد وجود داره اما بنده بر طبق انتشارات میخوام پیش برم پس در اولین قدم باید به مخاطب یاد بدم چطور یک ربات بسازه.برای ساخت ربات ابتدا به @botfather برید .بعد از استارت کردن ربات دستور /newbot رو ارسال کنیدبعد از دیدن متن در عکس بالا یک متن برای عنوان رباتتون ارسال کنید.بعد از ارسال متن عنوان ربات , نوبت ارسال یک متن برای نام کاربری رباته.دقت کنید آخر متن شما باید کلمه bot نوشته شده باشه و اینکه حتما متن شما به صورت انگلیسی باشهاگه مراحل رو درست انجام داده باشید یک متن مانند متن بالا برای شما ارسال خواهد شد.در این متن توکنی برای کار با ربات برای شما ارسال میشه که باید مواظب باشید توکن شما به دست کسی نیوفته.برخی از دستورات بات فادر :/mybots :برای دریافت لیست ربات ها و مدیریت آن ها استفاده میشه./mygames:لیست بازی ها و مدیریت آنها استفاده میشه/token :برای دریافت توکن یک ربات استفاده میشه/revoke :برای ساخت توکن جدید یک ربات استفاده میشه/setname :برای قرار دادن نام جدید استفاده میشه/setdescription:برای قراردادن توضیحات ربات استفاده میشه/setabouttext:برای قراردادن توضیحات در پروفایل ربات استفاده میشه/setuserpic:برای قرار دادن عکس پروفایل استفاده میشه/setinline :برای فعال کردن حالت اینلاین استفاده میشه , اگه به ربات هایی مانند like دقت کرده باشید موقع ارسال نظرسنجی در یک چت اول ایدی اون ربات تایپ میشه بعد یک متن که ربات شروع به جستجو میکنه , با فعال کردن حالت اینلاین شما میتونید از این حالت استفاده کنید./setinlinegeo :اگه درست درمورد این دستور خونده باشم هنگام ارسال درخواست اینلاین میتونید لوکیشن یا مکان کاربر را درخواست کنید/setinlinefeedback:با فعال کردن فیدبک میتونید هنگام ارسال یک نتیجه در حالت اینلاین اون نتیجه رو مشاهده کنید./setcommands:برای ساخت دستور استفاده میشه/setjoingroups:با ارسال این دستور انتخاب می کنید که کاربران می توانند ربات رو به گروه اضافه کنند یا خیر/setdomain:برای ست کردن یک آدرس اینترنتی به ربات استفاده میشه, این دستور برای ساخت ورود از طریق تلگرام کاربرد داره./setprivacy:با ارسال این دستور انتخاب می کنید ربات میتونه پیام های گروه رو بخونه یا خیر/deletebotاین دستور برای حذف یک ربات استفاده میشه.امیدوارم از این مطلب بهره برده باشید , اگه سوالی داشتید کامنت کنید یا اگه خواستید از طریق تلگرام پیام بدید روی این (متن) کلیک کنیددر پست های بعدی درمورد مستندات تلگرام توضیحاتی رو براتون می نویسمپست های مرتبط :مستندات ربات تلگرام : وبهوک و دریافت بروزرسانیمستندات ربات تلگرام : متد getUpdatesمستندات ربات تلگرام : متد های setWebhook ,deleteWebhook,getWebhookInfo