یکی از مهم ترین و حساس ترین مراحل در راه اندازی هر ربات تلگرام، اتصال فایل سورس به سرورهای تلگرام از طریق وب هوک (Set Webhook) است. وب هوک در واقع پلی است که پیام های ارسالی کاربران در تلگرام را بلافاصله به فایل اجرایی ربات شما روی هاست تحویل می دهد و پاسخ ربات را به کاربر برمی گرداند.
بسیاری از کاربران و توسعه دهندگان پس از آپلود سورس ربات روی هاست، با خطاهایی مانند کار نکردن ربات، عدم پاسخ گویی دکمه ها یا ارورهای امنیتی SSL مواجه می شوند. در این مقاله آموزشی کاربردی، به صورت گام به گام یاد می گیرید که چگونه وبهوک ربات تلگرام را به درستی ست کنید، چگونه وضعیت اتصال را بررسی کنید و خطاهای رایج را در چند دقیقه برطرف نمایید.
برای دریافت پیام ها از تلگرام دو روش وجود دارد: روش پایش مداوم (Polling) و روش وب هوک (Webhook). در اکثر سورس های نوشته شده با زبان PHP، روش وب هوک به کار می رود. در این روش، شما آدرس اینترنتی فایل ربات خود روی هاست را به تلگرام معرفی می کنید؛ از آن لحظه به بعد، به محض اینکه کاربری به ربات پیام دهد، سرور تلگرام به صورت آنی آن پیام را به هاست شما ارسال می کند.
قبل از اینکه دستور ست کردن وبهوک را اجرا کنید، حتما موارد زیر را روی هاست خود بررسی فرمایید:
index.php، bot.php یا run.php در هاست قرار دارد.برای ست کردن دستی وب هوک، کافی است از دستور استاندارد API تلگرام در نوار آدرس مرورگر خود استفاده کنید:
فرمول کلی دستور به شکل زیر است:
https://api.telegram.org/bot<TOKEN>/setWebhook?url=<BOT_URL>در فرمول بالا:
<TOKEN>، توکن ربات خود را که از BotFather دریافت کرده اید قرار دهید (دقت کنید عبارت bot قبل از توکن باید بماند).<BOT_URL>، آدرس دقیق فایل ربات خود روی هاست را با پیشوند https وارد کنید.یک مثال واقعی:
https://api.telegram.org/bot123456789:ABCdefGhIJKlmNoPQRsT/setWebhook?url=https://yourdomain.com/bot.phpپس از فشردن کلید اینتر در مرورگر، اگر همه چیز درست باشد پیامی با فرمت JSON دریافت می کنید:
{"ok":true,"result":true,"description":"Webhook was set"}مشاهده عبارت "ok":true به این معنی است که وبهوک با موفقیت متصل شده است.
اگر ربات شما پیام ها را دریافت نمی کند یا مطمئن نیستید وبهوک فعال است یا خیر، می توانید از متد getWebhookInfo استفاده کنید:
https://api.telegram.org/bot<TOKEN>/getWebhookInfoخروجی این دستور اطلاعات بسیار مهمی به شما می دهد:
url: آدرسی که در حال حاضر به عنوان وبهوک ست شده است.has_custom_certificate: وضعیت گواهی امنیتی.pending_update_count: تعداد پیام هایی که در صف منتظر پاسخ سرور شما هستند (اگر این عدد بزرگ باشد، یعنی هاست شما در پردازش پیام ها کند است).last_error_message: متن آخرین خطایی که تلگرام هنگام ارسال پیام به هاست شما دریافت کرده است.اگر نمی خواهید هر بار آدرس های طولانی API تلگرام را در مرورگر تایپ کنید یا نگران اشتباه در وارد کردن توکن و لینک وبهوک هستید، بهترین و امن ترین ابزار برای شما ربات تلگرام وبهوکیو (WebhookioBot@) است.
وبهوکیو یک دستیار کاملا رایگان، تخصصی و فوق العاده سریع برای تمام توسعه دهندگان و دارندگان ربات های تلگرام است که تمام عملیات های مربوط به وب هوک را در قالب دکمه های شیشه ای و با چند کلیک ساده انجام می دهد.
اگر تلگرام خطای گواهی SSL داد، یعنی یا روی دامنه شما گواهی امنیتی نصب نیست، یا از گواهی های خودامضا نامعتبر استفاده کرده اید. نصب گواهی رایگان لیتس انکریپت از طریق سی پنل یا کلودفلر این مشکل را حل می کند.
این خطا نشان می دهد تلگرام آدرس فایل شما را پیدا نکرده (۴۰۴) یا کدهای داخل فایل PHP دارای ارور برنامه نویسی و دیتابیس هستند (۵۰۰). حتما مطمئن شوید فایل در مسیر درستی از هاست (پوشه public_html) آپلود شده است.
در صورتی که هاست شما به دفعات مکرر خطای قطعی دهد، تلگرام موقتا ارتباط با سرور را محدود می کند. استفاده از هاست های پایدار و ضد فیلتر مخصوص ربات تلگرام بهترین راه حل برای جلوگیری از این مشکل است.
ست شدن وبهوک فقط به معنای تایید آدرس توسط تلگرام است. اگر ربات پاسخی نمی دهد، علت آن خطای اتصال دیتابیس، ارور در فایل های پی اچ پی یا عدم فعال سازی دکمه ها در کدهای سورس است.
با ارسال دستور deleteWebhook در مرورگر می توانید وبهوک قبلی را به طور کامل پاک کنید.
ست کردن وب هوک گام نهایی برای به جریان انداختن زندگی در رگ های ربات تلگرام شماست. با رعایت استانداردهای SSL و دقت در مسیردهی فایل ها، می توانید اتصالی پایدار و بدون وقفه ایجاد کنید. اگر به دنبال تجربه ای بی دغدغه و راه اندازی آسان در چند دقیقه هستید، محصولات آماده و تست شده سورس یو با راه انداز هوشمند، بهترین همراه شما در این مسیر خواهند بود.
تمام سورس های فروشگاه سورس یو بر اساس آخرین متدهای رسمی وبهوک تلگرام برنامه نویسی شده اند و بدون هیچ خطایی روی انواع هاست های لینوکسی فعال می شوند:
تیم تولید محتوای سورس یو با افتخار تقدیم میکند