Γιατί το Twitch bot παραλείπει τα μηνύματα των moderators

Πρώτα προσδιορίστε σε ποιο στάδιο χάνεται το μήνυμα

Ελέγξτε αν το bot λαμβάνει κανονικά μηνύματα στο ίδιο κανάλι. Αν στα logs δεν υπάρχουν ούτε viewers ούτε moderators, το πρόβλημα συνήθως βρίσκεται στην εξουσιοδότηση, στη σύνδεση με το chat ή στο όνομα του καναλιού. Αν οι viewers φαίνονται αλλά οι αναρτήσεις του moderator απουσιάζουν, αναζητήστε την αιτία στο φίλτρο roles, στα IRC tags ή στη συνδρομή EventSub.

Μην κοιτάτε μόνο την απάντηση του bot στο chat, αλλά το journal των εισερχόμενων events. Το μήνυμα μπορεί να φτάσει στην εφαρμογή αλλά να μην ενεργοποιήσει την εντολή λόγω prefix, cooldown, stop-words, ignore-list ή ελέγχου δικαιωμάτων. Για δοκιμή, στείλτε από viewer και moderator την ίδια σύντομη φράση και στη συνέχεια την ίδια εντολή.

Ελέγξτε το κανάλι, τον λογαριασμό του bot και τη σύνδεση IRC

Βεβαιωθείτε ότι το bot έχει συνδεθεί στο σωστό κανάλι και με τον λογαριασμό που πρέπει να διαβάζει το chat. Μετά από μετονομασία καναλιού, αλλαγή login ή εναλλαγή μεταξύ test και production περιβάλλοντος, η εφαρμογή μπορεί να παραμένει online αλλά να ακούει άλλο chat.

Στο log σύνδεσης πρέπει να φαίνονται η επιτυχής εξουσιοδότηση, το nick του bot και η εντολή εισόδου στο κανάλι. Μετά από διακοπή σύνδεσης, ελέγξτε όχι μόνο τις προσπάθειες επανασύνδεσης αλλά και το γεγονός της νέας επιτυχούς εισόδου. Η αυτόματη επανασύνδεση χωρίς καταγραφή σφάλματος κρύβει ένα ληγμένο token, λάθος κωδικό OAuth ή σφάλμα στο όνομα του καναλιού.

Ελέγξτε το OAuth token και τα δικαιώματα ανάγνωσης

Το token πρέπει να ανήκει στον λογαριασμό μέσω του οποίου το bot διαβάζει το chat. Μην το μπερδεύετε με το token του streamer: τα δικαιώματα του ιδιοκτήτη του καναλιού δεν μεταβιβάζονται σε ξεχωριστό λογαριασμό bot. Για ανάγνωση μηνυμάτων μέσω IRC απαιτείται το scope chat:read.

Αν τα μηνύματα λαμβάνονται μέσω EventSub, για το event του chat απαιτείται user token με δικαίωμα user:read:chat. Ανάλογα με το σχήμα εξουσιοδότησης και το ποιος δημιουργεί τη συνδρομή, μπορεί επίσης να απαιτούνται δικαιώματα για την πρόσβαση του bot στο κανάλι, συμπεριλαμβανομένου του channel:bot. Μην προσθέτετε scopes στην τύχη: ελέγξτε τα με το τρέχον σχήμα συνδρομής και τον λογαριασμό στο όνομα του οποίου δημιουργείται.

Μπορείτε να ελέγξετε την εγκυρότητα του user token και τη λίστα των εκχωρημένων δικαιωμάτων με το αίτημα:

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

Στην απάντηση ελέγξτε το login, το αναγνωριστικό χρήστη, τη διάρκεια ισχύος και τον πίνακα scopes. Αν λείπει το chat:read ή το user:read:chat, θα απαιτηθεί εκ νέου εξουσιοδότηση με το απαραίτητο σύνολο δικαιωμάτων. Το μειονέκτημα αυτής της λύσης είναι ότι τα παλιά tokens και οι αποθηκευμένες συνεδρίες πρέπει να αντικατασταθούν στη διαμόρφωση του bot, αλλιώς θα συνεχίσει να λειτουργεί με τα προηγούμενα δικαιώματα.

Διαχωρίστε τη διάγνωση IRC και EventSub

Τα IRC και EventSub παραδίδουν τα μηνύματα μέσω διαφορετικών διαδρομών. Το IRC μεταδίδει τη ροή του chat μέσω μόνιμης σύνδεσης: στο raw log πρέπει να βρείτε τη γραμμή PRIVMSG από τον moderator. Το EventSub παραδίδει το event channel.chat.message μέσω δημιουργημένης συνδρομής API: εδώ ελέγχονται η κατάστασή της, το condition και το transport παράδοσης.

Αν το bot χρησιμοποιεί και τις δύο πηγές, καταγράφετε στο log την πηγή κάθε event. Διαφορετικά ένα μήνυμα μπορεί να υποβληθεί σε επεξεργασία δύο φορές, ενώ μια βλάβη του ενός transport θα παραμείνει αόρατη. Αν χρησιμοποιείται μόνο το EventSub, η απουσία σύνδεσης IRC δεν θεωρείται σφάλμα. Το μειονέκτημα του σχήματος EventSub είναι ότι με λανθασμένη ή απενεργοποιημένη συνδρομή το bot δεν θα δει καθόλου μηνύματα, ακόμη και με ενεργό token.

Ελέγξτε τη συνδρομή EventSub για μηνύματα chat

Στη λίστα συνδρομών βρείτε το event channel.chat.message. Η εγγραφή πρέπει να έχει ενεργή κατάσταση. Στο condition ελέγξτε το broadcaster_user_id — είναι το αναγνωριστικό του καναλιού του streamer — και το user_id του χρήστη που λαμβάνει τα events. Σφάλμα σε οποιοδήποτε από αυτά τα ID συχνά εμφανίζεται ως επιλεκτική απουσία μηνυμάτων.

Ζητήστε τη λίστα συνδρομών μέσω GET /helix/eventsub/subscriptions. Στην απάντηση ελέγξτε type, status, condition και transport. Η κατάσταση enabled σημαίνει ότι η συνδρομή είναι ενεργή· ειδοποιήσεις για αποτυχία παράδοσης, διαγραμμένη εγγραφή ή άλλο κανάλι θα υποδείξουν την αιτία. Για αυτό το αίτημα χρησιμοποιήστε το token και το Client ID της εφαρμογής που δημιούργησε τη συνδρομή.

Μην βασίζεστε μόνο στην ύπαρξη εγγραφής στο panel ή στη βάση δεδομένων του bot. Η συνδρομή μπορεί να δημιουργήθηκε για test κανάλι, να διαγράφηκε μετά από σφάλμα παράδοσης ή να ανήκει σε άλλη εφαρμογή. Το μειονέκτημα του ελέγχου μέσω API είναι ότι δείχνει τη διαμόρφωση της συνδρομής αλλά δεν εξηγεί τη λογική φιλτραρίσματος μέσα στον ίδιο τον handler.

Ενεργοποιήστε τα IRC tags και ελέγξτε τον ρόλο του συγγραφέα

Αν ο έλεγχος δικαιωμάτων βασίζεται στο IRC, ο client πρέπει να ζητήσει το capability twitch.tv/tags. Χωρίς tags, το bot μπορεί να λάβει το κείμενο και το nick του συγγραφέα αλλά να μην βλέπει τα πεδία mod και badges. Σε αυτή την περίπτωση οι κανονικές εντολές φτάνουν, ενώ οι κανόνες για moderators δίνουν ψευδή άρνηση.

Στο raw μήνυμα του moderator αναζητήστε mod=1 και badges=moderator/1. Το πεδίο user-type μπορεί να απουσιάζει, να είναι κενό ή να μην αντιστοιχεί στον τρέχοντα ρόλο, γι' αυτό μην το χρησιμοποιείτε ως μοναδική ένδειξη. Ο parser πρέπει να χειρίζεται σωστά τις κενές τιμές των tags και τους escaped χαρακτήρες· το μειονέκτημα της προσέγγισης IRC είναι ακριβώς η ανάγκη να αναλύετε μόνοι σας αυτή τη μορφή.

Αν δεν υπάρχει mod=1, πρώτα βεβαιωθείτε ότι το capability για τα tags έχει πράγματι επιβεβαιωθεί από τον server και όχι μόνο σταλεί από τον client. Στη συνέχεια ελέγξτε τα badges. Η τιμή moderator/1 σημαίνει moderator, η broadcaster/1 — ιδιοκτήτης του καναλιού. Ο VIP συνήθως έχει badge vip/1, αλλά ο VIP δεν γίνεται αυτόματα moderator. Τον streamer και τον VIP δεν πρέπει να τους θεωρείτε moderators με βάση το nick, το χρώμα ή το display-name: προσδιορίζετε τον ρόλο από τα badges και τους ξεχωριστούς κανόνες πρόσβασης.

Ελέγξτε τους κανόνες ρόλων στον κώδικα και στις ρυθμίσεις

Συγκρίνετε τα raw events από viewer, VIP, moderator και ιδιοκτήτη καναλιού με το ίδιο κείμενο. Αν το event από τον moderator έφτασε στην εφαρμογή αλλά ο handler το παρέλειψε, το σφάλμα βρίσκεται μετά τη λήψη: στον έλεγχο ρόλου, στη blacklist, στο antispam ή στο routing εντολών.

• Μετατρέπετε τα logins σε ενιαίο πεζό/κεφαλαίο πριν από τη σύγκριση.
• Ελέγχετε mod=1 και badge moderator, όχι ένα σταθερό σύνολο tags.
• Ορίστε ξεχωριστά δικαιώματα για broadcaster, moderator, vip και τον λογαριασμό του ίδιου του bot.
• Ελέγξτε αν ο moderator έχει μπει σε ignore-list, ban-list ή λίστα απαγορευμένων χρηστών.
• Δείτε τη σειρά των συνθηκών: το antispam ή τα stop-words μπορεί να ενεργοποιηθούν πριν από τον έλεγχο ρόλου.
• Βεβαιωθείτε ότι η εντολή δεν μπλοκάρεται από κανόνα για μηνύματα με mention, link ή επανάληψη κειμένου.

Η χειροκίνητη λίστα nicknames είναι κατάλληλη μόνο για σύντομη διάγνωση. Το μειονέκτημά της είναι ότι γίνεται παρωχημένη μετά από αλλαγή moderators, μετονομασία λογαριασμού ή αλλαγή ρόλων στο κανάλι.

Αποκλείστε τη μορφή εντολής, τα όρια και την κρυφή αγνόηση

Το bot μπορεί να βλέπει το μήνυμα και να μην απαντά σκόπιμα. Ελέγξτε το cooldown της εντολής, το όριο μηνυμάτων από έναν χρήστη, την προστασία από επαναλήψεις, το φίλτρο emoji και stop-words. Οι moderators συχνά στέλνουν εντολές γρήγορα και μπορεί να πέσουν στο antispam όπως και οι viewers.

Δοκιμάστε ξεχωριστά μια κανονική φράση και μια εντολή με prefix. Αν η φράση υπάρχει στο log αλλά η εντολή δεν έφτασε στο αποτέλεσμα επεξεργασίας, ελέγξτε το prefix, τη διάταξη πληκτρολογίου, τα κενά, τους αόρατους χαρακτήρες και τα ορίσματα. Οι εντολές με κάθετο και οι ενέργειες moderation δεν φτάνουν πάντα ως κανονικό κείμενο που περιμένει ο handler.

Καταγράφετε την αιτία απόφασης για κάθε μήνυμα

Για διάγνωση, αποθηκεύετε την ώρα, την πηγή του event, το κανάλι, το ID του συγγραφέα, τον τύπο μηνύματος, τα tags και το αποτέλεσμα επεξεργασίας. Το κείμενο μπορεί να μασκαριστεί αν δεν χρειάζεται για την αναζήτηση του σφάλματος. Στο log πρέπει να υπάρχει συγκεκριμένη αιτία: το μήνυμα δεν ελήφθη, ο ρόλος δεν αναγνωρίστηκε, το prefix δεν πέρασε, ενεργοποιήθηκε το cooldown, ο χρήστης είναι σε ignore ή η συνδρομή EventSub είναι απενεργοποιημένη.

Μην καταγράφετε στα κανονικά logs OAuth tokens, το secret της εφαρμογής, διευθύνσεις webhooks και πλήρεις κεφαλίδες εξουσιοδότησης. Αυτά τα δεδομένα είναι χρήσιμα κατά το debugging, αλλά η διαρροή τους μπορεί να ανοίξει πρόσβαση στο bot και στις ρυθμίσεις της εφαρμογής.

Checklist διάγνωσης με σειρά

1. Στείλτε την ίδια φράση και την ίδια εντολή από viewer και moderator.
2. Ελέγξτε το raw log και προσδιορίστε αν το μήνυμα ήρθε μέσω IRC, EventSub ή και των δύο πηγών.
3. Αν το IRC δεν λαμβάνει μηνύματα, ελέγξτε τον λογαριασμό του bot, το όνομα καναλιού, το token και την επιτυχή είσοδο στο chat.
4. Αν το IRC μήνυμα ήρθε, βεβαιωθείτε ότι είναι ενεργοποιημένα τα tags και στη συνέχεια ελέγξτε mod=1 και badges=moderator/1.
5. Αν λείπει το mod=1, ελέγξτε την επιβεβαίωση του twitch.tv/tags και διακρίνετε moderator/1, vip/1 και broadcaster/1.
6. Ελέγξτε το token μέσω validate: για IRC απαιτείται chat:read, για μηνύματα EventSub — user:read:chat.
7. Με λειτουργία μέσω EventSub ελέγξτε channel.chat.message, κατάσταση enabled, condition και transport στη λίστα συνδρομών.
8. Συγκρίνετε την επεξεργασία ρόλων, το ignore-list, το antispam, το prefix, το cooldown και τα stop-words.
9. Προσθέστε στο log τη σαφή αιτία για την οποία κάθε μήνυμα έγινε δεκτό, αγνοήθηκε ή απορρίφθηκε.