Twitch بوٹ ماڈریٹرز کے پیغامات کیوں چھوڑ دیتا ہے

پہلے معلوم کریں کہ پیغام کس مرحلے پر غائب ہوتا ہے

چیک کریں کہ بوٹ کو اسی چینل میں عام پیغامات موصول ہو رہے ہیں یا نہیں۔ اگر لاگز میں نہ ناظرین نظر آئیں اور نہ ماڈریٹرز، تو مسئلہ عام طور پر اجازت، چیٹ سے کنکشن یا چینل کے نام میں ہوتا ہے۔ اگر ناظرین نظر آ رہے ہیں لیکن ماڈریٹر کی باتوں کا کوئی نشان نہیں، تو وجہ رول فلٹر، IRC ٹیگز یا EventSub سبسکرپشن میں تلاش کریں۔

صرف چیٹ میں بوٹ کے جواب کو نہ دیکھیں، بلکہ آنے والے ایونٹس کے جرنل کو بھی دیکھیں۔ پیغام ایپلیکیشن تک پہنچ سکتا ہے، لیکن پری فکس، کول ڈاؤن، اسٹاپ ورڈز، اگنور لسٹ یا اجازت کی جانچ کی وجہ سے کمانڈ نہ چلا سکے۔ ٹیسٹ کے لیے ایک ناظر اور ایک ماڈریٹر سے ایک ہی مختصر جملہ بھیجیں، پھر ایک ہی کمانڈ بھیجیں۔

چینل، بوٹ اکاؤنٹ اور IRC کنکشن چیک کریں

یقینی بنائیں کہ بوٹ نے بالکل مطلوبہ چینل میں اور اسی اکاؤنٹ سے لاگ ان کیا ہے جسے چیٹ پڑھنا چاہیے۔ چینل کا نام بدلنے، لاگ ان تبدیل کرنے یا ٹیسٹ اور پروڈکشن ماحول کے درمیان سوئچ کرنے کے بعد ایپلیکیشن آن لائن رہ سکتی ہے، لیکن کسی اور چیٹ کو سن رہی ہو۔

کنکشن لاگ میں کامیاب اجازت، بوٹ کا نک اور چینل میں داخل ہونے کی کمانڈ نظر آنی چاہیے۔ کنکشن ٹوٹنے کے بعد نہ صرف دوبارہ جڑنے کی کوششیں چیک کریں، بلکہ نئے کامیاب لاگ ان کی حقیقت بھی۔ بغیر خرابی ریکارڈ کیے خودکار دوبارہ کنکشن میعاد ختم شدہ ٹوکن، غلط OAuth پاس ورڈ یا چینل کے نام کی خرابی کو چھپا دیتا ہے۔

OAuth ٹوکن اور پڑھنے کی اجازتیں چیک کریں

ٹوکن اسی اکاؤنٹ کا ہونا چاہیے جس کے ذریعے بوٹ چیٹ پڑھتا ہے۔ اسے اسٹریمر کے ٹوکن سے نہ ملائیں: چینل کے مالک کی اجازتیں الگ بوٹ اکاؤنٹ کو منتقل نہیں ہوتیں۔ IRC کے ذریعے پیغامات پڑھنے کے لیے chat:read اسکوپ درکار ہے۔

اگر پیغامات EventSub کے ذریعے موصول ہوتے ہیں، تو چیٹ ایونٹ کے لیے user:read:chat اجازت والا صارف ٹوکن درکار ہے۔ اجازت کی اسکیم اور اس بات پر منحصر کہ سبسکرپشن کون بناتا ہے، بوٹ کو چینل تک رسائی کے لیے اجازتیں بھی درکار ہو سکتی ہیں، بشمول channel:bot۔ اسکوپس اندازے سے نہ شامل کریں: انہیں موجودہ سبسکرپشن اسکیم اور جس اکاؤنٹ کی طرف سے یہ بنائی جاتی ہے اس سے ملا کر دیکھیں۔

صارف ٹوکن کی درستگی اور دی گئی اجازتوں کی فہرست اس درخواست سے چیک کی جا سکتی ہے:

curl -H "Authorization: OAuth $BOT_OAUTH_TOKEN" https://id.twitch.tv/oauth2/validate

جواب میں لاگ ان، صارف کی شناخت، میعاد اور scopes کی صف چیک کریں۔ اگر chat:read یا user:read:chat موجود نہ ہو، تو مطلوبہ اجازتوں کے سیٹ کے ساتھ دوبارہ اجازت درکار ہوگی۔ اس حل کی کمی یہ ہے کہ پرانے ٹوکنز اور محفوظ سیشنز کو بوٹ کی کنفیگریشن میں تبدیل کرنا ہوگا، ورنہ یہ پرانی اجازتوں کے ساتھ کام کرتا رہے گا۔

IRC اور EventSub کی تشخیص کو الگ کریں

IRC اور EventSub پیغامات مختلف راستوں سے پہنچاتے ہیں۔ IRC مستقل کنکشن پر چیٹ کا سلسلہ منتقل کرتا ہے: خام لاگ میں ماڈریٹر کی طرف سے PRIVMSG لائن تلاش کرنی ہوگی۔ EventSub بنائی گئی API سبسکرپشن کے ذریعے channel.chat.message ایونٹ منتقل کرتا ہے: یہاں اس کی اسٹیٹس، condition اور ڈیلیوری ٹرانسپورٹ چیک کی جاتی ہے۔

اگر بوٹ دونوں ذرائع استعمال کرتا ہے، تو ہر ایونٹ کا ذریعہ لاگ میں ریکارڈ کریں۔ ورنہ ایک پیغام دو بار پروسیس ہو سکتا ہے، اور ایک ٹرانسپورٹ کی خرابی نظر نہیں آئے گی۔ اگر صرف EventSub استعمال ہو رہا ہے، تو IRC کنکشن کی عدم موجودگی کو خرابی نہیں سمجھا جاتا۔ EventSub اسکیم کی کمی یہ ہے کہ غلط یا غیر فعال سبسکرپشن کی صورت میں بوٹ پیغامات بالکل نہیں دیکھے گا، چاہے ٹوکن کام کر رہا ہو۔

چیٹ پیغامات کے لیے EventSub سبسکرپشن چیک کریں

سبسکرپشنز کی فہرست میں channel.chat.message ایونٹ تلاش کریں۔ ریکارڈ کا اسٹیٹس فعال ہونا چاہیے۔ condition میں broadcaster_user_id — یہ اسٹریمر کے چینل کی شناخت ہے — اور اس صارف کا user_id چیک کریں جو ایونٹس وصول کرتا ہے۔ ان میں سے کسی بھی ID کی خرابی اکثر پیغامات کی انتخابی عدم موجودگی کی صورت میں ظاہر ہوتی ہے۔

GET /helix/eventsub/subscriptions کے ذریعے سبسکرپشنز کی فہرست طلب کریں۔ جواب میں type، status، condition اور transport چیک کریں۔ status enabled کا مطلب ہے کہ سبسکرپشن فعال ہے؛ ڈیلیوری کی خرابی کی اطلاع، حذف شدہ ریکارڈ یا کوئی دوسرا چینل وجہ کی نشاندہی کرے گا۔ اس درخواست کے لیے اسی ایپلیکیشن کا ٹوکن اور Client ID استعمال کریں جس نے سبسکرپشن بنائی تھی۔

صرف پینل یا بوٹ کے ڈیٹا بیس میں ریکارڈ کی موجودگی پر انحصار نہ کریں۔ سبسکرپشن ٹیسٹ چینل کے لیے بنائی گئی ہو سکتی ہے، ڈیلیوری کی خرابی کے بعد حذف ہو سکتی ہے یا کسی دوسری ایپلیکیشن سے متعلق ہو سکتی ہے۔ API کے ذریعے جانچ کی کمی یہ ہے کہ یہ سبسکرپشن کی کنفیگریشن دکھاتی ہے، لیکن خود ہینڈلر کے اندر فلٹرنگ کی منطق کی وضاحت نہیں کرتی۔

IRC ٹیگز فعال کریں اور مصنف کا رول چیک کریں

اگر اجازت کی جانچ IRC پر مبنی ہے، تو کلائنٹ کو capability twitch.tv/tags کی درخواست کرنی چاہیے۔ ٹیگز کے بغیر بوٹ متن اور مصنف کا نک حاصل کر سکتا ہے، لیکن mod اور badges فیلڈز نہیں دیکھ سکتا۔ ایسی صورت میں عام کمانڈز آتی ہیں، لیکن ماڈریٹر کے قواعد غلط طور پر انکار کر دیتے ہیں۔

ماڈریٹر کے خام پیغام میں mod=1 اور badges=moderator/1 تلاش کریں۔ user-type فیلڈ موجود نہ ہو، خالی ہو یا موجودہ رول سے مطابقت نہ رکھتی ہو، اس لیے اسے واحد نشانی کے طور پر استعمال نہ کریں۔ پارسر کو ٹیگز کی خالی قدروں اور escaped حروف کو درست طریقے سے سنبھالنا چاہیے؛ IRC طریقے کی کمی بالکل اسی فارمیٹ کو خود تجزیہ کرنے کی ضرورت میں ہے۔

اگر mod=1 موجود نہ ہو، تو پہلے یقینی بنائیں کہ ٹیگز کے لیے capability واقعی سرور نے تصدیق کی ہے، نہ کہ صرف کلائنٹ نے بھیجی ہے۔ پھر badges چیک کریں۔ moderator/1 کا مطلب ماڈریٹر ہے، broadcaster/1 — چینل کا مالک۔ VIP عام طور پر vip/1 بیج رکھتا ہے، لیکن VIP خود بخود ماڈریٹر نہیں بن جاتا۔ اسٹریمر اور VIP کو نک، رنگ یا display-name کی بنیاد پر ماڈریٹر نہ سمجھیں: رول badges اور الگ رسائی قواعد سے متعین کریں۔

کوڈ اور سیٹنگز میں رول کے قواعد چیک کریں

ایک ہی متن کے ساتھ ناظر، VIP، ماڈریٹر اور چینل کے مالک کے خام ایونٹس کا موازنہ کریں۔ اگر ماڈریٹر کا ایونٹ ایپلیکیشن تک پہنچ گیا لیکن ہینڈلر نے اسے چھوڑ دیا، تو خرابی وصولی کے بعد ہے: رول کی جانچ، بلیک لسٹ، اینٹی اسپام یا کمانڈ روٹنگ میں۔

• موازنہ کرنے سے پہلے لاگ انز کو ایک ہی کیس میں لائیں۔
• mod=1 اور badge moderator چیک کریں، نہ کہ ٹیگز کا کوئی ایک مقررہ سیٹ۔
• broadcaster، moderator، vip اور خود بوٹ کے اکاؤنٹ کے لیے اجازتیں الگ سے متعین کریں۔
• چیک کریں کہ ماڈریٹر اگنور لسٹ، بان لسٹ یا ممنوع صارفین کی فہرست میں نہ آ گیا ہو۔
• شرائط کی ترتیب دیکھیں: اینٹی اسپام یا اسٹاپ ورڈز رول کی جانچ سے پہلے متحرک ہو سکتے ہیں۔
• یقینی بنائیں کہ کمانڈ کو mention، لنک یا متن کی تکرار والے پیغامات کے قاعدے سے بلاک نہیں کیا جا رہا۔

نکوں کی دستی فہرست صرف مختصر تشخیص کے لیے موزوں ہے۔ اس کی کمی یہ ہے کہ یہ ماڈریٹرز کی تبدیلی، اکاؤنٹ کے نام کی تبدیلی یا چینل میں رولز کی تبدیلی کے بعد پرانی ہو جاتی ہے۔

کمانڈ فارمیٹ، حدود اور پوشیدہ اگنور کو خارج کریں

بوٹ پیغام دیکھ سکتا ہے اور جان بوجھ کر جواب نہ دے۔ کمانڈ کا کول ڈاؤن، ایک صارف کی طرف سے پیغامات کی حد، تکرار سے تحفظ، ایموجی فلٹر اور اسٹاپ ورڈز چیک کریں۔ ماڈریٹرز اکثر کمانڈز تیزی سے بھیجتے ہیں اور ناظرین کی طرح اینٹی اسپام کی زد میں آ سکتے ہیں۔

الگ سے ایک عام جملہ اور پری فکس والی کمانڈ ٹیسٹ کریں۔ اگر جملہ لاگ میں موجود ہے لیکن کمانڈ پروسیسنگ کے نتیجے تک نہیں پہنچی، تو پری فکس، کی بورڈ لے آؤٹ، خالی جگہیں، پوشیدہ حروف اور آرگیومنٹس چیک کریں۔ سلیش والی کمانڈز اور ماڈریشن ایکشنز ہمیشہ عام متن کی صورت میں نہیں آتے جن کی ہینڈلر توقع کرتا ہے۔

ہر پیغام کے فیصلے کی وجہ ریکارڈ کریں

تشخیص کے لیے وقت، ایونٹ کا ذریعہ، چینل، مصنف کی ID، پیغام کی قسم، ٹیگز اور پروسیسنگ کا نتیجہ محفوظ کریں۔ متن کو ماسک کیا جا سکتا ہے اگر خرابی تلاش کرنے کے لیے اس کی ضرورت نہ ہو۔ لاگ میں مخصوص وجہ ہونی چاہیے: پیغام موصول نہیں ہوا، رول شناخت نہیں ہوا، پری فکس پاس نہیں ہوا، کول ڈاؤن متحرک ہوا، صارف اگنور میں ہے یا EventSub سبسکرپشن غیر فعال ہے۔

عام لاگز میں OAuth ٹوکنز، ایپلیکیشن سیکرٹ، ویب ہک ایڈریسز اور مکمل اجازت ہیڈرز نہ لکھیں۔ یہ ڈیٹا ڈی بگنگ میں آسان ہے، لیکن اس کے لیک ہونے سے بوٹ اور ایپلیکیشن سیٹنگز تک رسائی کھل سکتی ہے۔

ترتیب وار تشخیصی چیک لسٹ

1. ناظر اور ماڈریٹر سے ایک ہی جملہ اور ایک ہی کمانڈ بھیجیں۔
2. خام لاگ چیک کریں اور معلوم کریں کہ پیغام IRC، EventSub یا دونوں ذرائع سے آیا۔
3. اگر IRC کو پیغامات نہیں مل رہے، تو بوٹ اکاؤنٹ، چینل کا نام، ٹوکن اور چیٹ میں کامیاب لاگ ان کا موازنہ کریں۔
4. اگر IRC پیغام آیا، تو یقینی بنائیں کہ ٹیگز فعال ہیں، پھر mod=1 اور badges=moderator/1 چیک کریں۔
5. اگر mod=1 موجود نہ ہو، تو twitch.tv/tags کی تصدیق چیک کریں اور moderator/1، vip/1 اور broadcaster/1 میں فرق کریں۔
6. validate کے ذریعے ٹوکن چیک کریں: IRC کے لیے chat:read درکار ہے، EventSub پیغامات کے لیے — user:read:chat۔
7. EventSub کے ذریعے کام کرتے وقت سبسکرپشنز کی فہرست میں channel.chat.message، status enabled، condition اور transport چیک کریں۔
8. رولز کی پروسیسنگ، اگنور لسٹ، اینٹی اسپام، پری فکس، کول ڈاؤن اور اسٹاپ ورڈز کا موازنہ کریں۔
9. لاگ میں واضح وجہ شامل کریں کہ ہر پیغام کیوں قبول، نظر انداز یا مسترد ہوا۔