Αυτόματη δημοσίευση νέων κλιπ Twitch στο Discord μέσω EventSub
Σε ποιους ταιριάζει η αυτόματη δημοσίευση κλιπ Twitch στο Discord
Η ενσωματωμένη σύνδεση Twitch και Discord βοηθά στην εμφάνιση της κατάστασης της μετάδοσης, στην εκχώρηση ρόλων και στην ειδοποίηση για την έναρξη της μετάδοσης. Συνήθως δεν δημοσιεύει αυτόματα νέα κλιπ σε κανάλι κειμένου. Για αυτό χρειάζεται ένα έτοιμο bot, μια υπηρεσία αυτοματισμού ή μια δική σας σύνδεση Twitch EventSub και Discord webhook.
Οι έτοιμες λύσεις είναι κατάλληλες αν δεν χρειάζεστε ανάπτυξη: συνδέετε το Twitch και το Discord, επιλέγετε κανάλι και ρυθμίζετε ένα πρότυπο. Πριν την εκκίνηση, ελέγξτε ότι η υπηρεσία αντιδρά στη δημιουργία κλιπ και όχι μόνο στην έναρξη της μετάδοσης. Το μειονέκτημα των έτοιμων λύσεων είναι η εξάρτηση από τα τιμολόγια, τα διαθέσιμα φίλτρα και τη μορφοποίηση των μηνυμάτων.
Επιλέξτε το σχήμα δημοσίευσης πριν ρυθμίσετε το Twitch
Για γρήγορη δοκιμή, δημιουργήστε ένα κλειστό κανάλι Discord και δοκιμάστε μερικά κλιπ χειροκίνητα. Αυτό θα σας βοηθήσει να δείτε τις καθυστερήσεις, να ελέγξετε την κάρτα του συνδέσμου και να καταλάβετε αν έρχονται μηνύματα για κλιπ που δεν θα έπρεπε να φτάνουν στην κοινότητα.
- Ένα έτοιμο bot συνδέεται γρηγορότερα, αλλά μπορεί να μην υποστηρίζει τις απαιτούμενες συνθήκες δημοσίευσης και τη δική σας μορφή embed.
- Ο οικοδόμος αυτοματισμών επιτρέπει την προσθήκη διακλαδώσεων και φίλτρων, αλλά μέρος των triggers και των ενεργειών μπορεί να περιορίζεται από το πλάνο της υπηρεσίας.
- Ένας δικός σας handler EventSub δίνει έλεγχο στην ουρά, το πρότυπο, τα logs και την προστασία από διπλότυπα, αλλά απαιτεί server, OAuth και συντήρηση κώδικα.
Καθορίστε εκ των προτέρων τον κανόνα: δημοσίευση όλων των κλιπ, μόνο των κλιπ του ιδιοκτήτη του καναλιού, κλιπ από moderators ή συνδέσμων μετά από χειροκίνητη έγκριση. Το μειονέκτημα της αυστηρής φιλτραρίσματος είναι ότι μια καλή στιγμή που δημιουργήθηκε από θεατή μπορεί να μείνει χωρίς δημοσίευση.
Δημιουργήστε ένα Discord webhook για το κανάλι με τα κλιπ
Το webhook δημιουργείται στις ρυθμίσεις του επιθυμητού καναλιού κειμένου Discord. Για αυτό απαιτούνται δικαιώματα διαχείρισης webhook. Στέλνει μηνύματα με καθορισμένο όνομα και επιλεγμένο avatar, επομένως δεν απαιτείται ξεχωριστός λογαριασμός Discord για βασική δημοσίευση.
- Ανοίξτε τις ρυθμίσεις του καναλιού κειμένου όπου θα έρχονται τα κλιπ.
- Μεταβείτε στην ενότητα ενσωματώσεων και βρείτε το webhook.
- Δημιουργήστε ένα νέο webhook, ορίστε ένα κατανοητό όνομα και αν χρειάζεται ανεβάστε avatar.
- Αντιγράψτε το URL και αποθηκεύστε το σε μεταβλητή περιβάλλοντος ή ασφαλή χώρο αποθήκευσης.
- Στείλτε ένα δοκιμαστικό μήνυμα σε κλειστό κανάλι.
Το URL του webhook είναι μυστικό. Όποιος αποκτήσει αυτόν τον σύνδεσμο θα μπορεί να στέλνει μηνύματα στο κανάλι με το όνομα του webhook. Μην προσθέτετε τη διεύθυνση σε δημόσιο repository, στιγμιότυπα της πάνελ ή κώδικα client. Σε περίπτωση διαρροής, διαγράψτε το webhook και δημιουργήστε νέο: η αλλαγή του URL στην παλιά διεύθυνση δεν αρκεί.
Συνδέστε το συμβάν δημιουργίας κλιπ μέσω Twitch EventSub
Στο δικό σας σχήμα, το Twitch στέλνει το συμβάν channel.clip.created σε διεύθυνση HTTPS του handler σας. Ο handler επαληθεύει το αίτημα, αποθηκεύει τα δεδομένα του κλιπ, σχηματίζει το μήνυμα και το προωθεί στο Discord webhook. Ο λογαριασμός Twitch δεν αποκτά πρόσβαση στον server του Discord.
Για τη συνδρομή θα χρειαστείτε μια εφαρμογή Twitch, το ID του καναλιού, το callback URL και εξουσιοδότηση κατάλληλη για τον επιλεγμένο τύπο συμβάντος. Οι απαιτήσεις για το token και τα δικαιώματα πρέπει να ελέγχονται με την τρέχουσα τεκμηρίωση του EventSub: μπορεί να αλλάζουν. Μην χρησιμοποιείτε παραμέτρους εξουσιοδότησης από παλιά παραδείγματα χωρίς έλεγχο.
Το token χρήστη του ιδιοκτήτη του καναλιού μπορεί να λήξει ή να ανακληθεί. Το μειονέκτημα αυτού του σχήματος είναι ότι το refresh token πρέπει να αποθηκεύεται με ασφάλεια και η πρόσβαση να ανανεώνεται έγκαιρα. Αν η ανανέωση δεν λειτουργεί, η συνδρομή ή η δημιουργία νέων συνδρομών μπορεί να σταματήσει να λειτουργεί χωρίς εμφανές σφάλμα στο Discord.
Προετοιμάστε μια διεύθυνση HTTPS για τις ειδοποιήσεις Twitch
Το callback URL πρέπει να είναι προσβάσιμο από το διαδίκτυο μέσω HTTPS. Κατά τη δημιουργία της συνδρομής, το Twitch στέλνει αίτημα επαλήθευσης με τύπο webhook_callback_verification. Ο server πρέπει να επιβεβαιώσει την αυθεντικότητα του αιτήματος και να επιστρέψει την τιμή challenge ως απλό κείμενο. Μέχρι να ολοκληρωθεί αυτό το στάδιο, η συνδρομή δεν θα ενεργοποιηθεί.
Τα συμβάντα εργασίας έρχονται με τύπο notification. Σε αυτά είναι καλύτερο να επιστρέφετε γρήγορα μια επιτυχημένη απάντηση HTTP και να αναθέτετε τη δημοσίευση σε ουρά ή ξεχωριστό handler. Αν περιμένετε την απάντηση του Discord μέσα στο αίτημα EventSub, η καθυστέρηση δικτύου αυξάνει τον κίνδυνο επαναλαμβανόμενης παράδοσης της ειδοποίησης.
Για τοπική ανάπτυξη μπορείτε να χρησιμοποιήσετε ένα HTTPS tunnel. Το μειονέκτημά του είναι ότι η δημόσια διεύθυνση μπορεί να αλλάξει μετά από επανεκκίνηση. Το tunnel είναι βολικό για δοκιμές, αλλά δεν αντικαθιστά ένα μόνιμο endpoint για λειτουργικό αυτοματισμό.
Επαληθεύστε την υπογραφή με βάση το αρχικό σώμα του αιτήματος
Η υπογραφή EventSub βασίζεται στο ID του μηνύματος, τον χρόνο αποστολής και το αρχικό σώμα του αιτήματος HTTP. Πρώτα λάβετε τα bytes του body, αποθηκεύστε τα χωρίς αλλαγές και μετά επαληθεύστε το HMAC. Δεν επιτρέπεται να αναλύσετε το JSON και να το συναρμολογήσετε ξανά πριν την επαλήθευση της υπογραφής. Η σειρά των πεδίων, τα κενά ή η κωδικοποίηση μπορεί να αλλάξουν και η υπολογισμένη υπογραφή δεν θα ταιριάζει.
Για την επαλήθευση χρειάζονται οι κεφαλίδες Twitch-Eventsub-Message-Id, Twitch-Eventsub-Message-Timestamp και Twitch-Eventsub-Message-Signature. Η συμβολοσειρά για το HMAC SHA-256 σχηματίζεται ως εξής: messageId + timestamp + rawBody. Ως κλειδί χρησιμοποιείται το μυστικό που ορίστηκε κατά τη δημιουργία της συνδρομής. Το αποτέλεσμα σε δεκαεξαδική μορφή συγκρίνεται με την τιμή της κεφαλίδας, η οποία ξεκινά με sha256=.
Στο Node.js η λογική είναι η εξής: δημιουργήστε HMAC SHA-256 με το μυστικό της συνδρομής, περάστε σε αυτό messageId + timestamp + rawBody, προσθέστε στο hash το πρόθεμα sha256= και συγκρίνετε με το Twitch-Eventsub-Message-Signature μέσω crypto.timingSafeEqual. Πριν τη σύγκριση, ελέγξτε ότι οι συμβολοσειρές έχουν το ίδιο μήκος, αλλιώς η ασφαλής σύγκριση θα αποτύχει.

Ελέγξτε τον τύπο του μηνύματος και τον χρόνο αποστολής του
Η επαλήθευση HMAC απαιτείται για κάθε αίτημα EventSub, συμπεριλαμβανομένων των callback verification, notification και revocation. Μόνο μετά την επιτυχή επαλήθευση διαβάστε το JSON και προσδιορίστε τον τύπο του μηνύματος από την κεφαλίδα Twitch-Eventsub-Message-Type. Για το callback verification επιστρέψτε το challenge, για το notification δημιουργήστε μια εργασία δημοσίευσης, για το revocation καταγράψτε την αιτία απενεργοποίησης της συνδρομής στο log.
Επιπλέον, συγκρίνετε τον χρόνο από το Twitch-Eventsub-Message-Timestamp με την τρέχουσα ώρα του server. Ένα περιορισμένο παράθυρο υποδοχής βοηθά να αποκλείσετε παλιά αιτήματα που έχουν σταλεί ξανά από τρίτο μέρος. Αυτός ο έλεγχος δεν αντικαθιστά το HMAC: το timestamp μπορεί να διαβαστεί από το αίτημα, αλλά χωρίς το μυστικό δεν μπορεί να δημιουργηθεί σωστή υπογραφή.
Αποθηκεύστε το μυστικό της συνδρομής ξεχωριστά από τον κώδικα και το URL του Discord webhook. Το μειονέκτημα της συχνής αλλαγής του μυστικού χωρίς διαδικασία ενημέρωσης είναι ότι η υπάρχουσα συνδρομή θα σταματήσει να περνά την επαλήθευση. Πρώτα δημιουργήστε ή ενημερώστε τη συνδρομή και μετά αλλάξτε το μυστικό στον handler.
Μην δημοσιεύετε το ίδιο κλιπ δύο φορές
Το EventSub μπορεί να παραδώσει ξανά την ίδια ειδοποίηση αν το endpoint άργησε να απαντήσει, η σύνδεση διακόπηκε ή προέκυψε σφάλμα δικτύου. Αποθηκεύστε το Twitch-Eventsub-Message-Id σε μόνιμη βάση δεδομένων με μοναδικό ευρετήριο. Αν αυτό το ID έχει ήδη επεξεργαστεί, μην δημιουργήσετε δεύτερη εργασία και επιστρέψτε επιτυχημένη απάντηση.
Προσθέστε ένα δεύτερο μοναδικό κλειδί με βάση το ID του κλιπ από τα δεδομένα του συμβάντος. Αυτό προστατεύει από επαναλαμβανόμενη δημοσίευση όταν το ίδιο βίντεο έρχεται σε διαφορετικές ειδοποιήσεις ή όταν η εργασία επανεκκινήθηκε μετά από αποτυχία. Πρώτα προσπαθήστε να καταγράψετε το clip_id στον πίνακα δημοσιευμένων κλιπ και μόνο μετά την επιτυχή εγγραφή στείλτε το μήνυμα στο Discord.
Αυτό το σχήμα έχει ένα μειονέκτημα: μια αποτυχία μεταξύ της εγγραφής του clip_id και της αποστολής του webhook μπορεί να αφήσει το κλιπ σημειωμένο ως δημοσιευμένο χωρίς μήνυμα στο Discord. Για τέτοιες περιπτώσεις, αποθηκεύστε την κατάσταση της εργασίας: δημιουργήθηκε, αποστέλλεται, δημοσιεύτηκε, σφάλμα. Οι εργασίες με κατάσταση σφάλματος μπορούν να επαναληφθούν χειροκίνητα ή σύμφωνα με τους κανόνες της ουράς.
Συνθέστε το μήνυμα embed για το Discord
Στο μήνυμα είναι χρήσιμο να συμπεριλάβετε τον τίτλο του κλιπ, το όνομα του δημιουργού, το όνομα του καναλιού, την κατηγορία και τον άμεσο σύνδεσμο. Μην εισάγετε κείμενο από το Twitch στο JSON χειροκίνητα μέσω συνένωσης συμβολοσειρών: τα εισαγωγικά και οι ειδικοί χαρακτήρες μπορεί να σπάσουν το αίτημα. Σχηματίστε το αντικείμενο με τα μέσα της γλώσσας και στείλτε το ως JSON.
Το πρότυπο embed μπορεί να είναι ως εξής: τίτλος «Νέο κλιπ στο κανάλι», περιγραφή «Δημιουργός: {creator_name}», URL «{clip_url}», πεδίο «Τίτλος» με τιμή «{clip_title}», πεδίο «Κατηγορία» με τιμή «{game_name}». Αν στο συμβάν δεν υπάρχει κατηγορία ή όνομα δημιουργού, αφήστε το πεδίο κενό ή μην το προσθέσετε.
Μπορείτε να προσθέσετε αναφορά ρόλου, αλλά μην τη στέλνετε σε κάθε κλιπ χωρίς περιορισμούς. Το μειονέκτημα των συνεχών ειδοποιήσεων είναι ότι τα μέλη του server θα αρχίσουν να απενεργοποιούν το κανάλι ή τον ρόλο. Για ένα ενεργό κανάλι, είναι καλύτερο να δημοσιεύετε κλιπ χωρίς ping ή να αναφέρετε τον ρόλο μόνο με βάση ξεχωριστό κανόνα.
Δοκιμάστε το σενάριο πριν τη δημοσίευση στο κύριο κανάλι
Πρώτα χρησιμοποιήστε ένα δοκιμαστικό κανάλι Discord και δημιουργήστε μερικά κλιπ με διαφορετικούς τίτλους, δημιουργούς και κατηγορίες. Ελέγξτε αν περνά το callback verification, αν η υπογραφή επαληθεύεται πριν την ανάλυση του JSON, αν εμφανίζεται μία κάρτα ανά clip_id και αν δεν δημοσιεύεται μήνυμα κατά την επαναλαμβανόμενη παράδοση του EventSub.
- Ελέγξτε ότι ο server διαβάζει το raw body πριν τον JSON parser ή αποθηκεύει τα αρχικά bytes του αιτήματος.
- Βεβαιωθείτε ότι το challenge επιστρέφεται μόνο μετά την επιτυχή επαλήθευση του Twitch-Eventsub-Message-Signature.
- Ελέγξτε τη διαχείριση σφάλματος του Discord webhook και την επανάληψη της εργασίας χωρίς τη δημιουργία δεύτερου μηνύματος.
- Εξετάστε τα logs ανά message ID, clip_id, τύπο μηνύματος EventSub και κατάσταση αποστολής.
Μην καταγράφετε στα logs το μυστικό της συνδρομής, τα OAuth tokens και το πλήρες URL του Discord webhook. Για διαγνωστικούς σκοπούς αρκούν το ID του συμβάντος, το ID του κλιπ, ο κωδικός απάντησης του Discord και το κείμενο του τεχνικού σφάλματος χωρίς εμπιστευτικές κεφαλίδες.
Last Articles
Τι άλλαξε στον σχεδιασμό και τη λειτουργικότητα Ενημερώσαμε την ιστοσελίδα για να δουλεύετε πιο γρήγορα και πιο άνετα. Οι κύριες αλλαγές αφορούν το π..
Good afternoon, I've collected all the news during this time.: 1. The main news is that prices for twitch viewers have been greatly reduced, while Tw..
1. Χρησιμοποιήστε τον κωδικό "December2025" για έκπτωση 15% για όλους τους θεατές μας2. Μειώσαμε έως την 1η Ιανουαρίου τις βασικές τιμές για τον διαμο..
Οι υπηρεσίες Twitch είναι λειτουργώντας σταθερά, έτσι είμαστε έτοιμοι να συνεργαστούμε με τις ομάδες, μεταπωλητές, ιδιοκτήτες υπηρεσιών, ιδιοκτήτε..
Εμείς έχουμε ενημερώσει πλήρως τις υπηρεσίες Twitch viewer, και είναι τώρα εργασία σταθερά. Χρησιμοποιούμε μόνο υψηλής ποιότητας διευθύνσεις IP γι..
Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..
Greetings, I have compiled a guide for streamers, which will be very relevant at the moment. Now YouTube and twitch have disabled monetization from vi..
We have finally developed the APINow it will be more convenient for our partner sites to work with us.To update the maximum tariffs for YouTube, an up..
Λόγω της τεράστιας δημοτικότητας των υπηρεσιών συνεργασίας και του προγράμματος παραπομπής, φτιάξαμε έναν πίνακα συνεργασίας. Η ουσία είναι πολύ απλή:..
Οι Υπηρεσίες μας για Streamers

Shopee
Οι Υπηρεσίες μας για Δημιουργούς Περιεχομένου









