Zakaj Twitch bot preskoči sporočila moderatorjev

Najprej ugotovite, na kateri stopnji sporočilo izgine

Preverite, ali bot prejema običajna sporočila v istem kanalu. Če v dnevniku ni niti gledalcev niti moderatorjev, je težava običajno v avtorizaciji, povezavi s chatom ali imenu kanala. Če so gledalci vidni, odgovorov moderatorja pa ni, iščite vzrok v filtru vlog, IRC oznakah ali naročnini EventSub.

Ne glejte le na odgovor bota v chatu, ampak na dnevnik dohodnih dogodkov. Sporočilo lahko prispe do aplikacije, a ne sproži ukaza zaradi predpone, omejitve ponovnega klica, prepovedanih besed, seznama prezrtih ali preverjanja pravic. Za preizkus pošljite od gledalca in moderatorja enak kratek stavek, nato enak ukaz.

Preverite kanal, račun bota in povezavo IRC

Prepričajte se, da se je bot prijavil točno v pravi kanal in pod računom, ki naj bi bral chat. Po preimenovanju kanala, spremembi prijave ali preklopu med testnim in delovnim okoljem lahko aplikacija ostane povezana, a posluša drug chat.

V dnevniku povezave morajo biti vidni uspešna avtorizacija, vzdevek bota in ukaz za vstop v kanal. Po prekinitvi povezave preverite ne le poskuse ponovnega povezovanja, ampak tudi dejstvo nove uspešne prijave. Samodejno ponovno povezovanje brez zapisa napake skrije potekel žeton, napačno geslo OAuth ali napako v imenu kanala.

Preverite žeton OAuth in pravice za branje

Žeton mora pripadati računu, prek katerega bot bere chat. Ne zamenjujte ga z žetonom streamerja: pravice lastnika kanala se ne prenesejo na ločen račun bota. Za branje sporočil prek IRC je potreben obseg chat:read.

Če se sporočila sprejemajo prek EventSub, je za dogodek chata potreben uporabniški žeton s pravico user:read:chat. Glede na shemo avtorizacije in to, kdo ustvari naročnino, so lahko potrebne tudi pravice za dostop bota do kanala, vključno s channel:bot. Obsegov ne dodajajte naključno: uskladite jih s trenutno shemo naročnine in računom, v imenu katerega je ustvarjena.

Veljavnost uporabniškega žetona in seznam podeljenih pravic lahko preverite z zahtevo:

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

V odgovoru preverite prijavo, identifikator uporabnika, veljavnost in matriko scopes. Če chat:read ali user:read:chat manjka, bo potrebna ponovna avtorizacija z ustreznim naborom pravic. Pomanjkljivost takšne rešitve je, da je treba stare žetone in shranjene seje zamenjati v konfiguraciji bota, sicer bo še naprej deloval s prejšnjimi pravicami.

Ločite diagnostiko IRC in EventSub

IRC in EventSub dostavljata sporočila po različnih poteh. IRC prenaša tok chata po stalni povezavi: v surovem dnevniku je treba najti vrstico PRIVMSG od moderatorja. EventSub prenaša dogodek channel.chat.message prek ustvarjene naročnine API: tu preverjamo njen status, condition in transport dostave.

Če bot uporablja oba vira, v dnevnik zapišite vir vsakega dogodka. Sicer se lahko eno sporočilo obdela dvakrat, napaka enega transporta pa ostane neopažena. Če se uporablja samo EventSub, odsotnost povezave IRC ne šteje za napako. Pomanjkljivost sheme EventSub je, da ob napačni ali izklopljeni naročnini bot sporočil sploh ne bo videl, tudi ob delujočem žetonu.

Preverite naročnino EventSub na sporočila chata

Na seznamu naročnin poiščite dogodek channel.chat.message. Zapis mora imeti aktiven status. V condition preverite broadcaster_user_id — to je identifikator kanala streamerja — in user_id uporabnika, ki prejema dogodke. Napaka v katerem koli od teh ID se pogosto kaže kot selektivna odsotnost sporočil.

Zahtevajte seznam naročnin prek GET /helix/eventsub/subscriptions. V odgovoru preverite type, status, condition in transport. Status enabled pomeni, da je naročnina aktivna; obvestila o napaki dostave, izbrisan zapis ali drug kanal bodo pokazali vzrok. Za to zahtevo uporabite žeton in Client ID tiste aplikacije, ki je ustvarila naročnino.

Ne zanašajte se le na obstoj zapisa v nadzorni plošči ali bazi podatkov bota. Naročnina je bila morda ustvarjena za testni kanal, izbrisana po napaki dostave ali pa pripada drugi aplikaciji. Pomanjkljivost preverjanja prek API je, da pokaže konfiguracijo naročnine, ne pojasni pa logike filtriranja znotraj samega obdelovalca.

Vklopite IRC oznake in preverite vlogo avtorja

Če preverjanje pravic temelji na IRC, mora odjemalec zahtevati zmožnost twitch.tv/tags. Brez oznak lahko bot prejme besedilo in vzdevek avtorja, ne vidi pa polj mod in badges. V tem primeru običajni ukazi prispejo, pravila za moderatorje pa dajo lažno zavrnitev.

V surovem sporočilu moderatorja iščite mod=1 in badges=moderator/1. Polje user-type je lahko odsotno, prazno ali neustrezno trenutni vlogi, zato ga ne uporabljajte kot edini znak. Razčlenjevalnik mora pravilno obdelati prazne vrednosti oznak in ubežne znake; pomanjkljivost pristopa IRC je prav v tem, da je treba to obliko razčleniti samostojno.

Če mod=1 ni, najprej preverite, ali je zmožnost za oznake res potrdil strežnik in ne le poslal odjemalec. Nato preverite badges. Vrednost moderator/1 pomeni moderatorja, broadcaster/1 — lastnika kanala. VIP ima običajno oznako vip/1, vendar VIP samodejno ne postane moderator. Streamerja in VIP ne smete šteti za moderatorje po vzdevku, barvi ali display-name: vlogo določite po badges in ločenih pravilih dostopa.

Preverite pravila vlog v kodi in nastavitvah

Primerjajte surove dogodke od gledalca, VIP, moderatorja in lastnika kanala z enakim besedilom. Če je dogodek moderatorja prispel do aplikacije, a ga je obdelovalec preskočil, je napaka po sprejemu: pri preverjanju vloge, črnem seznamu, zaščiti pred neželeno pošto ali usmerjanju ukazov.

• Pred primerjavo prijavite enotno velikost črk.
• Preverjajte mod=1 in oznako moderator, ne le enega fiksnega nabora oznak.
• Ločeno določite pravice za broadcaster, moderator, vip in račun samega bota.
• Preverite, ali je moderator pristal na seznamu prezrtih, seznamu prepovedanih ali seznamu blokiranih uporabnikov.
• Poglejte vrstni red pogojev: zaščita pred neželeno pošto ali prepovedane besede se lahko sprožijo pred preverjanjem vloge.
• Prepričajte se, da ukaza ne blokira pravilo za sporočila z omembo, povezavo ali ponovitvijo besedila.

Ročni seznam vzdevkov je primeren le za kratko diagnostiko. Njegova pomanjkljivost je, da zastara po menjavi moderatorjev, preimenovanju računa ali spremembi vlog v kanalu.

Izključite obliko ukaza, omejitve in skrito prezrtje

Bot lahko sporočilo vidi in se namerno ne odzove. Preverite omejitev ponovnega klica ukaza, omejitev sporočil enega uporabnika, zaščito pred ponovitvami, filter čustvenih simbolov in prepovedanih besed. Moderatorji pogosto pošiljajo ukaze hitro in lahko podležejo zaščiti pred neželeno pošto enako kot gledalci.

Ločeno preizkusite običajen stavek in ukaz s predpono. Če je stavek v dnevniku, ukaz pa ni prišel do rezultata obdelave, preverite predpono, razporeditev tipkovnice, presledke, nevidne znake in argumente. Ukazi s poševnico in dejanja moderiranja ne prispejo vedno v obliki običajnega besedila, ki ga obdelovalec pričakuje.

Zapisujte razlog odločitve za vsako sporočilo

Za diagnostiko shranjujte čas, vir dogodka, kanal, ID avtorja, vrsto sporočila, oznake in izid obdelave. Besedilo lahko zakrijete, če ga ne potrebujete za iskanje napake. V dnevniku mora biti naveden konkreten razlog: sporočilo ni bilo prejeto, vloga ni bila prepoznana, predpona ni bila sprejeta, sprožila se je omejitev ponovnega klica, uporabnik je prezrt ali je naročnina EventSub izklopljena.

V običajne dnevnike ne zapisujte žetonov OAuth, skrivnosti aplikacije, naslovov spletnih kljukic in celotnih glav avtorizacije. Ti podatki so pri odpravljanju napak priročni, a lahko njihovo uhajanje odpre dostop do bota in nastavitev aplikacije.

Kontrolni seznam diagnostike po vrstnem redu

1. Pošljite enak stavek in enak ukaz od gledalca in moderatorja.
2. Preverite surov dnevnik in ugotovite, ali je sporočilo prispelo prek IRC, EventSub ali obeh virov.
3. Če IRC ne prejema sporočil, uskladite račun bota, ime kanala, žeton in uspešno prijavo v chat.
4. Če je sporočilo IRC prispelo, se prepričajte, da so oznake vklopljene, nato preverite mod=1 in badges=moderator/1.
5. Če mod=1 manjka, preverite potrditev twitch.tv/tags in ločite moderator/1, vip/1 in broadcaster/1.
6. Preverite žeton prek validate: za IRC je potreben chat:read, za sporočila EventSub — user:read:chat.
7. Pri delovanju prek EventSub preverite channel.chat.message, status enabled, condition in transport na seznamu naročnin.
8. Primerjajte obdelavo vlog, seznam prezrtih, zaščito pred neželeno pošto, predpono, omejitev ponovnega klica in prepovedane besede.
9. V dnevnik dodajte jasen razlog, zakaj je bilo vsako sporočilo sprejeto, prezrto ali zavrnjeno.