عیب‌یابی: چرا پیام به تلگرام نرسید؟ حل خطاهای ربات و کانال تلگرام

اگر در لاگ‌های تیشتر وضعیت روتین را موفق می‌بینید اما پیامی در تلگرام شما ظاهر نمی‌شود، مشکل مربوط به تنظیمات مجوز یا فرمت شناسه چت (Chat ID) در کانکتور تلگرام است.

در ادامه، ۴ علت اصلی این مشکل و راه‌حل قطعی آن‌ها آورده شده است.

---

۴ مشکل شایع تلگرام و راه‌حل فوری

┌─────────────────────────────────┐     ┌───────────────────────────────────┐
│ خطای دریافتی                    │ ──► │ راه‌حل فوری                       │
├─────────────────────────────────┤     ├───────────────────────────────────┤
│ ۱. `bot was blocked by user`    │ ──► │ ارسال دستور `/start` در پیوی ربات │
│ ۲. `chat not found`             │ ──► │ اضافه کردن پیشوند `-100` به چت آیدی│
│ ۳. `have no rights to send`     │ ──► │ ارتقای ربات به ادمین کانال        │
│ ۴. `message is too long`        │ ──► │ محدود کردن طول خروجی پرامپت       │
└─────────────────────────────────┘     └───────────────────────────────────┘

---

۱. خطای Bot Was Blocked by User

• دلیل ایجاد خطا: تلگرام برای جلوگیری از اسپم، ارسال پیام از طرف ربات به کاربری که تا به حال با ربات گفتگو نکرده یا آن را بلاک کرده باشد ممنوع کرده و خطای 403 بازمی‌گرداند.
• راهکار حل مشکل:
  1. در تلگرام آیدی ربات خود را سرچ کنید (مثلاً @MyCompany_Radar_bot).
  2. وارد چت ربات شده و دکمه Start را بزنید یا دستور /start را ارسال کنید.
  3. به استودیو تیشتر برگشته و دکمه ارسال پیام تستی را کلیک کنید.

---

۲. خطای Chat Not Found (فراموش کردن علامت منفی در کانال‌ها)

• دلیل ایجاد خطا: در تلگرام، چت‌های خصوصی شناسه‌ای مثبت دارند (مثلاً 98274615)، اما کانال‌ها و سوپرگروه‌ها حتماً شناسه‌ای منفی دارند که با پیشوند -100 آغاز می‌شود (مثلاً -1001827461947). اگر منفی اول آن را نگذارید، تلگرام چت را پیدا نمی‌کند.
• راهکار حل مشکل:
  • مطمئن شوید شناسه کانال با -100 شروع می‌شود.
  • برای پیدا کردن شناسه دقیق کانال، یک پیام از کانال خود را به ربات @userinfobot فوروارد کنید تا آیدی عددی را تحویل دهد.

---

۳. خطای Not Enough Rights to Send Text Messages

• دلیل ایجاد خطا: شما ربات را به کانال اضافه کرده‌اید اما دسترسی مدیریت (Administrator) به آن نداده‌اید. اعضای عادی نمی‌توانند در کانال‌های تلگرام پیام بفرستند.
• راهکار حل مشکل:
  1. وارد تنظیمات کانال تلگرام خود شوید.
  2. به بخش Administrators رفته و روی Add Admin بزنید.
  3. ربات خود را انتخاب کرده و دسترسی Post Messages (ارسال پیام) را فعال کنید.
  4. ذخیره را بزنید.

---

۴. خطای طولانی بودن پیام (بیش از ۴٬۰۹۶ کاراکتر)

• دلیل ایجاد خطا: سقف طول هر حباب پیام در تلگرام ۴٬۰۹۶ کاراکتر است. اگر روتین شما یک متن ۵۰ صفحه‌ای را خلاصه نکرده باشد، تلگرام پیام را رد می‌کند.
• راهکار حل مشکل:
  • در انتهای پرامپت روتین خود بنویسید:

    «طول خروجی نهایی را حداکثر در ۲٬۰۰۰ کاراکتر و در قالب بولت‌های کوتاه تنظیم کن.»