Social Stream Ninja
Français
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Configuration Twitch et EventSub

Utilisez la capture de page normale pour un chat simple, ou le mode EventSub/WebSocket pour les follows, abonnements, Bits, récompenses, raids, Hype Trains et contrôles de chaîne.

Choisir un mode de source Twitch

ModeIdéal pourDifférence importante
Standard Capture de base du chat public depuis une page de chat Twitch normale ou détachée. Lit ce que la page expose. Simple, mais ne fournit pas tous les événements EventSub.
WebSocket / EventSub Follows, abonnements, Bits, récompenses, raids, état du direct, Hype Trains, synchronisation de modération, envoi de messages et détails de chaîne. Nécessite OAuth Twitch. Les événements sont activés uniquement si le compte connecté, son rôle sur la chaîne, l’admissibilité de la chaîne et les autorisations accordées le permettent.

Configuration de l'application de bureau

  1. Sélectionnez Ajouter une source → Twitch (Add source → Twitch).
  2. Saisissez l’identifiant de chaîne Twitch utilisé dans son URL. Pour twitch.tv/examplechannel, saisissez examplechannel.
  3. Laissez WebSocket sélectionné pour la source EventSub plus complète. Twitch utilise actuellement ce mode par défaut dans l’application.
  4. Sélectionnez Activer la source (Activate source), puis Se connecter à Twitch (Sign in to Twitch).
  5. Autorisez les accès demandés et gardez la fenêtre source Twitch ouverte.
Écran de connexion de la source Twitch avec les méthodes Navigateur externe et Application locale
La source de bureau propose une procédure OAuth par navigateur externe et une procédure dans l’application locale. Le navigateur externe est généralement le plus simple si Twitch fonctionne déjà dans votre navigateur habituel.

Configurer EventSub dans l’extension de navigateur

  1. Installez et activez l'extension Social Stream Ninja actuelle.
  2. Ouvrez : page source Twitch EventSub.
  3. Remplacez examplechannel dans l’URL par l’identifiant de la chaîne à surveiller.
  4. Sélectionnez Se connecter à Twitch (Sign in to Twitch) et approuvez l’accès demandé.
  5. Gardez cette page ouverte. Vérifiez ses champs User et Channel avant de tester les alertes.
https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN

Pour la capture Standard de base, ouvrez plutôt la page de chat Twitch normale ou détachée et gardez le chat visible.

Autorisations demandées par Twitch

Social Stream demande un jeton utilisateur avec les autorisations nécessaires aux contrôles et abonnements pris en charge. Accorder une autorisation ne fait pas du compte un diffuseur ou modérateur ; Twitch vérifie toujours son rôle pour la chaîne sélectionnée.

Groupe d'autorisationsUtilisation
ChatLire le chat, envoyer des messages et lister les participants.
Followers et abonnésÉvénements de nouveaux followers, abonnements, abonnements offerts et messages de réabonnement.
Bits, récompenses et Hype TrainsCheers, échanges de points de chaîne contre des récompenses personnalisées et état des Hype Trains.
ModérationSuppression de messages, bannissements/exclusions temporaires et synchronisation des blocages lorsque le compte peut modérer la chaîne.
Gestion de la chaîneLire/modifier le titre et la catégorie, lire/gérer les publicités et afficher les indicateurs de chaîne.

Consultez la référence officielle Twitch des autorisations et Types d’abonnements EventSub.

Événements traités par la source actuelle

  • Nouveaux followers : new_follower.
  • Abonnements : new_subscriber, resub, et subscription_gift.
  • Bits : cheer avec une valeur de don.
  • Points de chaîne : reward.
  • Raids : raid.
  • État du direct et des publicités : stream_online, stream_offline, et ad_break.
  • Hype Train : hype_train mises à jour de début, progression et fin.
  • Modération : mises à jour des bannissements et suppressions de messages lorsque c’est autorisé.

Les événements d’abonnés Twitch nécessitent une chaîne affiliée/partenaire admissible et un accès de diffuseur. Les abonnements aux follows et à la modération exigent que l’utilisateur connecté soit le diffuseur ou un modérateur autorisé, selon l’événement.

Pour les noms d’alertes en aval et les champs de données, utilisez le guide de compatibilité des événements et alertes et Référence des événements.

Premières vérifications lorsqu’un événement manque

  1. Vérifiez que la page source affiche les valeurs correctes de Utilisateur (User) et Chaîne (Channel).
  2. Gardez la page/fenêtre source ouverte et vérifiez que sa connexion au chat est active.
  3. Si le chat fonctionne mais pas les follows/abonnements/récompenses, déconnectez-vous puis autorisez à nouveau pour accorder les autorisations actuelles.
  4. Vérifiez que le compte connecté est le diffuseur ou un modérateur autorisé de cette chaîne.
  5. Vérifiez que le dock et l’incrustation d’alertes utilisent le même identifiant de session Social Stream.
  6. Utilisez le faux message de test du panneau ou l’aperçu Multi Alerts pour distinguer les problèmes de capture de ceux de l’incrustation.

EventSub peut transmettre une notification plusieurs fois. Twitch documente une transmission au moins une fois. Social Stream inclut une protection contre les doublons, mais les clients API personnalisés devraient aussi dédupliquer selon l’identité de l’événement/du message lorsque c’est possible. Consultez la documentation officielle Présentation d’EventSub.