Twitch botu neden moderatörlerin mesajlarını atlıyor

Önce mesajın hangi aşamada kaybolduğunu belirleyin

Botun aynı kanaldaki normal mesajları alıp almadığını kontrol edin. Günlüklerde ne izleyici ne de moderatör varsa sorun genellikle yetkilendirme, sohbete bağlantı veya kanal adındadır. İzleyiciler görünüyor ama moderatörün mesajları yoksa nedeni rol filtresinde, IRC etiketlerinde veya EventSub aboneliğinde arayın.

Sadece botun sohbet içindeki yanıtına değil, gelen olay günlüğüne de bakın. Mesaj uygulamaya ulaşabilir ancak önek, bekleme süresi, yasaklı kelimeler, yoksayma listesi veya yetki kontrolü nedeniyle komutu tetiklemeyebilir. Test için bir izleyiciden ve bir moderatörden aynı kısa cümleyi, ardından aynı komutu gönderin.

Kanalı, bot hesabını ve IRC bağlantısını kontrol edin

Botun tam olarak doğru kanala ve sohbeti okuması gereken hesapla giriş yaptığından emin olun. Kanal yeniden adlandırıldıktan, oturum açma adı değiştikten veya test ile canlı ortam arasında geçiş yapıldıktan sonra uygulama çevrimiçi kalabilir ama başka bir sohbeti dinleyebilir.

Bağlantı günlüğünde başarılı yetkilendirme, botun takma adı ve kanala giriş komutu görünmelidir. Bağlantı koptuktan sonra yalnızca yeniden bağlanma denemelerini değil, yeni bir başarılı girişin gerçekleşip gerçekleşmediğini de kontrol edin. Hata kaydı olmadan otomatik yeniden bağlanma, süresi dolmuş bir token'ı, hatalı OAuth parolasını veya kanal adındaki bir hatayı gizler.

OAuth token'ını ve okuma izinlerini kontrol edin

Token, botun sohbeti okuduğu hesaba ait olmalıdır. Bunu yayıncının token'ıyla karıştırmayın: kanal sahibinin izinleri ayrı bir bot hesabına aktarılmaz. IRC üzerinden mesajları okumak için chat:read kapsamı gerekir.

Mesajlar EventSub üzerinden alınıyorsa sohbet olayı için user:read:chat iznine sahip bir kullanıcı token'ı gerekir. Yetkilendirme şemasına ve aboneliği kimin oluşturduğuna bağlı olarak, botun kanala erişimi için channel:bot dahil olmak üzere ek izinler de gerekebilir. Kapsamları rastgele eklemeyin: bunları mevcut abonelik şemasıyla ve aboneliğin adına oluşturulduğu hesapla karşılaştırın.

Kullanıcı token'ının geçerliliğini ve verilen izinlerin listesini şu istekle kontrol edebilirsiniz:

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

Yanıtta oturum açma adını, kullanıcı kimliğini, geçerlilik süresini ve scopes dizisini kontrol edin. chat:read veya user:read:chat yoksa gerekli izin kümesiyle yeniden yetkilendirme yapılması gerekir. Bu çözümün dezavantajı, eski token'ların ve kayıtlı oturumların bot yapılandırmasında değiştirilmesi gerektiğidir; aksi halde bot önceki izinlerle çalışmaya devam eder.

IRC ve EventSub tanılamasını ayırın

IRC ve EventSub mesajları farklı yollarla iletir. IRC, sohbet akışını kalıcı bir bağlantı üzerinden aktarır: ham günlükte moderatörden gelen PRIVMSG satırını bulmanız gerekir. EventSub, channel.chat.message olayını oluşturulan bir API aboneliği üzerinden iletir: burada aboneliğin durumu, condition ve teslimat taşıyıcısı kontrol edilir.

Bot her iki kaynağı kullanıyorsa her olayın kaynağını günlüğe yazın. Aksi halde bir mesaj iki kez işlenebilir ve bir taşıyıcının arızası fark edilmeden kalabilir. Yalnızca EventSub kullanılıyorsa IRC bağlantısının olmaması hata sayılmaz. EventSub şemasının dezavantajı, abonelik hatalı veya devre dışıysa botun token çalışsa bile mesajları hiç görememesidir.

Sohbet mesajları için EventSub aboneliğini kontrol edin

Abonelik listesinde channel.chat.message olayını bulun. Kaydın etkin bir durumu olmalıdır. condition içinde broadcaster_user_id'yi — bu, yayıncı kanalının kimliğidir — ve olayları alan kullanıcının user_id'sini kontrol edin. Bu kimliklerden herhangi birindeki bir hata genellikle mesajların seçici olarak yok olması şeklinde görünür.

Abonelik listesini GET /helix/eventsub/subscriptions ile isteyin. Yanıtta type, status, condition ve transport alanlarını kontrol edin. enabled durumu aboneliğin etkin olduğu anlamına gelir; teslimat hatası bildirimi, silinmiş kayıt veya farklı bir kanal nedeni gösterecektir. Bu istek için aboneliği oluşturan uygulamanın token'ını ve Client ID'sini kullanın.

Yalnızca panelde veya botun veritabanında bir kaydın bulunmasına güvenmeyin. Abonelik test kanalı için oluşturulmuş, teslimat hatasından sonra silinmiş veya başka bir uygulamaya ait olabilir. API üzerinden kontrolün dezavantajı, abonelik yapılandırmasını göstermesi ama işleyicinin kendi içindeki filtreleme mantığını açıklamamasıdır.

IRC etiketlerini etkinleştirin ve yazarın rolünü kontrol edin

Yetki kontrolü IRC üzerine kuruluysa istemci twitch.tv/tags yeteneğini talep etmelidir. Etiketler olmadan bot metni ve yazarın takma adını alabilir ama mod ve badges alanlarını göremez. Bu durumda normal komutlar gelir, moderatör kuralları ise yanlış bir ret verir.

Moderatörün ham mesajında mod=1 ve badges=moderator/1 arayın. user-type alanı bulunmayabilir, boş olabilir veya güncel rolle uyuşmayabilir; bu yüzden bunu tek işaret olarak kullanmayın. Ayrıştırıcı boş etiket değerlerini ve kaçış karakterli simgeleri doğru işlemelidir; IRC yaklaşımının dezavantajı tam da bu biçimi kendi başınıza ayrıştırma zorunluluğudur.

mod=1 yoksa önce etiketler için yeteneğin yalnızca istemci tarafından gönderilmediğini, sunucu tarafından gerçekten onaylandığını doğrulayın. Ardından badges alanını kontrol edin. moderator/1 değeri moderatörü, broadcaster/1 kanal sahibini belirtir. VIP genellikle vip/1 rozetine sahiptir ama VIP otomatik olarak moderatör olmaz. Yayıncıyı ve VIP'i takma ada, renge veya display-name'e göre moderatör saymamalısınız: rolü badges ve ayrı erişim kurallarına göre belirleyin.

Kod ve ayarlardaki rol kurallarını kontrol edin

Bir izleyiciden, VIP'den, moderatörden ve kanal sahibinden gelen aynı metinli ham olayları karşılaştırın. Moderatörden gelen olay uygulamaya ulaştıysa ama işleyici onu atladıysa hata alımdan sonradır: rol kontrolünde, kara listede, spam engellemede veya komut yönlendirmesinde.

• Karşılaştırmadan önce oturum açma adlarını tek bir harf büyüklüğüne getirin.
• Tek bir sabit etiket kümesi yerine mod=1 ve moderator rozetini kontrol edin.
• broadcaster, moderator, vip ve botun kendi hesabı için izinleri ayrı ayrı tanımlayın.
• Moderatörün yoksayma listesine, yasak listesine veya engellenen kullanıcılar listesine girip girmediğini kontrol edin.
• Koşulların sırasına bakın: spam engelleme veya yasaklı kelimeler rol kontrolünden önce tetiklenebilir.
• Komutun bahsetme, bağlantı veya metin tekrarı içeren mesajlara yönelik bir kuralla engellenmediğinden emin olun.

Elle tutulan takma ad listesi yalnızca kısa tanılama için uygundur. Dezavantajı, moderatörler değiştikten, hesap yeniden adlandırıldıktan veya kanaldaki roller değiştikten sonra güncelliğini yitirmesidir.

Komut biçimini, sınırları ve gizli yoksaymayı dışlayın

Bot mesajı görüp bilerek yanıt vermiyor olabilir. Komutun bekleme süresini, tek bir kullanıcıdan gelen mesaj sınırını, tekrar korumasını, emoji filtresini ve yasaklı kelimeleri kontrol edin. Moderatörler sıklıkla komutları hızlı gönderir ve izleyicilerle aynı şekilde spam engellemeye takılabilir.

Normal bir cümleyi ve önekli bir komutu ayrı ayrı test edin. Cümle günlükte varsa ama komut işleme sonucuna ulaşmadıysa öneki, klavye düzenini, boşlukları, görünmez karakterleri ve argümanları kontrol edin. Eğik çizgiyle başlayan komutlar ve moderasyon işlemleri her zaman işleyicinin beklediği normal metin biçiminde gelmez.

Her mesaj için karar nedenini kaydedin

Tanılama için zamanı, olay kaynağını, kanalı, yazarın kimliğini, mesaj türünü, etiketleri ve işleme sonucunu kaydedin. Hata aramak için gerekli değilse metin maskelenebilir. Günlükte somut bir neden olmalıdır: mesaj alınmadı, rol tanınmadı, önek geçmedi, bekleme süresi tetiklendi, kullanıcı yoksayma listesinde veya EventSub aboneliği devre dışı.

Normal günlüklere OAuth token'larını, uygulama sırrını, webhook adreslerini ve tam yetkilendirme başlıklarını yazmayın. Bu veriler hata ayıklamada kullanışlıdır ama sızmaları bot ve uygulama ayarlarına erişim açabilir.

Sırayla tanılama kontrol listesi

1. Bir izleyiciden ve bir moderatörden aynı cümleyi ve aynı komutu gönderin.
2. Ham günlüğü kontrol edin ve mesajın IRC, EventSub veya her iki kaynak üzerinden gelip gelmediğini belirleyin.
3. IRC mesaj almıyorsa bot hesabını, kanal adını, token'ı ve sohbete başarılı girişi karşılaştırın.
4. IRC mesajı geldiyse etiketlerin etkin olduğundan emin olun, ardından mod=1 ve badges=moderator/1 kontrol edin.
5. mod=1 yoksa twitch.tv/tags onayını kontrol edin ve moderator/1, vip/1 ile broadcaster/1'i ayırt edin.
6. Token'ı validate ile kontrol edin: IRC için chat:read, EventSub mesajları için user:read:chat gerekir.
7. EventSub üzerinden çalışıyorsanız abonelik listesinde channel.chat.message, enabled durumu, condition ve transport kontrol edin.
8. Rol işlemesini, yoksayma listesini, spam engellemeyi, öneki, bekleme süresini ve yasaklı kelimeleri karşılaştırın.
9. Her mesajın neden kabul edildiğini, yoksayıldığını veya reddedildiğini günlüğe açıkça ekleyin.