Configurazione Twitch ed EventSub

Usa l'acquisizione normale della pagina per la chat semplice oppure la modalità EventSub/WebSocket per follow, abbonamenti, Bits, ricompense, raid, Hype Train e controlli del canale.

Scegli una modalità sorgente Twitch

ModalitàIdeale perDifferenza importante
Standard Acquisizione di base della chat pubblica da una pagina chat Twitch normale o separata. Legge ciò che la pagina espone. È semplice, ma non fornisce l'insieme completo degli eventi EventSub.
WebSocket / EventSub Follow, abbonamenti, Bits, ricompense, raid, stato della diretta, Hype Train, sincronizzazione della moderazione, invio chat e dettagli del canale. Richiede OAuth Twitch. Gli eventi vengono attivati solo se account connesso, ruolo nel canale, idoneità del canale e ambito concesso lo consentono.

Configurazione dell'app desktop

  1. Seleziona Aggiungi sorgente → Twitch.
  2. Inserisci il nome di accesso del canale Twitch usato nel suo URL. Per twitch.tv/examplechannel, inserisci examplechannel.
  3. Lascia WebSocket selezionato per la sorgente EventSub più completa. Attualmente Twitch usa questa modalità come predefinita nell'app.
  4. Seleziona Attiva sorgente (Activate source), poi Accedi a Twitch.
  5. Autorizza i permessi richiesti e mantieni aperta la finestra della sorgente Twitch.
Schermata di accesso della sorgente Twitch con metodi External browser e Local app
La sorgente desktop offre un flusso OAuth tramite browser esterno e uno tramite app locale. Il browser esterno è di solito la soluzione più semplice quando Twitch funziona già nel browser normale.

Configurazione EventSub nell'estensione browser

  1. Installa e abilita l'estensione Social Stream Ninja attuale.
  2. Apri Pagina sorgente Twitch EventSub.
  3. Sostituisci examplechannel nell'URL con il nome di accesso del canale da monitorare.
  4. Seleziona Accedi a Twitch e approva l'accesso richiesto.
  5. Mantieni aperta quella pagina. Verifica che i campi User e Channel siano corretti prima di provare gli avvisi.
https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

Per l'acquisizione Standard di base, apri invece la normale pagina chat Twitch o la chat separata e mantienila visibile.

Cosa richiede Twitch

Social Stream richiede un token utente con i permessi necessari ai controlli e alle sottoscrizioni supportati. Concedere un ambito non rende un account broadcaster o moderatore; Twitch verifica comunque il ruolo dell'account nel canale selezionato.

Gruppo di autorizzazioniUsato per
ChatLeggere la chat, inviare messaggi ed elencare gli utenti in chat.
Follower e abbonatiEventi follow, eventi degli abbonati, abbonamenti regalo e messaggi di riabbonamento.
Bits, ricompense e Hype TrainCheer, riscatti personalizzati dei punti canale e stato degli Hype Train.
ModerazioneEliminazione dei messaggi, ban/timeout e sincronizzazione dei blocchi quando l'account può moderare il canale.
Gestione del canaleLeggere/aggiornare titolo e categoria, leggere/gestire annunci e mostrare metriche del canale.

Consulta il riferimento ufficiale Twitch sugli ambiti e tipi di sottoscrizione EventSub.

Eventi gestiti dalla sorgente attuale

  • Follow: new_follower.
  • Abbonamenti: new_subscriber, resub, e subscription_gift.
  • Bits: cheer con un valore di donazione.
  • Punti canale: reward.
  • Raid: raid.
  • Stato della diretta e degli annunci: stream_online, stream_offline, e ad_break.
  • Hype Train: hype_train aggiornamenti di inizio, avanzamento e fine.
  • Moderazione: aggiornamenti su ban ed eliminazione dei messaggi, quando consentiti.

Gli eventi degli abbonati Twitch richiedono un canale Affiliate/Partner idoneo e l'accesso del broadcaster. Le sottoscrizioni follow e moderazione richiedono che l'utente connesso sia il broadcaster o un moderatore autorizzato, a seconda dell'evento.

Per i nomi degli avvisi a valle e i campi dei payload, usa la guida alla compatibilità di eventi e avvisi e Riferimento degli eventi.

Primi controlli quando manca un evento

  1. Verifica che la pagina sorgente indichi i valori corretti di Utente (User) e Canale.
  2. Mantieni aperta la pagina/finestra della sorgente e verifica che la connessione chat sia attiva.
  3. Se la chat funziona ma follow/abbonamenti/ricompense no, esci e autorizza di nuovo per concedere gli ambiti attuali.
  4. Verifica che l'account connesso sia il broadcaster o un moderatore autorizzato per quel canale.
  5. Verifica che dock e overlay degli avvisi usino lo stesso ID di sessione Social Stream.
  6. Usa il messaggio fittizio di prova del popup o l'anteprima Multi Alerts per distinguere i problemi di acquisizione da quelli dell'overlay.

EventSub può consegnare una notifica più di una volta. Twitch documenta la consegna almeno una volta. Social Stream include una protezione dai duplicati, ma i consumer API personalizzati dovrebbero comunque deduplicare in base all'identità dell'evento/messaggio quando possibile. Consulta la documentazione ufficiale panoramica EventSub.