Aller au contenu
twitch.apiv2.0

Référence

Types d'événements

Tous les types d'abonnement EventSub connus de la bibliothèque, avec leur version, leur condition et le scope nécessaire.

Le nom s’autocomplète dans on() et subscribe(), et la condition comme l’événement sont typés à partir de lui. Un type qui existe en plusieurs versions figure sous son nom simple pour la plus récente et sous nom@version pour les anciennes.

TypeVersionSe déclenche quand
automod.message.hold2AutoMod a retenu un message pour examen. Seuls les termes bloqués publics le déclenchent, pas les termes privés.
automod.message.hold@11AutoMod a retenu un message pour examen (ancien format, sans la raison).
automod.message.update2Un message en attente dans la file d’AutoMod a été approuvé ou refusé, ou a expiré. Seuls les termes bloqués publics le déclenchent, pas les termes privés.
automod.message.update@11Un message en attente dans la file d’AutoMod a été approuvé ou refusé, ou a expiré (ancien format, sans la raison).
automod.settings.update1Les réglages AutoMod de la chaîne ont changé.
automod.terms.update1Les termes autorisés ou bloqués de la chaîne ont changé. Les changements de termes privés ne sont pas envoyés.
channel.ad_break.begin1Une coupure publicitaire mid-roll a commencé, lancée à la main ou programmée par Ads Manager.
channel.ban1Un spectateur a été banni ou mis sous timeout sur la chaîne.
channel.bits.use1Des Bits ont été utilisés sur la chaîne, par un cheer ou un Power-up. Les Bits dépensés dans les extensions ne sont pas compris.
channel.channel_points_automatic_reward_redemption.add2Un spectateur a utilisé une récompense automatique de points de chaîne (version 2, message découpé en fragments).
channel.channel_points_automatic_reward_redemption.add@11Un spectateur a utilisé une récompense automatique de points de chaîne (version 1, message avec la position des emotes).
channel.channel_points_custom_reward_redemption.add1Un spectateur a utilisé une récompense personnalisée de points de chaîne.
channel.channel_points_custom_reward_redemption.update1Une utilisation d’une récompense personnalisée de points de chaîne a été honorée ou annulée.
channel.channel_points_custom_reward.add1Le diffuseur a créé une récompense personnalisée de points de chaîne.
channel.channel_points_custom_reward.remove1Une récompense personnalisée de points de chaîne a été supprimée.
channel.channel_points_custom_reward.update1Une récompense personnalisée de points de chaîne a été modifiée.
channel.charity_campaign.donate1Un spectateur a fait un don à la collecte caritative du diffuseur.
channel.charity_campaign.progress1Une collecte caritative a progressé vers son objectif, ou le diffuseur a modifié cet objectif.
channel.charity_campaign.start1Le diffuseur a lancé une collecte caritative. Peut arriver après le premier événement de progression.
channel.charity_campaign.stop1Le diffuseur a arrêté une collecte caritative.
channel.chat_settings.update1Les réglages du chat de la chaîne ont changé (mode emotes seules, followers, lent, abonnés ou messages uniques).
channel.chat.clear1Un modérateur ou un bot a effacé tous les messages du chat.
channel.chat.clear_user_messages1Un modérateur ou un bot a effacé tous les messages d’un utilisateur, après un bannissement ou un timeout.
channel.chat.message1Un utilisateur a envoyé un message dans le chat.
channel.chat.message_delete1Un modérateur a supprimé un message du chat.
channel.chat.notification1Il s’est produit quelque chose que le chat affiche comme une notification, par exemple un abonnement, un abonnement offert, un raid ou une annonce.
channel.chat.user_message_hold1Un message de l’utilisateur indiqué dans user_id a été retenu par AutoMod.
channel.chat.user_message_update1Le statut AutoMod d’un message retenu de l’utilisateur indiqué dans user_id a changé.
channel.cheer1Un utilisateur a envoyé un cheer en Bits sur la chaîne.
channel.custom_power_up_redemption.add1Un spectateur a utilisé un Power-up personnalisé.
channel.follow2Quelqu’un s’est mis à suivre la chaîne.
channel.goal.begin1Le diffuseur a lancé un objectif de créateur. Peut arriver après les premiers événements de progression.
channel.goal.end1Le diffuseur a mis fin à un objectif de créateur.
channel.goal.progress1Un objectif de créateur a progressé ou reculé.
channel.guest_star_guest.updatebetaUn invité ou un emplacement a changé dans une session Guest Star en cours.
channel.guest_star_session.beginbetaL’hôte a lancé une session Guest Star.
channel.guest_star_session.endbetaUne session Guest Star s’est terminée, fermée par l’hôte ou par Twitch.
channel.guest_star_settings.updatebetaL’hôte a changé les préférences Guest Star de la chaîne.
channel.hype_train.begin2Un Hype Train a démarré sur la chaîne. Les premiers événements de progression peuvent arriver avant celui-ci.
channel.hype_train.end2Un Hype Train s’est terminé sur la chaîne.
channel.hype_train.progress2Une contribution a fait avancer un Hype Train en cours.
channel.moderate2Un modérateur a effectué une action de modération sur la chaîne, avertissements compris. Affinez l’événement sur action pour lire les détails correspondants.
channel.moderate@11Un modérateur a effectué une action de modération sur la chaîne. La version 1 ne signale pas les avertissements. Affinez l’événement sur action pour lire les détails correspondants.
channel.moderator.add1Un utilisateur est devenu modérateur de la chaîne.
channel.moderator.remove1Un utilisateur a perdu le statut de modérateur sur la chaîne.
channel.poll.begin1Un sondage a démarré sur la chaîne.
channel.poll.end1Un sondage s’est terminé sur la chaîne.
channel.poll.progress1Des spectateurs ont voté dans un sondage en cours.
channel.prediction.begin1Une prédiction a démarré sur la chaîne.
channel.prediction.end1Une prédiction s’est terminée, résolue ou annulée.
channel.prediction.lock1Les paris d’une prédiction ont été clos.
channel.prediction.progress1Des spectateurs ont parié sur une prédiction en cours.
channel.raid1Un diffuseur a lancé un raid sur une autre chaîne.
channel.shared_chat.begin1La chaîne est devenue active dans une session de chat partagé.
channel.shared_chat.end1La chaîne a quitté une session de chat partagé, ou la session s’est terminée.
channel.shared_chat.update1La session de chat partagé à laquelle la chaîne participe a changé, par exemple ses participants.
channel.shield_mode.begin1Le Shield Mode a été activé sur la chaîne.
channel.shield_mode.end1Le Shield Mode a été désactivé sur la chaîne.
channel.shoutout.create1Le diffuseur a envoyé un shoutout à une autre chaîne.
channel.shoutout.receive1Le diffuseur a reçu un shoutout d’une autre chaîne. Ne se déclenche que lorsque Twitch publie le shoutout dans le fil d’activité du diffuseur.
channel.subscribe1Un utilisateur s’est abonné à la chaîne. Les réabonnements ne sont pas compris.
channel.subscription.end1Un abonnement à la chaîne a pris fin.
channel.subscription.gift1Un spectateur a offert un ou plusieurs abonnements sur la chaîne.
channel.subscription.message1Un abonné a partagé un message de réabonnement dans le chat.
channel.suspicious_user.message1Un utilisateur signalé comme suspect a envoyé un message dans le chat.
channel.suspicious_user.update1Un modérateur a changé le traitement appliqué à un utilisateur suspect.
channel.unban1Un spectateur a été débanni sur la chaîne.
channel.unban_request.create1Un utilisateur banni a déposé une demande de débannissement.
channel.unban_request.resolve1Une demande de débannissement a été approuvée, refusée ou annulée.
channel.update2Le diffuseur a changé le titre, la catégorie, la langue ou les étiquettes de classification du contenu de la chaîne.
channel.vip.add1Un utilisateur est devenu VIP de la chaîne.
channel.vip.remove1Un utilisateur a perdu le statut VIP sur la chaîne.
channel.warning.acknowledge1Un utilisateur a pris acte d’un avertissement reçu sur la chaîne.
channel.warning.send1Un avertissement a été envoyé à un utilisateur sur la chaîne.
conduit.shard.disabled1EventSub a désactivé un shard de conduit parce que l’état de son transport a changé.
drop.entitlement.grant1Des spectateurs ont reçu des droits liés aux Drops. Livré par lots : l’événement est un tableau de droits, et l’abonnement doit être créé avec la livraison par lots activée. Webhooks et conduits uniquement.
extension.bits_transaction.create1Une transaction en Bits a eu lieu dans une extension. Webhooks et conduits uniquement.
stream.offline1Le diffuseur a arrêté de diffuser.
stream.online1Le diffuseur a lancé un stream.
user.authorization.grant1Un utilisateur a autorisé l’application. Webhooks et conduits uniquement.
user.authorization.revoke1L’application a perdu l’autorisation d’un utilisateur. Webhooks et conduits uniquement.
user.update1Un utilisateur a modifié son compte (nom, description, e-mail…).
user.whisper.message1L’utilisateur a reçu un chuchotement.

AutoMod a retenu un message pour examen. Seuls les termes bloqués publics le déclenchent, pas les termes privés.

Scope : moderator:manage:automod, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodMessageHoldEvent

Référence Twitch

AutoMod a retenu un message pour examen (ancien format, sans la raison).

Scope : moderator:manage:automod, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodMessageHoldV1Event

Référence Twitch

Un message en attente dans la file d’AutoMod a été approuvé ou refusé, ou a expiré. Seuls les termes bloqués publics le déclenchent, pas les termes privés.

Scope : moderator:manage:automod, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodMessageUpdateEvent

Référence Twitch

Un message en attente dans la file d’AutoMod a été approuvé ou refusé, ou a expiré (ancien format, sans la raison).

Scope : moderator:manage:automod, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodMessageUpdateV1Event

Référence Twitch

Les réglages AutoMod de la chaîne ont changé.

Scope : moderator:read:automod_settings, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodSettingsUpdateEvent

Référence Twitch

Les termes autorisés ou bloqués de la chaîne ont changé. Les changements de termes privés ne sont pas envoyés.

Scope : moderator:manage:automod, accordé par le modérateur indiqué dans moderator_user_id, qui doit être le diffuseur ou l’un de ses modérateurs.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.
moderator_user_id requisstringIdentifiant du modérateur qui s’abonne. Ce doit être l’utilisateur du jeton d’accès.

Événement : AutomodTermsUpdateEvent

Référence Twitch

Une coupure publicitaire mid-roll a commencé, lancée à la main ou programmée par Ads Manager.

Scope : channel:read:ads, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les coupures publicitaires.

Événement : ChannelAdBreakBeginEvent

Référence Twitch

Un spectateur a été banni ou mis sous timeout sur la chaîne.

Scope : channel:moderate, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les bannissements et les timeouts.

Événement : ChannelBanEvent

Référence Twitch

Des Bits ont été utilisés sur la chaîne, par un cheer ou un Power-up. Les Bits dépensés dans les extensions ne sont pas compris.

Scope : bits:read, avec un jeton utilisateur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.

Événement : ChannelBitsUseEvent

Référence Twitch

channel.channel_points_automatic_reward_redemption.add

Section intitulée « channel.channel_points_automatic_reward_redemption.add »

Un spectateur a utilisé une récompense automatique de points de chaîne (version 2, message découpé en fragments).

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les utilisations de récompenses automatiques.

Événement : ChannelChannelPointsAutomaticRewardRedemptionAddEvent

Référence Twitch

channel.channel_points_automatic_reward_redemption.add@1

Section intitulée « channel.channel_points_automatic_reward_redemption.add@1 »

Un spectateur a utilisé une récompense automatique de points de chaîne (version 1, message avec la position des emotes).

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les utilisations de récompenses automatiques.

Événement : ChannelChannelPointsAutomaticRewardRedemptionAddV1Event

Référence Twitch

channel.channel_points_custom_reward_redemption.add

Section intitulée « channel.channel_points_custom_reward_redemption.add »

Un spectateur a utilisé une récompense personnalisée de points de chaîne.

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les utilisations de récompenses.
reward_idstringLimite les notifications à cette récompense.

Événement : ChannelChannelPointsCustomRewardRedemption

Référence Twitch

channel.channel_points_custom_reward_redemption.update

Section intitulée « channel.channel_points_custom_reward_redemption.update »

Une utilisation d’une récompense personnalisée de points de chaîne a été honorée ou annulée.

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les utilisations de récompenses.
reward_idstringLimite les notifications à cette récompense.

Événement : ChannelChannelPointsCustomRewardRedemption

Référence Twitch

Le diffuseur a créé une récompense personnalisée de points de chaîne.

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les nouvelles récompenses personnalisées.

Événement : ChannelChannelPointsCustomReward

Référence Twitch

Une récompense personnalisée de points de chaîne a été supprimée.

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne à qui appartiennent les récompenses.
reward_idstringLimite les notifications à cette récompense.

Événement : ChannelChannelPointsCustomReward

Référence Twitch

Une récompense personnalisée de points de chaîne a été modifiée.

Scope : l’un de channel:read:redemptions, channel:manage:redemptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne à qui appartiennent les récompenses.
reward_idstringLimite les notifications à cette récompense.

Événement : ChannelChannelPointsCustomReward

Référence Twitch

Un spectateur a fait un don à la collecte caritative du diffuseur.

Scope : channel:read:charity, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui mène la collecte caritative.

Événement : ChannelCharityCampaignDonateEvent

Référence Twitch

Une collecte caritative a progressé vers son objectif, ou le diffuseur a modifié cet objectif.

Scope : channel:read:charity, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui mène la collecte caritative.

Événement : ChannelCharityCampaignBase

Référence Twitch

Le diffuseur a lancé une collecte caritative. Peut arriver après le premier événement de progression.

Scope : channel:read:charity, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui mène la collecte caritative.

Événement : ChannelCharityCampaignStartEvent

Référence Twitch

Le diffuseur a arrêté une collecte caritative.

Scope : channel:read:charity, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui mène la collecte caritative.

Événement : ChannelCharityCampaignStopEvent

Référence Twitch

Les réglages du chat de la chaîne ont changé (mode emotes seules, followers, lent, abonnés ou messages uniques).

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatSettingsUpdateEvent

Référence Twitch

Un modérateur ou un bot a effacé tous les messages du chat.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatClearEvent

Référence Twitch

Un modérateur ou un bot a effacé tous les messages d’un utilisateur, après un bannissement ou un timeout.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatClearUserMessagesEvent

Référence Twitch

Un utilisateur a envoyé un message dans le chat.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatMessageEvent

Référence Twitch

Un modérateur a supprimé un message du chat.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatMessageDeleteEvent

Référence Twitch

Il s’est produit quelque chose que le chat affiche comme une notification, par exemple un abonnement, un abonnement offert, un raid ou une annonce.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur, et soit channel:bot de la part du diffuseur, soit le statut de modérateur sur la chaîne.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatNotificationEvent

Référence Twitch

Un message de l’utilisateur indiqué dans user_id a été retenu par AutoMod.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatUserMessageHoldEvent

Référence Twitch

Le statut AutoMod d’un message retenu de l’utilisateur indiqué dans user_id a changé.

Scope : user:read:chat, accordé par l’utilisateur indiqué dans user_id. Avec un jeton d’application, il faut aussi user:bot de la part de cet utilisateur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont le chat est surveillé.
user_id requisstringIdentifiant de l’utilisateur au nom duquel le chat est lu.

Événement : ChannelChatUserMessageUpdateEvent

Référence Twitch

Un utilisateur a envoyé un cheer en Bits sur la chaîne.

Scope : bits:read, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les cheers.

Événement : ChannelCheerEvent

Référence Twitch

Un spectateur a utilisé un Power-up personnalisé.

Scope : bits:read, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les utilisations de Power-ups personnalisés.
reward_idstringLimite les notifications à ce Power-up personnalisé.

Événement : ChannelCustomPowerUpRedemptionAddEvent

Référence Twitch

Quelqu’un s’est mis à suivre la chaîne.

Scope : moderator:read:followers, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les nouveaux followers.
moderator_user_id requisstringIdentifiant d’un modérateur de la chaîne, ou du diffuseur quand l’autorisation vient de lui.

Événement : ChannelFollowEvent

Référence Twitch

Le diffuseur a lancé un objectif de créateur. Peut arriver après les premiers événements de progression.

Scope : channel:read:goals, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur ; ce doit être l’utilisateur du jeton d’accès.

Événement : ChannelGoalBase

Référence Twitch

Le diffuseur a mis fin à un objectif de créateur.

Scope : channel:read:goals, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur ; ce doit être l’utilisateur du jeton d’accès.

Événement : ChannelGoalEndEvent

Référence Twitch

Un objectif de créateur a progressé ou reculé.

Scope : channel:read:goals, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur ; ce doit être l’utilisateur du jeton d’accès.

Événement : ChannelGoalBase

Référence Twitch

Un invité ou un emplacement a changé dans une session Guest Star en cours.

Scope : l’un de channel:read:guest_star, channel:manage:guest_star, moderator:read:guest_star, moderator:manage:guest_star, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui accueille la session Guest Star.
moderator_user_id requisstringIdentifiant du diffuseur ou de l’un des modérateurs de la chaîne ; le jeton doit appartenir à cet utilisateur.

Événement : ChannelGuestStarGuestUpdateEvent

Référence Twitch

L’hôte a lancé une session Guest Star.

Scope : l’un de channel:read:guest_star, channel:manage:guest_star, moderator:read:guest_star, moderator:manage:guest_star, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui accueille la session Guest Star.
moderator_user_id requisstringIdentifiant du diffuseur ou de l’un des modérateurs de la chaîne ; le jeton doit appartenir à cet utilisateur.

Événement : ChannelGuestStarSessionBeginEvent

Référence Twitch

Une session Guest Star s’est terminée, fermée par l’hôte ou par Twitch.

Scope : l’un de channel:read:guest_star, channel:manage:guest_star, moderator:read:guest_star, moderator:manage:guest_star, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui accueille la session Guest Star.
moderator_user_id requisstringIdentifiant du diffuseur ou de l’un des modérateurs de la chaîne ; le jeton doit appartenir à cet utilisateur.

Événement : ChannelGuestStarSessionEndEvent

Référence Twitch

L’hôte a changé les préférences Guest Star de la chaîne.

Scope : l’un de channel:read:guest_star, channel:manage:guest_star, moderator:read:guest_star, moderator:manage:guest_star, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne qui accueille la session Guest Star.
moderator_user_id requisstringIdentifiant du diffuseur ou de l’un des modérateurs de la chaîne ; le jeton doit appartenir à cet utilisateur.

Événement : ChannelGuestStarSettingsUpdateEvent

Référence Twitch

Un Hype Train a démarré sur la chaîne. Les premiers événements de progression peuvent arriver avant celui-ci.

Scope : channel:read:hype_train, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les Hype Trains.

Événement : ChannelHypeTrainBeginEvent

Référence Twitch

Un Hype Train s’est terminé sur la chaîne.

Scope : channel:read:hype_train, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les Hype Trains.

Événement : ChannelHypeTrainEndEvent

Référence Twitch

Une contribution a fait avancer un Hype Train en cours.

Scope : channel:read:hype_train, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les Hype Trains.

Événement : ChannelHypeTrainProgressEvent

Référence Twitch

Un modérateur a effectué une action de modération sur la chaîne, avertissements compris. Affinez l’événement sur action pour lire les détails correspondants.

Scope : tous les suivants, accordés par l’utilisateur indiqué dans moderator_user_id : l’un de moderator:read:blocked_terms, moderator:manage:blocked_terms ; l’un de moderator:read:chat_settings, moderator:manage:chat_settings ; l’un de moderator:read:unban_requests, moderator:manage:unban_requests ; l’un de moderator:read:banned_users, moderator:manage:banned_users ; l’un de moderator:read:chat_messages, moderator:manage:chat_messages ; l’un de moderator:read:warnings, moderator:manage:warnings ; moderator:read:moderators ; moderator:read:vips.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les actions de modération.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé les scopes.

Événement : ChannelModerateEvent

Référence Twitch

Un modérateur a effectué une action de modération sur la chaîne. La version 1 ne signale pas les avertissements. Affinez l’événement sur action pour lire les détails correspondants.

Scope : tous les suivants, accordés par l’utilisateur indiqué dans moderator_user_id : l’un de moderator:read:blocked_terms, moderator:manage:blocked_terms ; l’un de moderator:read:chat_settings, moderator:manage:chat_settings ; l’un de moderator:read:unban_requests, moderator:manage:unban_requests ; l’un de moderator:read:banned_users, moderator:manage:banned_users ; l’un de moderator:read:chat_messages, moderator:manage:chat_messages ; moderator:read:moderators ; moderator:read:vips.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les actions de modération.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé les scopes.

Événement : ChannelModerateV1Event

Référence Twitch

Un utilisateur est devenu modérateur de la chaîne.

Scope : moderation:read, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les nouveaux modérateurs.

Événement : ChannelModeratorAddEvent

Référence Twitch

Un utilisateur a perdu le statut de modérateur sur la chaîne.

Scope : moderation:read, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les retraits de modérateur.

Événement : ChannelModeratorRemoveEvent

Référence Twitch

Un sondage a démarré sur la chaîne.

Scope : l’un de channel:read:polls, channel:manage:polls, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les sondages.

Événement : ChannelPollBeginEvent

Référence Twitch

Un sondage s’est terminé sur la chaîne.

Scope : l’un de channel:read:polls, channel:manage:polls, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les sondages.

Événement : ChannelPollEndEvent

Référence Twitch

Des spectateurs ont voté dans un sondage en cours.

Scope : l’un de channel:read:polls, channel:manage:polls, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les sondages.

Événement : ChannelPollProgressEvent

Référence Twitch

Une prédiction a démarré sur la chaîne.

Scope : l’un de channel:read:predictions, channel:manage:predictions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les prédictions.

Événement : ChannelPredictionBeginEvent

Référence Twitch

Une prédiction s’est terminée, résolue ou annulée.

Scope : l’un de channel:read:predictions, channel:manage:predictions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les prédictions.

Événement : ChannelPredictionEndEvent

Référence Twitch

Les paris d’une prédiction ont été clos.

Scope : l’un de channel:read:predictions, channel:manage:predictions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les prédictions.

Événement : ChannelPredictionLockEvent

Référence Twitch

Des spectateurs ont parié sur une prédiction en cours.

Scope : l’un de channel:read:predictions, channel:manage:predictions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant de la chaîne dont on veut les prédictions.

Événement : ChannelPredictionProgressEvent

Référence Twitch

Un diffuseur a lancé un raid sur une autre chaîne.

Scope : aucun.

Condition

NomTypeDescription
from_broadcaster_user_idstringIdentifiant du diffuseur dont on surveille les raids lancés.
to_broadcaster_user_idstringIdentifiant du diffuseur dont on surveille les raids reçus.

Événement : ChannelRaidEvent

Référence Twitch

La chaîne est devenue active dans une session de chat partagé.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.

Événement : ChannelSharedChatBeginEvent

Référence Twitch

La chaîne a quitté une session de chat partagé, ou la session s’est terminée.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.

Événement : ChannelSharedChatEndEvent

Référence Twitch

La session de chat partagé à laquelle la chaîne participe a changé, par exemple ses participants.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont la chaîne est surveillée.

Événement : ChannelSharedChatUpdateEvent

Référence Twitch

Le Shield Mode a été activé sur la chaîne.

Scope : l’un de moderator:read:shield_mode, moderator:manage:shield_mode, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille le Shield Mode.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelShieldModeBeginEvent

Référence Twitch

Le Shield Mode a été désactivé sur la chaîne.

Scope : l’un de moderator:read:shield_mode, moderator:manage:shield_mode, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille le Shield Mode.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelShieldModeEndEvent

Référence Twitch

Le diffuseur a envoyé un shoutout à une autre chaîne.

Scope : l’un de moderator:read:shoutouts, moderator:manage:shoutouts, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les shoutouts envoyés.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelShoutoutCreateEvent

Référence Twitch

Le diffuseur a reçu un shoutout d’une autre chaîne. Ne se déclenche que lorsque Twitch publie le shoutout dans le fil d’activité du diffuseur.

Scope : l’un de moderator:read:shoutouts, moderator:manage:shoutouts, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les shoutouts reçus.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelShoutoutReceiveEvent

Référence Twitch

Un utilisateur s’est abonné à la chaîne. Les réabonnements ne sont pas compris.

Scope : channel:read:subscriptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les nouveaux abonnés.

Événement : ChannelSubscribeEvent

Référence Twitch

Un abonnement à la chaîne a pris fin.

Scope : channel:read:subscriptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les fins d’abonnement.

Événement : ChannelSubscriptionEndEvent

Référence Twitch

Un spectateur a offert un ou plusieurs abonnements sur la chaîne.

Scope : channel:read:subscriptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les abonnements offerts.

Événement : ChannelSubscriptionGiftEvent

Référence Twitch

Un abonné a partagé un message de réabonnement dans le chat.

Scope : channel:read:subscriptions, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les messages de réabonnement.

Événement : ChannelSubscriptionMessageEvent

Référence Twitch

Un utilisateur signalé comme suspect a envoyé un message dans le chat.

Scope : moderator:read:suspicious_users, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille le chat.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelSuspiciousUserMessageEvent

Référence Twitch

Un modérateur a changé le traitement appliqué à un utilisateur suspect.

Scope : moderator:read:suspicious_users, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les utilisateurs suspects.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelSuspiciousUserUpdateEvent

Référence Twitch

Un spectateur a été débanni sur la chaîne.

Scope : channel:moderate, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les débannissements.

Événement : ChannelUnbanEvent

Référence Twitch

Un utilisateur banni a déposé une demande de débannissement.

Scope : l’un de moderator:read:unban_requests, moderator:manage:unban_requests, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les demandes de débannissement.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelUnbanRequestCreateEvent

Référence Twitch

Une demande de débannissement a été approuvée, refusée ou annulée.

Scope : l’un de moderator:read:unban_requests, moderator:manage:unban_requests, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les demandes de débannissement traitées.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelUnbanRequestResolveEvent

Référence Twitch

Le diffuseur a changé le titre, la catégorie, la langue ou les étiquettes de classification du contenu de la chaîne.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les réglages de chaîne.

Événement : ChannelUpdateEvent

Référence Twitch

Un utilisateur est devenu VIP de la chaîne.

Scope : l’un de channel:read:vips, channel:manage:vips, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les nouveaux VIP.

Événement : ChannelVipAddEvent

Référence Twitch

Un utilisateur a perdu le statut VIP sur la chaîne.

Scope : l’un de channel:read:vips, channel:manage:vips, accordé par le diffuseur.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les retraits de VIP.

Événement : ChannelVipRemoveEvent

Référence Twitch

Un utilisateur a pris acte d’un avertissement reçu sur la chaîne.

Scope : l’un de moderator:read:warnings, moderator:manage:warnings, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les avertissements.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelWarningAcknowledgeEvent

Référence Twitch

Un avertissement a été envoyé à un utilisateur sur la chaîne.

Scope : l’un de moderator:read:warnings, moderator:manage:warnings, accordé par l’utilisateur indiqué dans moderator_user_id.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les avertissements.
moderator_user_id requisstringIdentifiant du diffuseur ou d’un modérateur de la chaîne, celui qui a accordé le scope.

Événement : ChannelWarningSendEvent

Référence Twitch

EventSub a désactivé un shard de conduit parce que l’état de son transport a changé.

Scope : aucun. Demande un jeton d’application dont l’identifiant client est égal à client_id ; avec conduit_id, le conduit doit appartenir à ce client.

Condition

NomTypeDescription
client_id requisstringIdentifiant client de l’application ; ce doit être celui du jeton d’application.
conduit_idstringLimite les notifications à ce conduit ; tous les conduits du client quand il est omis.

Événement : ConduitShardDisabledEvent

Référence Twitch

Des spectateurs ont reçu des droits liés aux Drops. Livré par lots : l’événement est un tableau de droits, et l’abonnement doit être créé avec la livraison par lots activée. Webhooks et conduits uniquement.

Scope : aucun. Demande un jeton d’application d’un client appartenant à un membre de l’organisation.

Condition

NomTypeDescription
organization_id requisstringIdentifiant de l’organisation à qui appartient le jeu dans la console développeur.
category_idstringLimite les notifications à cette catégorie (jeu).
campaign_idstringLimite les notifications à cette campagne de Drops.

Événement : DropEntitlementGrantEvent

Référence Twitch

Une transaction en Bits a eu lieu dans une extension. Webhooks et conduits uniquement.

Scope : aucun. L’identifiant client du jeton doit être celui de l’extension.

Condition

NomTypeDescription
extension_client_id requisstringIdentifiant client de l’extension.

Événement : ExtensionBitsTransactionCreateEvent

Référence Twitch

Le diffuseur a arrêté de diffuser.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les fins de stream.

Événement : StreamOfflineEvent

Référence Twitch

Le diffuseur a lancé un stream.

Scope : aucun.

Condition

NomTypeDescription
broadcaster_user_id requisstringIdentifiant du diffuseur dont on surveille les débuts de stream.

Événement : StreamOnlineEvent

Référence Twitch

Un utilisateur a autorisé l’application. Webhooks et conduits uniquement.

Scope : aucun. Demande un jeton d’application dont l’identifiant client est égal à client_id.

Condition

NomTypeDescription
client_id requisstringIdentifiant client de l’application ; ce doit être celui du jeton d’application.

Événement : UserAuthorizationGrantEvent

Référence Twitch

L’application a perdu l’autorisation d’un utilisateur. Webhooks et conduits uniquement.

Scope : aucun. Demande un jeton d’application dont l’identifiant client est égal à client_id.

Condition

NomTypeDescription
client_id requisstringIdentifiant client de l’application ; ce doit être celui du jeton d’application.

Événement : UserAuthorizationRevokeEvent

Référence Twitch

Un utilisateur a modifié son compte (nom, description, e-mail…).

Scope : aucun. user:read:email, accordé par cet utilisateur, ajoute son adresse e-mail à l’événement.

Condition

NomTypeDescription
user_id requisstringIdentifiant de l’utilisateur à surveiller.

Événement : UserUpdateEvent

Référence Twitch

L’utilisateur a reçu un chuchotement.

Scope : l’un de user:read:whispers, user:manage:whispers, accordé par l’utilisateur indiqué dans user_id.

Condition

NomTypeDescription
user_id requisstringIdentifiant de l’utilisateur qui reçoit les chuchotements.

Événement : UserWhisperMessageEvent

Référence Twitch