Support
Cum să configurezi publicarea automată a clipurilor Twitch în Discord

Publicarea automată a clipurilor Twitch noi în Discord prin EventSub

Cui i se potrivește postarea automată a clipurilor Twitch în Discord

Integrarea încorporată Twitch și Discord ajută la afișarea statusului streamului, la acordarea rolurilor și la anunțarea începerii emisiunii. De obicei, ea nu publică automat clipuri noi într-un canal text. Pentru asta este nevoie de un bot gata pregătit, de un serviciu de automatizare sau de o combinație proprie de Twitch EventSub și Discord webhook.

Soluțiile gata pregătite sunt potrivite dacă nu ai nevoie de dezvoltare: conectezi Twitch și Discord, alegi canalul și configurezi șablonul. Înainte de lansare, verifică dacă serviciul reacționează anume la crearea unui clip, nu doar la începerea transmisiunii. Dezavantajul soluțiilor gata pregătite este dependența de tarife, de filtrele disponibile și de formatarea mesajelor.

Alege schema de publicare înainte de a configura Twitch

Pentru o verificare rapidă, creează un canal Discord privat și testează manual câteva clipuri. Asta te va ajuta să vezi întârzierile, să verifici cardul linkului și să înțelegi dacă nu cumva sosesc mesaje despre clipuri care nu ar trebui să ajungă în comunitate.

  • Un bot gata pregătit se conectează mai repede, dar poate să nu accepte condițiile de publicare necesare și propriul format embed.
  • Constructorul de automatizări permite adăugarea de ramificații și filtre, dar o parte dintre triggere și acțiuni pot fi limitate de planul serviciului.
  • Un handler EventSub propriu oferă control asupra cozii, șablonului, logurilor și protecției împotriva duplicatelor, dar necesită un server, OAuth și întreținerea codului.

Stabilește din timp regula: să publici toate clipurile, doar clipurile proprietarului canalului, clipurile de la moderatori sau linkurile după aprobare manuală. Dezavantajul filtrării stricte este că un moment reușit creat de un spectator poate rămâne nepublicat.

Creează un Discord webhook pentru canalul cu clipuri

Webhook-ul se creează în setările canalului text Discord dorit. Pentru asta sunt necesare permisiuni de gestionare a webhook-urilor. El trimite mesaje cu numele și avatarul specificate, așa că nu este nevoie de un cont Discord separat pentru publicarea de bază.

  1. Deschide setările canalului text în care vor ajunge clipurile.
  2. Mergi la secțiunea de integrări și găsește webhook-ul.
  3. Creează un webhook nou, setează un nume clar și, dacă e nevoie, încarcă un avatar.
  4. Copiază URL-ul și salvează-l într-o variabilă de mediu sau într-un spațiu de stocare securizat.
  5. Trimite un mesaj de test în canalul privat.

URL-ul webhook-ului este un secret. Cine obține acest link va putea trimite mesaje în canal în numele webhook-ului. Nu adăuga adresa într-un repository public, în capturi de ecran ale panoului sau în codul clientului. În caz de scurgere, șterge webhook-ul și creează unul nou: schimbarea URL-ului la adresa veche nu este suficientă.

Conectează evenimentul de creare a clipului prin Twitch EventSub

În schema proprie, Twitch trimite evenimentul channel.clip.created la adresa HTTPS a handlerului tău. Handlerul verifică cererea, salvează datele despre clip, formează mesajul și îl transmite către Discord webhook. Contul Twitch nu obține astfel acces la serverul Discord.

Pentru abonare vei avea nevoie de o aplicație Twitch, de ID-ul canalului, de un callback URL și de o autorizare potrivită pentru tipul de eveniment ales. Cerințele privind tokenul și permisiunile trebuie verificate cu documentația actuală EventSub: ele se pot schimba. Nu folosi parametrii de autorizare din exemple vechi fără verificare.

Tokenul de utilizator al proprietarului canalului poate expira sau poate fi revocat. Dezavantajul acestei scheme este că refresh tokenul trebuie păstrat în siguranță și accesul trebuie reînnoit la timp. Dacă reînnoirea nu funcționează, abonarea sau crearea de abonamente noi poate înceta să funcționeze fără o eroare vizibilă în Discord.

Pregătește o adresă HTTPS pentru notificările Twitch

Callback URL trebuie să fie accesibil din internet prin HTTPS. La crearea abonamentului, Twitch trimite o cerere de verificare cu tipul webhook_callback_verification. Serverul trebuie să se asigure de autenticitatea cererii și să returneze valoarea challenge ca text simplu. Până când acest pas nu este trecut, abonamentul nu devine activ.

Evenimentele de lucru sosesc cu tipul notification. Pentru ele este mai bine să returnezi rapid un răspuns HTTP de succes, iar publicarea să o transmiți într-o coadă sau unui handler separat. Dacă aștepți răspunsul Discord în interiorul cererii EventSub, întârzierea rețelei crește riscul livrării repetate a notificării.

Pentru dezvoltarea locală poți folosi un tunel HTTPS. Dezavantajul lui este că adresa publică se poate schimba după repornire. Tunelul este comod pentru teste, dar nu înlocuiește un endpoint permanent pentru automatizarea în producție.

Verifică semnătura pe baza corpului original al cererii

Semnătura EventSub este construită din ID-ul mesajului, timpul trimiterii și corpul original al cererii HTTP. Mai întâi obține octeții body-ului, salvează-i fără modificări, apoi verifică HMAC. Nu poți analiza JSON-ul și reconstrui obiectul înainte de verificarea semnăturii. Ordinea câmpurilor, spațiile sau codificarea se pot schimba, iar semnătura calculată nu va coincide.

Pentru verificare sunt necesare antetele Twitch-Eventsub-Message-Id, Twitch-Eventsub-Message-Timestamp și Twitch-Eventsub-Message-Signature. Șirul pentru HMAC SHA-256 se compune astfel: messageId + timestamp + rawBody. Ca cheie se folosește secretul stabilit la crearea abonamentului. Rezultatul în formă hexazecimală se compară cu valoarea antetului, care începe cu sha256=.

În Node.js logica arată așa: creează HMAC SHA-256 cu secretul abonamentului, transmite în el messageId + timestamp + rawBody, adaugă la hash prefixul sha256= și compară cu Twitch-Eventsub-Message-Signature prin crypto.timingSafeEqual. Înainte de comparare, verifică aceeași lungime a șirurilor, altfel comparația sigură se va termina cu eroare.

Schema transmiterii notificării despre un clip Twitch nou prin EventSub în canalele Discord

Verifică tipul mesajului și momentul trimiterii lui

Verificarea HMAC este necesară pentru fiecare cerere EventSub, inclusiv pentru callback verification, notification și revocation. Doar după o verificare reușită citește JSON-ul și determină tipul mesajului după antetul Twitch-Eventsub-Message-Type. Pentru verificarea callback returnează challenge, pentru notification creează o sarcină de publicare, pentru revocation înregistrează în log motivul deconectării abonamentului.

În plus, compară timpul din Twitch-Eventsub-Message-Timestamp cu timpul curent al serverului. O fereastră limitată de acceptare ajută la eliminarea cererilor vechi, retrimise de o terță parte. Această verificare nu înlocuiește HMAC: timestampul poate fi citit din cerere, dar fără secret nu se poate crea o semnătură corectă.

Păstrează secretul abonamentului separat de cod și de URL-ul Discord webhook. Dezavantajul schimbării frecvente a secretului fără o procedură de actualizare este că abonamentul existent va înceta să treacă verificarea. Mai întâi creează sau actualizează abonamentul, apoi comută secretul în handler.

Nu publica același clip de două ori

EventSub poate livra din nou aceeași notificare dacă endpointul a răspuns lent, conexiunea s-a întrerupt sau a apărut o eroare de rețea. Salvează Twitch-Eventsub-Message-Id într-o bază de date persistentă cu index unic. Dacă un astfel de ID a fost deja procesat, nu crea o a doua sarcină și returnează un răspuns de succes.

Adaugă o a doua cheie unică după ID-ul clipului din datele evenimentului. Asta protejează împotriva publicării repetate atunci când același videoclip sosește în notificări diferite sau sarcina a fost repornită după o defecțiune. Încearcă mai întâi să înregistrezi clip_id în tabelul clipurilor publicate și abia după înregistrarea reușită trimite mesajul în Discord.

Această schemă are un dezavantaj: o defecțiune între înregistrarea clip_id și trimiterea webhook-ului poate lăsa clipul marcat ca publicat fără un mesaj în Discord. Pentru astfel de cazuri, păstrează statusul sarcinii: creată, se trimite, publicată, eroare. Sarcinile cu status de eroare pot fi reluate manual sau conform regulilor cozii.

Compune mesajul embed pentru Discord

În mesaj este util să incluzi titlul clipului, numele autorului, numele canalului, categoria și linkul direct. Nu introduce textul din Twitch în JSON manual prin concatenare de șiruri: ghilimelele și caracterele speciale pot strica cererea. Formează obiectul prin mijloacele limbajului și trimite-l ca JSON.

Șablonul embed poate arăta astfel: titlul „Clip nou pe canal”, descrierea „Autor: {creator_name}”, URL „{clip_url}”, câmpul „Titlu” cu valoarea „{clip_title}”, câmpul „Categorie” cu valoarea „{game_name}”. Dacă în eveniment nu există categoria sau numele autorului, lasă câmpul gol sau nu îl adăuga.

Poți adăuga o mențiune a rolului, dar nu o trimite la fiecare clip fără restricții. Dezavantajul notificărilor permanente este că membrii serverului vor începe să dezactiveze canalul sau rolul. Pentru un canal activ este mai bine să publici clipurile fără ping sau să menționezi rolul doar după o regulă separată.

Testează scenariul înainte de publicarea în canalul principal

La început folosește un canal Discord de test și creează câteva clipuri cu titluri, autori și categorii diferite. Verifică dacă trece callback verification, dacă semnătura este validată înainte de analiza JSON, dacă apare un singur card pentru un clip_id și dacă mesajul nu este publicat la livrarea repetată a EventSub.

  • Verifică dacă serverul citește raw body înainte de parserul JSON sau salvează octeții originali ai cererii.
  • Asigură-te că challenge este returnat doar după verificarea reușită a Twitch-Eventsub-Message-Signature.
  • Verifică tratarea erorii Discord webhook și reluarea sarcinii fără crearea unui al doilea mesaj.
  • Urmărește logurile după message ID, clip_id, tipul mesajului EventSub și statusul trimiterii.

Nu scrie în loguri secretul abonamentului, tokenurile OAuth și URL-ul complet al Discord webhook. Pentru diagnosticare sunt suficiente ID-ul evenimentului, ID-ul clipului, codul de răspuns Discord și textul erorii tehnice fără antete confidențiale.

Last Articles

Noul design al site-ului

Ce s-a schimbat în design și funcționalitate Am actualizat site-ul pentru a lucra cu el mai rapid și mai comod. Principalele modificări vizează inter..

15.08.2026 Nou

News SP

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..

08.04.2026 Actualizare

Am adunat pentru dvs. toate promoțiile și tragerile la sorți curente până la 01.01.2026

1. Folosiți codul promoțional "December2025" pentru o reducere de 15% pentru toți spectatorii noștri2. Am redus până la 1 ianuarie prețurile de bază p..

26.12.2025 Încheiată

Cooperarea cu echipele și revânzătorii

Serviciile Twitch sunt lucrând stabil, așa că suntem gata să cooperăm cu Echipe, revânzători, proprietari de servicii, proprietari de bot și mulți..

22.10.2025 Pentru parteneri

Spectatorii Twitch sunt stabili, dar există unele nuanțe.

Noi au actualizat complet serviciile noastre Twitch viewer și acum sunt lucrează stabil. Folosim doar adrese IP de înaltă calitate pentru spectato..

22.10.2025 Actualizare

Twitch Viewer Configurator

Hello everyone! Today, we are announcing a new feature—"Twitch Viewer Configurator". Now, you can customize any plan for your Twitch channel. Choo..

15.06.2025 Nou

If YouTube is blocked, where to stream now?

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..

16.03.2022 Important

API SP

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..

02.09.2021 Pentru parteneri

PARTENERI ȘI RECOMANDĂRI: NOI TERMENI!

Datorită popularității uriașe a serviciilor de parteneriat și programului de recomandare, am realizat o masă de cooperare. Esența este foarte simplă: ..

12.08.2020 Pentru parteneri

Panou de control al spectatorilor [Twitch | Kick | YouTube | VK Video Live]

Creează-ți propriul plan personalizat
Alimentarea soldului, comanda dintr-un clic, reduceri și bonusuri sunt disponibile doar pentru utilizatorii înregistrați. Înregistrează-te.
Dacă nu ai găsit serviciul potrivit sau l-ai găsit mai ieftin, scrie suportului nostru pe Telegram sau în chat și vom rezolva orice problemă.

 

Serviciile noastre pentru streameri

 

Serviciile noastre pentru creatorii de conținut

 

Nou

Bot Telegram @BOT_SP_RU_BOT

Comandați sau repetați într-un minut, soldul și statusul comenzilor — direct în Telegram

Repetă comandaStatusul comenzilorAlimentare soldCoduri promoționale