Niyə Twitch botu moderatorların mesajlarını buraxır

Əvvəlcə mesajın hansı mərhələdə itdiyini müəyyən edin

Botun həmin kanalda adi mesajları alıb-almadığını yoxlayın. Əgər loglarda nə tamaşaçılar, nə də moderatorlar yoxdursa, problem adətən avtorizasiya, chata qoşulma və ya kanal adı ilə bağlı olur. Əgər tamaşaçılar görünür, moderatorun replikaları isə yoxdursa, səbəbi rol filtrlərində, IRC teqlərində və ya EventSub abunəliyində axtarın.

Yalnız botun chatdəki cavabına deyil, daxil olan hadisələrin jurnalına da baxın. Mesaj tətbiqə çata bilər, lakin prefiks, cooldown, qadağan olunmuş sözlər, ignore siyahısı və ya hüquq yoxlaması səbəbindən komandanı işə salmaya bilər. Test üçün tamaşaçıdan və moderatordan eyni qısa ifadəni, sonra eyni komandanı göndərin.

Kanalı, bot hesabını və IRC bağlantısını yoxlayın

Botun məhz lazımi kanala və chatı oxumalı olan hesabla daxil olduğuna əmin olun. Kanalın adı dəyişdirildikdən, login dəyişdirildikdən və ya test və iş mühiti arasında keçid edildikdən sonra tətbiq onlayn qala bilər, lakin başqa chatı dinləyə bilər.

Bağlantı logunda uğurlu avtorizasiya, botun nikı və kanala giriş komandası görünməlidir. Bağlantı kəsildikdən sonra yalnız yenidən qoşulma cəhdlərini deyil, həm də yeni uğurlu girişin faktını yoxlayın. Xəta qeyd etmədən avtomatik yenidən qoşulma vaxtı keçmiş tokeni, yanlış OAuth parolunu və ya kanal adındakı xətanı gizlədir.

OAuth tokenini və oxuma hüquqlarını yoxlayın

Token botun chatı oxuduğu hesaba aid olmalıdır. Onu strimerin tokeni ilə qarışdırmayın: kanal sahibinin hüquqları ayrıca bot hesabına keçmir. IRC vasitəsilə mesajları oxumaq üçün chat:read scope-u lazımdır.

Əgər mesajlar EventSub vasitəsilə qəbul edilirsə, chat hadisəsi üçün user:read:chat hüququ olan istifadəçi tokeni lazımdır. Avtorizasiya sxemindən və abunəliyi kimin yaratdığından asılı olaraq, botun kanala çıxışı üçün hüquqlar, o cümlədən channel:bot da tələb oluna bilər. Scope-ları təsadüfi əlavə etməyin: onları cari abunəlik sxemi və abunəliyin yaradıldığı hesabla tutuşdurun.

İstifadəçi tokeninin etibarlılığını və verilmiş hüquqların siyahısını sorğu ilə yoxlamaq olar:

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

Cavabda login, istifadəçi identifikatoru, etibarlılıq müddəti və scopes massivini yoxlayın. Əgər chat:read və ya user:read:chat yoxdursa, lazımi hüquqlar dəsti ilə yenidən avtorizasiya tələb olunacaq. Bu həllin çatışmazlığı ondadır ki, köhnə tokenlər və saxlanılmış sessiyalar botun konfiqurasiyasında dəyişdirilməlidir, əks halda o, əvvəlki hüquqlarla işləməyə davam edəcək.

IRC və EventSub diaqnostikasını ayırın

IRC və EventSub mesajları müxtəlif yollarla çatdırır. IRC chat axınını daimi bağlantı ilə ötürür: xam logda moderatorun PRIVMSG sətrini tapmaq lazımdır. EventSub channel.chat.message hadisəsini yaradılmış API abunəliyi vasitəsilə ötürür: burada onun statusunu, condition və çatdırılma transportunu yoxlayırlar.

Əgər bot hər iki mənbədən istifadə edirsə, hər hadisənin mənbəyini loga yazın. Əks halda bir mesaj iki dəfə emal oluna bilər, bir transportun nasazlığı isə nəzərə çarpmadan qala bilər. Əgər yalnız EventSub istifadə olunursa, IRC bağlantısının olmaması xəta sayılmır. EventSub sxeminin çatışmazlığı ondadır ki, abunəlik yanlış və ya deaktiv olduqda bot mesajları ümumiyyətlə görməyəcək, hətta token işlək olsa belə.

Chat mesajları üçün EventSub abunəliyini yoxlayın

Abunəliklər siyahısında channel.chat.message hadisəsini tapın. Qeydin aktiv statusu olmalıdır. Condition-da broadcaster_user_id — bu, strimer kanalının identifikatorudur — və hadisələri qəbul edən istifadəçinin user_id-sini yoxlayın. Bu ID-lərdən hər hansı birində xəta çox vaxt mesajların seçici şəkildə olmaması kimi görünür.

Abunəliklərin siyahısını GET /helix/eventsub/subscriptions vasitəsilə sorğulayın. Cavabda type, status, condition və transport-u yoxlayın. enabled statusu abunəliyin aktiv olduğunu bildirir; çatdırılma nasazlığı barədə bildiriş, silinmiş qeyd və ya başqa kanal səbəbi göstərəcək. Bu sorğu üçün abunəliyi yaratmış tətbiqin tokenini və Client ID-sini istifadə edin.

Yalnız panel və ya botun verilənlər bazasında qeydin olmasına əsaslanmayın. Abunəlik test kanalı üçün yaradılmış, çatdırılma xətasından sonra silinmiş və ya başqa tətbiqə aid ola bilər. API vasitəsilə yoxlamanın çatışmazlığı ondadır ki, o, abunəliyin konfiqurasiyasını göstərir, lakin emal edicinin özü daxilindəki filtrləmə məntiqini izah etmir.

IRC teqlərini aktivləşdirin və müəllifin rolunu yoxlayın

Əgər hüquq yoxlaması IRC-yə əsaslanırsa, klient twitch.tv/tags capability-sini sorğulamalıdır. Teqlər olmadan bot mətni və müəllifin nikını ala bilər, lakin mod və badges sahələrini görməyə bilər. Bu halda adi komandalar gəlir, moderator qaydaları isə yanlış imtina verir.

Moderatorun xam mesajında mod=1 və badges=moderator/1 axtarın. user-type sahəsi olmaya, boş ola və ya cari rola uyğun gəlməyə bilər, ona görə onu yeganə əlamət kimi istifadə etməyin. Parsel teqlərin boş dəyərlərini və ekranlaşdırılmış simvolları düzgün emal etməlidir; IRC yanaşmasının çatışmazlığı məhz bu formatı müstəqil şəkildə təhlil etmək zərurətindədir.

Əgər mod=1 yoxdursa, əvvəlcə əmin olun ki, teqlər üçün capability həqiqətən server tərəfindən təsdiqlənib, yalnız klient tərəfindən göndərilməyib. Sonra badges-i yoxlayın. moderator/1 dəyəri moderatoru, broadcaster/1 — kanal sahibini bildirir. VIP adətən vip/1 badge-inə malikdir, lakin VIP avtomatik olaraq moderator olmur. Strimeri və VIP-i nika, rəngə və ya display-name-ə görə moderator saymaq lazım deyil: rolu badges və ayrıca çıxış qaydaları ilə müəyyən edin.

Kodda və parametrlərdə rol qaydalarını yoxlayın

Tamaşaçıdan, VIP-dən, moderatordan və kanal sahibindən eyni mətnlə gələn xam hadisələri müqayisə edin. Əgər moderatorun hadisəsi tətbiqə çatıb, lakin emal edici onu buraxıbsa, xəta qəbuldan sonradır: rol yoxlaması, qara siyahı, antispam və ya komanda marşrutlaşdırması.

• Müqayisədən əvvəl loginləri eyni registrə gətirin.
• Bir sabit teq dəsti deyil, mod=1 və moderator badge-ini yoxlayın.
• broadcaster, moderator, vip və botun öz hesabı üçün hüquqları ayrıca müəyyən edin.
• Moderatorun ignore siyahısına, ban siyahısına və ya qadağan olunmuş istifadəçilər siyahısına düşüb-düşmədiyini yoxlayın.
• Şərtlərin sırasına baxın: antispam və ya qadağan olunmuş sözlər rol yoxlamasından əvvəl işə düşə bilər.
• Komandanın qeyd, link və ya mətn təkrarı olan mesajlar üçün qayda ilə bloklanmadığına əmin olun.

Nikların əl ilə siyahısı yalnız qısa diaqnostika üçün uyğundur. Onun çatışmazlığı odur ki, moderatorlar dəyişdikdən, hesabın adı dəyişdirildikdən və ya kanaldakı rollar dəyişdikdən sonra köhnəlir.

Komanda formatını, limitləri və gizli ignore-u istisna edin

Bot mesajı görə və qəsdən cavab verməyə bilər. Komandanın cooldown-unu, bir istifadəçidən gələn mesaj limitini, təkrar qorunmasını, emoji filtri və qadağan olunmuş sözləri yoxlayın. Moderatorlar tez-tez komandaları sürətlə göndərir və tamaşaçılarla bərabər antispama düşə bilərlər.

Adi ifadəni və prefiksli komandanı ayrıca test edin. Əgər ifadə logda varsa, komanda isə emal nəticəsinə çatmayıbsa, prefiksi, klaviaturanı, boşluqları, görünməz simvolları və arqumentləri yoxlayın. Slaşlı komandalar və moderasiya əməliyyatları həmişə emal edicinin gözlədiyi adi mətn şəklində gəlmir.

Hər mesaj üzrə qərarın səbəbini qeyd edin

Diaqnostika üçün vaxtı, hadisənin mənbəyini, kanalı, müəllifin ID-sini, mesajın növünü, teqləri və emal nəticəsini saxlayın. Əgər xətanı tapmaq üçün lazım deyilsə, mətni maskalamaq olar. Logda konkret səbəb olmalıdır: mesaj alınmayıb, rol tanınmayıb, prefiks keçməyib, cooldown işə düşüb, istifadəçi ignoredadır və ya EventSub abunəliyi deaktivdir.

Adi loglara OAuth tokenlərini, tətbiqin sirrini, webhook ünvanlarını və tam avtorizasiya başlıqlarını yazmayın. Bu məlumatlar sazlama zamanı rahatdır, lakin onların sızması bota və tətbiq parametrlərinə çıxış aça bilər.

Ardıcıllıqla diaqnostika yoxlama siyahısı

1. Tamaşaçıdan və moderatordan eyni ifadəni və eyni komandanı göndərin.
2. Xam logu yoxlayın və mesajın IRC, EventSub yoxsa hər iki mənbə vasitəsilə gəldiyini müəyyən edin.
3. Əgər IRC mesaj almırsa, botun hesabını, kanal adını, tokeni və chata uğurlu girişi tutuşdurun.
4. Əgər IRC mesajı gəlibsə, teqlərin aktiv olduğuna əmin olun, sonra mod=1 və badges=moderator/1-i yoxlayın.
5. Əgər mod=1 yoxdursa, twitch.tv/tags təsdiqini yoxlayın və moderator/1, vip/1 və broadcaster/1-i fərqləndirin.
6. Tokeni validate vasitəsilə yoxlayın: IRC üçün chat:read, EventSub mesajları üçün user:read:chat lazımdır.
7. EventSub vasitəsilə işləyərkən abunəliklər siyahısında channel.chat.message, enabled statusunu, condition və transport-u yoxlayın.
8. Rolların emalını, ignore siyahısını, antispamı, prefiksi, cooldown-u və qadağan olunmuş sözləri müqayisə edin.
9. Loga hər mesajın qəbul edilməsinin, ignore edilməsinin və ya rədd edilməsinin açıq səbəbini əlavə edin.