رفع خطای 429 ربات تلگرام؛ retry_after و مدیریت صف پیام

خطای 429 ربات تلگرام یعنی باید اول منشأ پاسخ و زمان مجاز تکرار را بررسی کنید. اگر پاسخ Bot API زمان انتظار دارد، آن را در صف ثبت کنید و فقط همان اعلان را ب…

دسته‌بندیمیزبانی وبنویسندهوطن هاستتاریخ انتشارزمان مطالعه۲۷ دقیقه

خطای 429 ربات تلگرام یعنی باید اول منشأ پاسخ و زمان مجاز تکرار را بررسی کنید. اگر پاسخ Bot API زمان انتظار دارد، آن را در صف ثبت کنید و فقط همان اعلان را بعد از موعد دوباره بررسی کنید؛ عملیات موفق کاربر را از اول اجرا نکنید.

فهرست مطالب

اولین تصمیم بعد از دیدن 429

اگر هنگام ارسال پیام با خطای 429 ربات تلگرام روبه‌رو شدید، کار ارسال را همان لحظه تکرار نکنید. ابتدا مشخص کنید پاسخ از خود Bot API آمده یا یک واسطه مثل پراکسی آن را ساخته است. اگر پاسخ Bot API شامل parameters.retry_after است، آن عدد می‌گوید پیش از تکرار همان درخواست چند ثانیه باید صبر کنید. پیام موردنیاز را در صف نگه دارید، زمان مجاز تلاش بعدی را ثبت کنید و اجازه ندهید هر پردازشگر جداگانه همان پیام را دوباره بفرستد. بعد بررسی کنید آیا مشکل فقط در یک گفت‌وگو، در یک نوع اعلان یا در چند مسیر مستقل دیده می‌شود. این شواهد برای تصمیم درباره توقف محدود یا عمومی از حدس درباره ظرفیت سرویس مفیدترند.

این راهنما برای رباتی است که به کاربران مجاز خود پیام عملیاتی می‌دهد: تأیید سفارش، وضعیت یک تیکت، نتیجه کاری که کاربر درخواست کرده یا یادآوری مورد انتظار او. هدف آن دور زدن سیاست تلگرام یا فرستادن پیام به مخاطبان ناخواسته نیست. طراحی خوب باید با کمترین تعداد پیام کار را انجام دهد و وقتی محدودیت رخ می‌دهد، صبر کند. اگر به کاربر گفته‌اید ربات هر تغییر کوچک را جداگانه گزارش می‌کند، شاید اولین اصلاح اصلاً فنی نباشد: مشخص کنید کدام اعلان مفید است و کدام فقط منتظر ماندن را برای کاربر طولانی‌تر می‌کند.

خطای 429 را با سریع‌تر فرستادن درخواست حل نمی‌کنیم؛ باید معلوم باشد کدام کار باید منتظر بماند و چه زمانی دوباره اجازه اجرا دارد.

تفاوت محدودیت خروجی و مشکل دریافت رویداد

Webhook و getUpdates راه‌هایی برای گرفتن رویدادهای ورودی هستند؛ ارسال پاسخ یک مرحله جداگانه است. تصور کنید ربات پیام خرید را دریافت و سفارش را ثبت کرده، اما وقتی می‌خواهد رسید بفرستد، پاسخ 429 می‌گیرد. دوباره ثبت کردن خود سفارش در این وضعیت اشتباه است. کار اصلی و اعلان را جدا نگه دارید و به صف بگویید فقط ارسال همان اعلان هنوز کامل نشده است. در سوی دیگر، اگر رویداد اصلاً به برنامه نرسیده باشد، ساخت صف خروجی علت را برطرف نمی‌کند. برای آن شاخه، راهنمای بررسی پاسخ ندادن ربات تلگرام را ببینید.

اختلاف ورودی و خروجی در لاگ هم باید دیده شود. اگر سامانه فقط یک پیام «ربات پاسخ نداد» ثبت کند، اپراتور نمی‌داند آیا تلگرام درخواست ورودی را تحویل نداده، آیا برنامه آن را پردازش نکرده یا آیا مرحله ارسال پاسخ معطل شده است. برای هر عملیات، زمان دریافت، زمان ثبت کار و نتیجه ارسال را جداگانه یادداشت کنید. بین این سه از یک شناسه داخلی مشترک استفاده کنید تا ردگیری آسان شود. لازم نیست متن پیام یا اطلاعات مشتری در لاگ تکرار شود؛ شناسه مصنوعی یا محدود به همان سامانه و یک دسته‌بندی درست از رخداد کافی است.

نمونه تشخیص با یک پیام آزمایشی

فرض کنید کاربر دکمه «وضعیت سفارش» را می‌زند. در محیط آزمایشی می‌بینید درخواست در ثبت ورودی آمده، برنامه شناسه درخواست را شناخته و نتیجه را تولید کرده است. اگر مرحله ارسال پاسخ JSON خطای 429 و زمان انتظار بدهد، مسیر تشخیص به جدول یا صف ارسال می‌رسد. اگر در مقابل از سرویس محلی وب‌هوک یک صفحه HTML خطا گرفته‌اید و هیچ پاسخ ساخت‌یافته‌ای از Bot API ثبت نشده، آن 429 لزوماً محدودیت خروجی تلگرام نیست. بررسی تنظیمات پراکسی مجاز خودتان و فایل ثبت رخداد لایه واسط مسیر روشن‌تری است.

نشانه دیگر پیام این است که کاربر نتیجه‌ای را در خود وب‌سایت می‌بیند، ولی در تلگرام پیام تازه ندارد. در چنین حالتی برای کاربر روشن کنید وضعیت تکمیل کار با وضعیت رسیدن اعلان یکی نیست. برچسب «در انتظار ارسال» در ابزار داخلی بهتر از «سفارش ناموفق» است. اگر همان ایمیل یا پیام از مسیر دیگری نیز می‌رود، هماهنگ کنید ارسال جایگزین خودش منشأ تکرار نشود. وقتی چند کانال اعلان دارید، ترجیح کاربر و ضرورت اطلاع‌رسانی باید در تصمیم روشن باشد، نه صرفاً اینکه کدام مسیر در آن لحظه در دسترس است.

نشانه برداشت اولیه بررسی امن
پاسخ JSON همراه retry_after تلگرام برای آن درخواست زمان انتظار داده است ثبت زمان پاسخ و برنامه‌ریزی مجدد
پاسخ HTML با 429 ممکن است پاسخ از واسطه باشد بررسی مقصد واقعی و لاگ پراکسی خودتان
ورودی اصلاً ثبت نشده مشکل پیش از صف خروجی است آزمون مسیر دریافت با پیام کنترل‌شده
عملیات ثبت شده ولی رسید نرسیده خطای اعلان لزوماً خطای عملیات نیست پیگیری شناسه داخلی اعلان بدون ثبت دوباره عملیات

 

retry_after را چگونه به تصمیم اجرایی تبدیل کنیم؟

عدد انتظار را از پاسخ واقعی بخوانید

طبق مستندات رسمی Telegram Bot API، retry_after در صورت برخورد با کنترل نرخ، زمان باقی‌مانده تا امکان تکرار درخواست را بر حسب ثانیه اعلام می‌کند. عدد را از فیلد ساخت‌یافته پاسخ یا مسیری که کتابخانه برای همان خطا ارائه می‌دهد بخوانید. تکیه به جست‌وجوی یک جمله در توضیح خطا شکننده است و در چند زبان یا چند نسخه کتابخانه ممکن است اشتباه کند. خطای نمونه را با پاسخ واقعی مشتری اشتباه نگیرید؛ برای تست واحد می‌توانید خطای ساختگی با مقدار دلخواه بسازید و ببینید آیا نتیجه طبق انتظار در آینده زمان‌بندی می‌شود.

زمان مجاز را بر اساس زمان دریافت پاسخ محاسبه کنید، نه لحظه‌ای که اولین درخواست را ساخته‌اید. ممکن است بین فرستادن، پردازش در شبکه و دریافت پاسخ فاصله افتاده باشد. در یک مثال ساختگی اگر پاسخ ساعت ۱۲:۰۰:۰۲ دریافت شود و انتظار ۱۵ ثانیه باشد، درخواست نباید قبل از ۱۲:۰۰:۱۷ دوباره فرستاده شود. چند ثانیه دیرتر برای هماهنگ کردن صف ممکن است قابل قبول باشد؛ زودتر فرستادن عمداً دستور انتظار را نادیده می‌گیرد. اعداد این مثال آزمایشی‌اند و درباره سقف واقعی حساب یا بستر میزبانی چیزی نمی‌گویند.

اگر مقدار انتظار موجود نبود چه کنیم؟

اول بررسی کنید پاسخ واقعاً از همان سرویس آمده است و کتابخانه داده خام لازم را پنهان نکرده است. اگر زمان انتظار معتبر ندارید، برای یک اعلان عملیاتی از یک فاصله محافظه‌کارانه و افزایش تدریجی فاصله میان تلاش‌های محدود استفاده کنید. برای چند کار هم‌زمان، افزودن کمی تأخیر تصادفی به زمان‌های مجاز می‌تواند جلوی شروع دسته‌جمعی را بگیرد. این تأخیر اگر retry_after موجود است باید پس از حداقل اعلام‌شده قرار بگیرد، نه اینکه زمان را کوتاه کند. کارهای قدیمی‌تر از مهلت تعیین‌شده را برای بررسی انسانی علامت بزنید یا، اگر نوع اعلان اجازه می‌دهد، با آخرین وضعیت جایگزین کنید.

صبر در صف یا صبر در همان فرایند؟

نگه داشتن یک پردازشگر در خواب تا پایان انتظار برای نمونه‌های بسیار کوچک ممکن است کار کند، اما با افزایش کار، پردازشگرهای در حال انتظار جای فرایندهای مفید را می‌گیرند و خاموشی برنامه می‌تواند وضعیت آن‌ها را از بین ببرد. به جای خواب طولانی داخل پاسخ Webhook، زمان مجاز را در یک مکان پایدار ثبت کنید و کار را آزاد کنید تا بعد از رسیدن موعد برداشته شود. اینکه صف چه فناوری‌ای دارد به محیط پروژه وابسته است. لازم نیست برای هر ربات پایگاه داده جداگانه بخرید؛ نخست مشخص کنید در سرویس انتخابی چگونه داده‌ای پایدار، پوشش نسخه پشتیبان و مصرف قابل پایش دارید.

تصمیم عملی برای صف کوچک

برای رباتی با تعداد کم اعلان، یک جدول کار با وضعیت‌های محدود می‌تواند مناسب باشد اگر میزبان اجرای زمان‌بند یا پردازشگر متناسب را تأیید کند. رکورد نمونه شامل شناسه اعلان، زمان مجاز ارسال، تعداد تلاش، آخرین نتیجه و نوع پیام است. دسترسی به رکورد را به نقش لازم محدود کنید و در صف، کلید API یا متن خصوصی اضافه ذخیره نکنید. اگر برنامه دقیقاً همان لحظه موعد نیاز به ارسال دارد، بازه بررسی صف اهمیت پیدا می‌کند؛ اگر اعلان با چند دقیقه اختلاف همچنان مفید است، دقت بیش‌ازحد فقط پیچیدگی اضافه ایجاد می‌کند.

آزمون مطمئن برای یک انتظار ساختگی

در واحد تست، زمان را کنترل کنید و یک پاسخ ساختگی با زمان انتظار ۱۵ ثانیه تحویل بدهید. در ثانیه چهاردهم باید هیچ تلاش جدیدی برای آن اعلان ثبت نشود. در ثانیه پانزدهم یا بعد از آن، فقط یک پردازشگر باید بتواند آن را برای ارسال بردارد. اگر سرویس پس از ۱۰ ثانیه دوباره راه بیفتد، زمان قبلی نباید از دست برود. این آزمون بدون فرستادن انبوه درخواست و بدون ساختن محدودیت واقعی در تلگرام بررسی می‌کند برنامه شما دستور انتظار و پایداری صف را درست رعایت کرده است.

صف ارسال را با مسئولیت روشن طراحی کنید

کار اصلی را از اطلاع‌رسانی جدا نگه دارید

در نمونه فروشگاه، ثبت موفق سفارش و تصمیم ارسال رسید دو نتیجه جدا هستند. می‌توان هم‌زمان با ثبت سفارش، نیاز ارسال رسید را هم در داده پایدار ثبت کرد، به شرطی که این دو ثبت طوری انجام شوند که یکی بی‌سرنوشت نماند. برای مثال در برنامه‌ای با پایگاه داده تراکنشی، ثبت رکورد سفارش و رکورد اعلان در یک تراکنش سازوکار مناسبی برای بررسی است. سپس یک فرایند جدا پیام را می‌فرستد. این فرایند مجوز ثبت دوباره سفارش ندارد. در صورت خاموش شدن برنامه بعد از ایجاد سفارش، پس از روشن شدن می‌توانید از همان رکورد اعلان ادامه دهید و نیازی نیست ورودی کاربر را دوباره پخش کنید.

اگر برنامه امروز فقط برای یک مشتری پیام می‌فرستد، این جداسازی همچنان مفید است. اغلب هزینه تاخیر کوتاه اعلان از هزینه تکرار عملیات واقعی کمتر است. برای نمونه، تغییر وضعیت تیکت باید در سیستم پشتیبانی یک بار ثبت شود؛ دریافت کننده شاید بتواند آن وضعیت را در پنل ببیند، حتی زمانی که پیام تلگرام هنوز منتظر است. توضیح وضعیت صف در پنل هم به تیم پشتیبانی راهی می‌دهد که بدون تکرار پیام یا باز کردن اطلاعات مشتری، تشخیص دهد اعلان چه سرنوشتی دارد.

یک شناسه پایدار برای هر اعلان داشته باشید

شناسه اعلان باید در تلاش‌های مجدد ثابت بماند. شناسه جدید برای هر بار فراخوانی شبکه مناسب ثبت تلاش است، ولی هویت خود اعلان نیست. برای یک رسید خرید ممکن است ترکیب شناسه داخلی سفارش، نوع رسید و نسخه رخداد هویت منطقی باشد. برای تغییر وضعیت، اگر می‌خواهید اطلاعات آخر جای همه اعلان‌های قدیمی‌تر را بگیرد، باید از اول مشخص کنید که این قاعده فقط برای کدام نوع پیام مجاز است. ادغام رسید یا اعلان مورد نیاز حسابرسی با سایر پیام‌ها می‌تواند اطلاعات ضروری را از بین ببرد. تصمیم را از کاربرد واقعی پیام بگیرید، نه از آسانی حذف آن در صف.

مطمئن شوید پردازشگر برای برداشتن یک کار از صف، سازوکاری دارد که دو فرایند را هم‌زمان مالک فعال آن نمی‌کند. اگر یک پردازشگر وسط کار ناپدید شد، کار باید از حالت گیرکرده قابل بازیابی باشد. در عین حال، انقضای زمان مالکیت بسیار کوتاه ممکن است همان کاری را که هنوز در شبکه در جریان است دوباره قابل برداشت کند. مقدارها را با زمان پاسخ واقعی، مهلت درخواست و رفتار توقف فرایند آزمایش کنید. برای اعلان‌های کم‌حجم، یک پردازشگر مستقل که رفتار آن را خوب می‌بینید می‌تواند انتخاب ساده‌تری از چند پردازشگر هماهنگ‌نشده باشد.

وضعیت‌های لازم را تعریف کنید

برای یک صف ساده می‌توانید حالت منتظر، در حال ارسال، ارسال‌شده، نیازمند بازبینی و پایان مهلت را متمایز کنید. حالت منتظر باید پاسخ دهد که کار از چه زمانی مجاز است انجام شود. حالت در حال ارسال باید نشان دهد کدام پردازشگر در حال اقدام است و اگر آن پردازشگر ناپدید شد چه کسی مسئول بررسی است. حالت ارسال‌شده به پاسخ معتبر و شناسه داخلی مستند تکیه دارد. اگر پاسخ شبکه نامعلوم باشد، پیام را نتیجه قطعی تلقی نکنید. مشخص کنید در هر حالت، اپراتور مجاز است چه تغییری انجام دهد و تغییر در گزارش چگونه ثبت می‌شود.

جدول وضعیت در عمل به شما می‌گوید آیا برای مشتری واقعاً کاری باقی مانده است. چند مثال: پیام هنوز زمان مجاز ندارد؛ روش ادامه منتظر ماندن است. پیام ارسال شده ولی پنل رسید مشتری را نشان نمی‌دهد؛ مسئله ممکن است در نمایش وضعیت خود برنامه باشد. مدت زیادی هیچ پردازشگری کار را برنداشته؛ این شاهد قوی‌تری درباره توقف پردازشگر یا زمان‌بند است تا درباره محدودیت تلگرام. قاطی کردن این حالت‌ها باعث می‌شود مدیر پس از هر رخداد با زدن یک دکمه ارسال مجدد، علت مسئله و نتیجه واقعی را از هم دور کند.

وضعیت اعلان شاهد لازم اقدام مناسب
منتظر زمان مجاز در آینده است هیچ ارسال زودهنگام انجام نشود
در حال ارسال کار به یک پردازشگر واگذار شده تا تعیین نتیجه، پردازشگر دیگری شروع نکند
ارسال‌شده پاسخ موفق معتبر ثبت شده تلاش تکراری ایجاد نشود
نتیجه نامعلوم پاسخ قطع شده یا نتیجه قطعی نیست بر اساس ریسک اعلان بررسی و تصمیم‌گیری شود
پایان مهلت پیام دیگر برای کاربر به‌موقع نیست طبق سیاست، جایگزین یا بایگانی شود

از ارسال تکراری چطور جلوگیری کنیم؟

دو منشأ تکرار را جدا بررسی کنید

اول رسیدن بیش از یک نسخه از یک رویداد یا فعال شدن دوباره همان مسیر درخواست است. این را با شناسه رویداد در مرحله ورود کنترل کنید. نوع دوم، اجرای دوباره یک کار خروجی است که قبلاً برای همان رویداد ثبت شده است. اگر صف پیام از رویداد کاملاً جداست، برای خروجی هم کلید منطقی مستقل نیاز دارید. حتی اگر همه رویدادهای ورودی دقیقاً یک بار در برنامه‌تان پذیرفته شوند، یک خرابی میان ارسال پیام و ثبت نتیجه می‌تواند برای خروجی ابهام ایجاد کند. پس مدل اطمینان ورودی را بدون بررسی به خروجی تعمیم ندهید.

فرض کنید ربات پس از دریافت پیام موفق از API قرار است شناسه نتیجه را بنویسد، اما فرایند درست قبل از ثبت خاموش می‌شود. به کار در حال ارسال زمان بدهید و اگر نتیجه قطعی پیدا نشد، آن را نامعلوم علامت بزنید. برای پیام‌های کم‌اهمیت می‌توان تصمیم گرفت پیام دوباره فرستاده نشود و وضعیت در پنل باقی بماند؛ برای اعلان حیاتی شاید تصمیم انسانی لازم باشد. هنگام timeout شبکه به‌صورت عمومی نمی‌توانید تضمین کنید تلگرام درخواست را تحویل نگرفته است. شناسه صف داخلی اصطکاک را کم می‌کند، اما تضمین جادویی ارسال دقیقاً یک‌بار در سرویس بیرونی نیست.

نتیجه هر تلاش را با کمترین داده لازم ثبت کنید

زمان، نام روش، کد خطا، زمان انتظار اگر وجود دارد و شناسه داخلی اعلان را ثبت کنید. نگهداری متن پیام یا توکن در هر خط ضروری نیست. بزرگی لاگ خواندن آن را دشوار می‌کند و اگر از لینک کامل درخواست Bot API عکس بگیرید ممکن است توکن در نشانی باشد. نشانی را قبل از ارائه به فرد دیگر پاک‌سازی کنید. راهنمای محافظت از توکن و وب‌هوک ربات تلگرام مکمل این مرحله است. اگر پنل شما نتیجه نامعلوم را جدا نشان می‌دهد، می‌توانید به جای مرور هزار خط بی‌ارتباط روی دسته‌ای تمرکز کنید که واقعاً نیاز به رسیدگی دارد.

یک اعلان قدیمی را با دقت از صف خارج کنید

برای بعضی اعلان‌ها مهلت دارد که پس از آن دیگر پیام ارزش خود را از دست می‌دهد. یک اعلان «درخواست در حال پردازش است» که پس از تکمیل کار می‌رسد کاربر را گیج می‌کند. اما اگر همان صف برای رسید رسمی هم استفاده می‌شود، حذف همه پیام‌های منتظر انتخاب درستی نیست. به تفکیک نوع پیام تعیین کنید آیا ادغام چند نسخه، ثبت نتیجه نهایی به جای وضعیت‌های میانی یا پایان مهلت مجاز است. زمان پایان را در داده ثبت کنید تا تصمیم به یک وضعیت موقتی در حافظه برنامه وابسته نباشد. در نوبت پاسخ، پیش از ارسال بررسی کنید که این کار هنوز برای مخاطب فایده دارد.

اعلان، پاسخ تعاملی و پیام گروهی را یکسان اداره نکنید

نوع پیام تعیین می‌کند چه چیزی در انتظار بماند

در ربات پشتیبانی، پاسخ مستقیم به درخواست تازه و اعلان اختیاری وضعیت یک پرونده ارزش زمانی متفاوتی دارند. پاسخ مستقیم معمولاً باید زود قابل پیگیری باشد؛ اعلان اختیاری شاید حتی بعد از مدتی بتواند در یک خلاصه جمع شود. داشتن اولویت در صف به معنی مجاز بودن عبور از زمان انتظار نیست. اگر برای یک مسیر زمان انتظار ثبت شده، همان محدودیت را رعایت کنید. اولویت فقط میان کارهایی کاربرد دارد که اکنون مجازند و هنوز برای کاربر معنا دارند. کارهایی که زمان اجرای آن‌ها نرسیده را از نمایش ظرفیت آزاد پردازشگر جدا کنید.

برای یک ربات کوچک، قبل از ساخت چند صف، نقشه ساده پیام‌ها را بنویسید: نام نوع پیام، گیرنده مجاز، مهلت آن، وضعیت بعد از timeout و حداکثر تعداد تلاش طبق سیاست پروژه. اگر همه پیام‌ها شبیه‌اند، دسته‌بندی پیچیده نگذارید؛ اگر صندوق ورودی کاربران تحت تأثیر اطلاع‌رسانی پرتکرار قرار می‌گیرد، پیام‌های غیرضروری را کم کنید. برای اعلان‌های مرتبط با تغییر وضعیت، شاید کافی باشد فقط نتیجه نهایی یا تغییری را بفرستید که کاربر باید براساس آن تصمیم بگیرد. این تصمیم هم تجربه کاربر را بهتر می‌کند و هم فشار غیرضروری بر صف را کم می‌کند.

نرخ و هم‌زمانی با هم فرق دارند

هم‌زمانی می‌گوید چند درخواست در یک لحظه می‌توانند در جریان باشند. نرخ می‌گوید در یک بازه چقدر درخواست انجام شده است. اگر فقط تعداد درخواست‌های در حال اجرا را محدود کنید، با پاسخ‌های سریع هنوز ممکن است در یک بازه درخواست‌های زیادی بفرستید. اگر فقط یک فاصله میان شروع‌ها داشته باشید، اما درخواست‌ها زمان زیادی باز بمانند، تعداد زیادی فرایند ممکن است برای پاسخ منتظر شوند. دو شاخص مستقل‌اند و به دو سؤال پاسخ می‌دهند: چه حجمی مجاز است و برنامه برای چند کار باز آماده است؟ برای ربات کم‌حجم تصمیم ساده با یک پردازشگر معقول است، ولی حتی آنجا نتیجه را براساس رفتار مشاهده‌شده بسنجید.

با اضافه شدن کارگر جدید، سهمیه یا مهلت اعلام‌شده از بین نمی‌رود. اگر هر کارگر نسخه مستقل سیاست را در حافظه‌اش نگه دارد، بعد از شروع مجدد یا اختلاف زمان دستگاه‌ها ممکن است نتیجه عملی متفاوت از چیزی شود که طراح صف انتظار داشته است. زمان مجاز و تصمیم کنترلی را در جایی ثبت کنید که پردازشگرهای مسئول همان صف بتوانند بخوانند. برای رخدادهایی که دامنه محدودیت آن معلوم نیست محتاطانه رفتار کنید و از آزمایش انبوه برای کشف این دامنه استفاده نکنید. چند پاسخ واقعی، لاگ جداگانه و تست مصنوعی برای تصمیم‌های اولیه کافی‌اند.

محدودیت یک گفتگو را از اختلال سراسری چگونه جدا کنیم؟

اطمینان کامل از دامنه محدودیت همیشه از روی یک پاسخ ممکن نیست. ابتدا لیست کوچکی از نمونه‌های مستقل و زمان آنها را مقایسه کنید. اگر بیشتر خطاها به یک مقصد و یک گردش مشخص مربوط‌اند، بررسی کنید آیا برای همان کاربر پیام‌های تکراری ایجاد شده یا آیا مسیر کار مرتب یک اعلان را دوباره درج می‌کند. اگر چند مقصد مستقل هم در همان بازه با نتیجه مشابه روبه‌رو شده‌اند، نگاه وسیع‌تری به تولید هم‌زمان کار، تغییر استقرار و نحوه توزیع کار لازم است. هر دو وضعیت می‌توانند هم‌زمان رخ دهند و تنها با زمان خطا نباید درباره سقف سرویس حکم قطعی بدهید.

در گزارش عملیاتی بنویسید «از ده کار آزمایشی در ساعت مشخص، چهار کار یک نوع نتیجه دادند؛ دو مورد برای یک مکالمه بود». این جمله بهتر از «تلگرام محدودیت جدید اعمال کرد» است چون تفاوت آنچه رخ داده و آنچه استنباط کرده‌اید را نشان می‌دهد. نوع متد نیز مفید است؛ اعلان متنی، پیوست و به‌روزرسانی یک پیام ممکن است نیاز عملی متفاوتی داشته باشند. منابعی مانند پرسش‌های متداول رسمی ربات‌های تلگرام برای روش‌های مجاز و نکات متداول مرجع‌اند، اما عددهای کلی جای داده واقعی درخواست و سیاست تأییدشده پروژه را نمی‌گیرند.

سناریوهای آزمایشی که بهتر است قبل از استقرار اجرا شوند

سناریوی اول: خرید موفق و رسید در انتظار

با یک سفارش مصنوعی شروع کنید. در محیط جداگانه نتیجه ثبت سفارش را موفق و پاسخ ارسال را برای اولین تلاش 429 شبیه‌سازی کنید. ترتیب درست این است که رکورد سفارش کماکان موفق بماند، گیرنده در پنل بتواند وضعیت سفارش را ببیند، و فقط رکورد اعلان زمان مجاز دیگری بگیرد. باز کردن صفحه سفارش یا راه‌اندازی دوباره ربات نباید رکورد ثانویه برای همان رسید بسازد. اگر از قبل چنین شناسه‌ای وجود ندارد، پیش از راه‌اندازی تولید روی طراحی شناسه با تیم توافق کنید. در این آزمایش به پرداخت واقعی یا صف عملیاتی دست نزنید.

در ادامه، پاسخ بعدی را موفق شبیه‌سازی کنید و بررسی کنید که وضعیت به «ارسال‌شده» می‌رود. ببینید اگر همان پاسخ در ثبت لاگ دوباره دیده شود ولی کار قبلاً بسته شده، کار جدیدی ظاهر نمی‌شود. هدف این مرحله بررسی رفتار کسب‌وکار است. شمارش تلاش‌ها مفید است ولی معیار اصلی این است که سفارش درست باقی بماند و اعلان آن هم بدون کار اضافی از حالت انتظار خارج شود. تفاوت ساعت پردازشگر و پایگاه داده را نیز اگر صف به زمان دقیق وابسته است در آزمون بازسازی کنید.

سناریوی دوم: چند اعلان برای یک تغییر دیدبانی

فرض کنید یک تیکت در چند دقیقه از «ثبت‌شده» به «در دست بررسی» و بعد «پاسخ داده شد» می‌رسد. اگر سیاست خدمت می‌گوید فقط آخرین وضعیت قابل اقدام به کاربر اطلاع داده شود، می‌توانید پیش از ارسال، بررسی کنید آیا نسخه تازه‌تری از همان وضعیت وجود دارد. برای آزمون، هر سه رخداد را ثبت و نتیجه کار مورد انتظار را مشخص کنید. تنها در مسیرهایی از ادغام استفاده کنید که از دست رفتن اعلان میانی مشکلی برای قرارداد کاربر، حسابرسی یا ترتیب کار ایجاد نمی‌کند. صورت‌حساب، کد پیگیری یا هشدار مهم را بدون تحلیل در این قاعده قرار ندهید.

داده آزمایش باید نشان دهد که وضعیت نهایی پس از پایان انتظار ارسال می‌شود و نسخه‌های میانی به صف برنمی‌گردند. اگر کد با تغییر ترتیب زمان‌ها نسخه قدیمی را اشتباه انتخاب می‌کند، به جای فرض دقیق بودن ساعت هر کارگر از ترتیب تجاری ثبت‌شده در سامانه استفاده کنید. هنگام بازبینی رکوردها مشخص کنید آیا اپراتور می‌تواند فقط برای یک اعلان دلیل حذف یا ادغام را ببیند. اگر پاسخ منفی است، در زمان حادثه دوباره به حدس زدن درباره اینکه «این پیام اصلاً وجود داشته یا نه» برمی‌گردید.

سناریوی سوم: فرایند ری‌استارت می‌شود ولی موعد صبر پابرجاست

خطای ساختگی با زمان انتظار مشخص ایجاد کنید و قبل از پایان آن، پردازشگر آزمایشی را با رویه عادی متوقف و دوباره برقرار کنید. تا قبل از زمان مجاز نباید درخواست دیگری در ثبت تلاش ظاهر شود. بعد از رسیدن موعد، از کارگر دیگری هم بخواهید به همان صف آزمایشی نگاه کند و ببینید مالک کار هم‌زمان دو فرایند نمی‌شود. اگر برداشت انحصاری ندارید، فعلاً تعداد پردازشگر را زیاد نکنید تا سازوکار تحویل کار قابل اتکا شود. این عیب با بالا بردن منابع هاست حل نمی‌شود، هرچند افزایش بار می‌تواند عیب از قبل موجود را زودتر آشکار کند.

همین آزمایش را برای نتیجه نامعلوم ادامه دهید. پاسخ شبکه را به صورت ساختگی قطع کنید و بررسی کنید که برنامه به درستی فرق «حداقل زمان انتظار اعلام‌شده»، «شکست معلوم» و «نتیجه نامعلوم» را حفظ می‌کند. برای آزمایش واقعی در حد یک تعامل کنترل‌شده از ربات آزمایشی با مخاطب مجاز استفاده کنید و برای ایجاد مصنوعی سقف، پیام زیاد نفرستید. راهنمای راه‌اندازی ربات تلگرام روی هاست برای مرحله استقرار مکمل است؛ آزمون‌های این مقاله مستقل از انتخاب زبان برنامه باقی می‌مانند.

چه چیزی را پایش کنیم و چه زمانی به پشتیبانی مراجعه کنیم؟

شاخص‌های کمی برای یک ربات کوچک

اول، سن قدیمی‌ترین اعلان قابل ارسال را بسنجید. اگر چیزی هنوز مجاز نیست ارسال شود، آن را جداگانه نمایش دهید تا هشدار به خاطر رعایت دستور انتظار فعال نشود. دوم، شمار تلاش‌ها را به تفکیک نتیجه ببینید: موفق، محدودیت اعلام‌شده، خطای قابل تشخیص دیگر و نتیجه نامعلوم. سوم، آخرین زمان تکمیل یک کار آزمایشی یا واقعی را بررسی کنید. اگر صف ورودی خالی است طبیعی است شاخص آخرین تکمیل ثابت بماند؛ اگر ده مورد مجاز داریم و هیچ‌کدام تکمیل نمی‌شوند، آن داده راهنمای بررسی پردازشگر است. شاخص بدون زمینه می‌تواند بیشتر از اینکه به تشخیص کمک کند، حالت اضطراری مصنوعی بسازد.

مدل ساده این است که از یک روز عادی شروع کنید و الگوی واقعی تیم و مشتری را ببینید. برای ربات یادآوری شاید اوج استفاده صبح است؛ برای فروشگاه، ساعات ثبت سفارش متفاوت است. خط پایه را به جای مقایسه با یک عدد ثابت جهانی از همان مسیر و همان نوع اعلان بگیرید. در داشبورد تاریخ تغییر نسخه نرم‌افزار و شروع رخداد را هم مشخص کنید. اگر درست بعد از یک استقرار، تعداد اعلان در هر سفارش دو برابر شده باشد، ابتدا منطق ایجاد کار را نگاه کنید. اگر هیچ رویدادی به صف نمی‌رسد، مسئله پایش جداگانه ورودی مطرح است. اگر 429ها پایان یافته‌اند ولی کارهای قدیمی مانده‌اند، ممکن است صف زمان اجرای بعدی را اشتباه خوانده باشد.

تفاوت مسئلهٔ برنامه و مسئلهٔ میزبانی را روشن کنید

درخواست معتبر که با 429 از Bot API رد شده است معمولاً با جابه‌جایی میزبان یا بزرگ کردن پلن حل نمی‌شود. اگر مشکل این است که پردازشگر هر ساعت ناپدید می‌شود، هیچ امکانات مشاهده‌ای در اختیار ندارید، یا زمان‌بند طبق رویه تأییدشده کار را آغاز نمی‌کند، بررسی محیط اجرا منطقی است. این دو نوع مسئله ممکن است هم‌زمان دیده شوند، اما با نمونه جداگانه قابل تشخیص‌اند. مثلاً اگر ربات ساده در یک تماس آزمایشی به API می‌رسد ولی چند کار منتظر هیچ‌وقت شروع نمی‌شوند، زمان‌بندی و سلامت کارگر را بررسی کنید. اگر کارگر به‌خوبی تلاش کرده و پاسخ انتظار دریافت کرده، روی رفتار صف پس از پاسخ تمرکز کنید.

در تیکت پشتیبانی، زمان وقوع، نام فناوری برنامه، نوع اجرا و خلاصه نتیجه را بیاورید. به جای نوشتن «تلگرام کار نمی‌کند»، سؤال مستقیمی مثل «برای این پروژه، چه روش تأییدشده‌ای برای اجرای کارهای زمان‌دار پس از خاموشی فرایند وجود دارد؟» بپرسید. اگر ارتباط خروجی قطع است، نوع مقصد و یک مشاهده بدون داده حساس را توضیح دهید. توکن، پیکربندی کامل و محتوای پیام‌های مشتری را به تیکت اضافه نکنید. برای اختلاف میان سمت تلگرام و میزبان، حتی یک ثبت پاک‌سازی‌شده از کد پاسخ، نام لایه پاسخ‌دهنده و زمان گزارش می‌تواند مفیدتر از چند تصویر صفحه عمومی باشد.

هنگام رخداد چه کارهایی را به ترتیب انجام دهیم؟

  • مقصد پاسخ‌دهنده و اینکه خطا ورودی است یا خروجی را تعیین کنید.
  • زمان انتظار معتبر را ثبت کنید و از تلاش زودهنگام جلوگیری کنید.
  • وضعیت عملیات اصلی را جدا از وضعیت ارسال به تیم نشان دهید.
  • شمار کارهای مجاز و کارهای منتظر را از هم تفکیک کنید.
  • پیش از اقدام دسته‌جمعی، علت ایجاد کار تکراری یا نتیجه نامعلوم را بررسی کنید.
  • بعد از بازیابی با یک پیام آزمایشی به مخاطب مجاز، سالم شدن مسیر را بسنجید.

این فهرست باید در اختیار کسی باشد که واقعاً مسئول ربات است. اگر فروشگاه و ربات را دو تیم متفاوت نگه می‌دارند، تعریف کنید چه کسی درباره اولویت اعلان یا بستن حالت نامعلوم تصمیم می‌گیرد. فرایند ارسال نباید خودسرانه از پیش‌فرض تجاری خارج شود. اعلام بازگشت وضعیت به حالت عادی هم بهتر است با یک شاهد عملی باشد: مثلاً یک اعلان آزمایشی پس از رسیدن زمان مجاز به‌درستی ثبت شده و در صف دوباره ظاهر نشده است. پاسخ موفق آزمون را همراه زمان و نسخه برنامه ثبت کنید. بعد از آن اگر لازم است تغییر اصلاحی منتشر شود، همان سناریو را در محیط جدا بازتولید کنید.

مرور رخداد برای تیم فروشگاه و پشتیبانی

در پایان رخداد، برای هر دسته از اعلان‌ها تصمیم مشخصی ثبت کنید. برای نمونه، رسید سفارش می‌تواند در انتظار بماند، اما اعلان «در حال بررسی» شاید پیش از زمان مجاز ارسال با نتیجه نهایی جایگزین شده باشد. این تصمیم نباید در یک فایل لاگ گم شود. اگر کاربر مستقیماً از تیم پشتیبانی می‌پرسد چرا پیامی نرسیده است، اپراتور باید بتواند بدون دیدن رمز یا محتوای خصوصی پاسخ دهد که اصل سفارش موفق بوده، اعلان چه وضعیتی دارد و آیا کاری از سمت کاربر لازم است یا خیر. همین پاسخ روشن از ساخت تیکت اضافه یا تکرار درخواست جلوگیری می‌کند.

برای مرور فنی، خط زمانی را با چهار نقطه بسازید: اولین مشاهده، نخستین مداخله، اولین اعلان آزمایشی موفق و زمان بسته شدن رخداد. بین این نقاط فاصله واقعی را بخوانید. شاید زمان انتظار تلگرام کوتاه بوده ولی تشخیص اینکه چند پردازشگر روی یک کار قفل شده‌اند مدت بیشتری گرفته باشد. در این صورت سرمایه‌گذاری اصلی باید روی مشاهده وضعیت صف باشد نه روی تغییر اندازه میزبان. اگر علت، زیاد شدن تعداد اعلان برای یک عملیات بوده، پیش از استقرار اصلاح بعدی یک آزمون اضافه کنید که با یک سفارش ساختگی دقیقاً تعداد پیام مورد انتظار ایجاد شود. نتیجه آزمون را در کنار نسخه برنامه نگه دارید تا در نوبت بعد راه تشخیص از صفر شروع نشود.

چک‌لیست خرید هاست برای رباتی که صف دارد

نیاز برنامه را قبل از مقایسه پلن بنویسید

برای یک ربات سبک که فقط به رویدادهای مجاز پاسخ می‌دهد، شاید اجرای وب و یک راه زمان‌بندی برای اعلان‌های کوتاه کافی باشد. در پروژه دیگر، پردازشگر اختصاصی برای تولید فایل یا تغییر وضعیت سفارش لازم است. قبل از بررسی محصول، مدت اجرا، نحوه توقف و راه مشاهده خروجی را بنویسید. درباره دسترسی لازم برای نسخه زبان و وابستگی‌ها بپرسید و مطمئن شوید می‌دانید چگونه سلامت کارگر و باقی‌ماندن موعد صف پس از راه‌اندازی مجدد را آزمایش کنید. فرض نکنید همه حساب‌ها به میزبان صف جداگانه، پردازشگر دائمی یا یک روش مشخص برای دیدن لاگ دسترسی دارند.

  • روش تأییدشده اجرای وب و کارگر را از ارائه‌دهنده بپرسید.
  • محل نگهداری پایدار موعدها و وضعیت ارسال را مشخص کنید.
  • دسترسی به لاگ بدون افشای رمز و توکن را قبل از انتقال امتحان کنید.
  • یک مسیر آزمون با ربات جدا و مخاطب مجاز تعریف کنید.
  • سقف و سیاست Bot API را مستقل از مشخصات هاست در نظر بگیرید.
  • برای توقف اضطراری و ادامه کنترل‌شده صف یک مسئول تعیین کنید.

برای مقایسه سرویس با نیاز همین ربات، صفحه هاست ربات تلگرام وطن هاست را ببینید و سازگاری روش اجرای صف را با پشتیبانی تأیید کنید. اگر سامانه اصلی شما یک برنامه پایتونی گسترده‌تر است و ربات فقط یکی از خروجی‌های آن محسوب می‌شود، صفحه هاست پایتون را نیز جداگانه با همان چک‌لیست بسنجید. معیار خرید، توان اداره محیطی است که طراحی شما واقعاً نیاز دارد؛ نه وعده افزایش سهمیه ارسال در تلگرام. حتی زمانی که ظرفیت میزبان مناسب است، پاسخ 429 و حداقل زمان انتظار باید مراقبت شوند.

پرسش‌های متداول

آیا 429 همیشه نشان می‌دهد ربات متوقف شده است؟

نه. ممکن است درخواست ورود و منطق برنامه سالم باشند و فقط بخشی از ارسال خروجی منتظر بماند. وضعیت عملیات و وضعیت اعلان را جداگانه ثبت کنید. اگر 429 مربوط به یک واسطه است، شواهد را از لاگ همان واسطه بگیرید و بدون دلیل آن را به Bot API نسبت ندهید. این جداسازی جلوی دوباره ثبت شدن کارهایی را می‌گیرد که قبلاً موفق بوده‌اند.

با دریافت retry_after می‌توانم همان عدد را مستقیم برای همه پیام‌ها اعمال کنم؟

آن عدد راهنمای تلاش دوباره برای درخواست مربوط است. اینکه سیاست توقف گسترده‌تر لازم باشد، به شواهد دامنه رخداد بستگی دارد. اگر قطعیت ندارید، رفتار محافظه‌کارانه را انتخاب کنید و نتیجه را در صف و لاگ بررسی کنید. زمان اعلام‌شده را کوتاه نکنید و برای پیام‌هایی که دیگر به درد کاربر نمی‌خورند، طبق سیاست صف تصمیم بگیرید.

آیا timeout شبکه همان شکست قطعی ارسال است؟

خیر. ممکن است ارسال در مقصد انجام شده باشد ولی نتیجه به برنامه نرسیده باشد. چنین موردی را نامعلوم نگه دارید و مطابق ارزش اعلان تصمیم بگیرید که آیا بررسی انسانی یا تلاش محدود لازم است. این حالت با پاسخ صریح انتظار تفاوت دارد و نباید بدون تفکیک با همان نتیجه نهایی ثبت شود.

اگر ده اعلان قدیمی معطل‌اند، همه را بعد از انتظار بفرستیم؟

نه لزوماً. رسید مهم و قانوناً لازم برای کسب‌وکار با پیام میانی وضعیت یکسان نیست. قبل از ارسال بررسی کنید آیا پیام هنوز قابل استفاده است و آیا سیاست پروژه اجازه می‌دهد چند تغییر وضعیت با یک نتیجه نهایی جایگزین شوند. اطلاعات ضروری را صرفاً برای خلوت کردن صف کنار نگذارید.

آیا برای تست لازم است عمداً به سقف تلگرام برسیم؟

نه. زمان انتظار را با یک پاسخ ساختگی در محیط آزمایش بازسازی کنید و شرط ارسال بعد از موعد، حفظ زمان بعد از راه‌اندازی مجدد و جلوگیری از مالکیت هم‌زمان را آزمایش کنید. برای اعتبارسنجی اتصال واقعی چند کار کنترل‌شده با مخاطب مجاز کافی است. ایجاد عمدی سیل درخواست کمکی به سنجش رفتار برنامه نمی‌کند.

جمع‌بندی

خطای 429 ربات تلگرام را از مرحله دریافت رویداد و از عملیات اصلی جدا کنید. زمان انتظار را طبق پاسخ واقعی حفظ کنید، اجرای دوباره را به یک صف قابل پیگیری بسپارید و برای نتیجه نامعلوم راه تصمیم‌گیری تعریف کنید. پیش از افزایش منابع، با لاگ و زمان صف روشن کنید که اختلال به محیط میزبان مربوط است یا به روش ارسال برنامه. اگر ربات از آزمون خروجی ساختگی، رفتار پس از شروع دوباره و جلوگیری از اعلان تکراری عبور کند، تیم شما هنگام رخداد به‌جای حدس زدن یک مسیر عملی برای تشخیص دارد.

 

دیدگاه‌ها

در حال دریافت دیدگاه‌ها…

از ثبت دیدگاهت ممنونیم

دیدگاه شما پس از تأیید منتشر می‌شود.