Webhooks Discord
Poste sur Discord quand il se passe quelque chose en stream. Ajoutez autant de webhooks que vous voulez — un par salon Discord — et donnez à chacun son message, son image et les déclencheurs Streamer.Bot qui le postent. Il démarre avec deux webhooks, qui servent aussi d'exemples :
- Go live notification : prévient votre serveur que vous êtes en live.
- Screenshots : poste chaque nouvelle image d'un dossier — une capture d'écran prise par une récompense de points de chaîne, un raccourci clavier, votre logiciel de stream — voir Captures d'écran.
Il n'a rien de visible : rien à l'écran, pas de position, pas de style, pas d'aperçu.
Plateformes : Twitch, YouTube, Kick
Pack d'actions : Stream UI - Backend — il poste les messages et lit les images. → Qui a besoin de quoi
Fonctionnement
- Chaque webhook a ses déclencheurs. Ajoutez, modifiez ou retirez-les comme partout dans Stream UI, conditions comprises → Déclencheurs et conditions.
- Un message par déclencheur qui se déclenche. En live sur Twitch et YouTube à la fois : le webhook de live poste deux fois.
- Chaque webhook s'active et se désactive en direct, à la main ou par des déclencheurs Streamer.Bot — voir Contrôles. Un webhook désactivé ne poste rien.
- Les URL de vos webhooks restent dans Streamer.Bot, jamais dans l'URL de votre source navigateur : quiconque en a une peut poster dans le salon.
- Tourne dans l'overlay qui lance les actions, tant que le widget est activé — il n'a pas d'URL à lui. → Quel overlay lance les actions
Variables
Le message, l'image, le nom et la photo peuvent tous utiliser des variables entre {}.
Les événements de Streamer.Bot disent peu de choses sur vous (le Stream Online de Twitch :
l'id, le type et le started_at du stream). Stream UI ajoute donc les informations du
compte avec lequel Streamer.Bot est connecté sur la plateforme du déclencheur (sur la
première connectée pour un déclencheur sans plateforme) :
| Variable | Détail |
|---|---|
{broadcastUser} | Votre pseudo affiché sur cette plateforme |
{broadcastUserName} | Votre login |
{broadcastUserId} | Votre identifiant sur la plateforme |
{broadcastUserProfileImage} | Votre photo de profil |
{platform} | Twitch, YouTube ou Kick |
{link} | Votre chaîne : https://twitch.tv/<login>, https://kick.com/<login>, ou la page /live de votre chaîne YouTube |
Les variables du déclencheur lui-même fonctionnent aussi — par exemple {fullPath} et
{fileName} d'un File/Folder Watcher. Vérifiez-les avec le bouton de l'inspecteur
d'événements sous Ajouter un déclencheur : lancez le déclencheur et lisez ce qu'il contient. Un
nom, une photo ou une image dont la variable est introuvable reste vide : le nom et la
photo du webhook lui-même s'appliquent.
La page
La page du widget fonctionne comme une petite application :
- Réglages et Commandes, les onglets au-dessus de l'éditeur, changent ce qu'il affiche.
- Liste des webhooks, la colonne de gauche : vos webhooks. Cliquez sur l'un d'eux pour le modifier. Faites glisser une ligne par sa poignée pour la déplacer ; son interrupteur l'active ou le désactive ; son menu le duplique ou le supprime. Ajouter un webhook en ajoute un.
- Liste des déclencheurs, la colonne à côté : les déclencheurs du webhook choisi (dans l'onglet Commandes, ceux du contrôle choisi).
- La zone principale : les réglages du webhook choisi, ou ses boutons dans l'onglet Commandes.
Chaque colonne se replie en un mince rail avec la flèche à côté de son titre, tant que vous restez sur la page ; elle s'ouvre dépliée à votre prochaine visite.
Mise en place
Activez le widget
Il est dans le groupe Utilitaires et désactivé par défaut. L'interrupteur Ajouter à l’overlay à côté du titre de sa page l'active ou le désactive.
Réglez l'URL de chaque webhook
Dans Discord : paramètres du salon › Intégrations › Webhooks › Copier l'URL du webhook. Collez-la dans URL du webhook, puis Enregistrer — elle est enregistrée dans Streamer.Bot. Envoyer un test poste un message de test dans le salon. Ajouter un webhook en ajoute un autre.
Choisissez ses déclencheurs
Dans Liste des déclencheurs, Ajouter un déclencheur choisit un déclencheur dans Streamer.Bot ; cliquez sur un déclencheur pour le modifier. Le bouton de l'inspecteur d'événements, dessous, montre les variables d'un déclencheur. Pour le webhook Screenshots, voir Captures d'écran.
Mettez à jour votre source navigateur
Recopiez l'URL de l'overlay qui lance les actions dans sa source navigateur → Disposition et source navigateur.
Réglages
Liste des webhooks
Une ligne par webhook : son nom, et dessous les noms de ses déclencheurs. Supprimer un webhook supprime son URL et son état activé / désactivé de Streamer.Bot. Dupliquer le copie sous l'original, URL et état compris : la copie poste aussitôt dans le même salon.
Un nouveau webhook démarre vide : ni nom, ni nom d'auteur, ni photo, ni message, ni image, ni déclencheur.
Réglages du webhook
Le webhook choisi, dans la zone principale :
| Champ | Défaut du webhook de live | Défaut de Screenshots | Détail |
|---|---|---|---|
| Nom du webhook | Go live notification | Screenshots | Sert seulement à distinguer vos webhooks sur la page. Vide : Webhook 1, Webhook 2… |
| URL du webhook | — | — | Le lien du webhook Discord, gardé dans Streamer.Bot. Enregistrer, puis Envoyer un test. |
| Pseudo par défaut | {broadcastUser} | Stream UI | Le nom du message. Les variables fonctionnent. Vide : le nom du webhook lui-même. |
| URL de l’image par défaut | {broadcastUserProfileImage} | vide | Un lien, ou une variable. Vide : la photo du webhook lui-même, réglée dans Discord. |
| Poster au nom du viewer | désactivé | désactivé | Poste avec le nom et la photo de profil de la personne qui a lancé le déclencheur — voir Poster au nom du viewer. |
| Message | {broadcastUser} is live on {platform}! {link} | vide | Voir Variables. Vide : l'image seule. |
| Image | Lien, vide | Variable, {fullPath} | D'où vient l'image, puis son champ. Variable : une variable du déclencheur qui contient le chemin d'une image sur le PC de Streamer.Bot ou son lien. Fichier local : une image sur le PC de Streamer.Bot, tapée ou choisie avec Parcourir…, jointe au message. Lien : le lien d'une image, affichée sous le message. Vide : pas d'image. |
Une image du PC est postée une fois entièrement écrite : .png, .jpg, .jpeg, .gif ou
.webp, jusqu'à 10 Mo (la limite de Discord pour les webhooks). Les autres fichiers ne
sont pas postés.
Liste des déclencheurs
Les déclencheurs du webhook choisi — ceux du webhook de live : Stream Online de Twitch, Broadcast Started de YouTube, Stream Online de Kick ; celui de Screenshots : Created du File/Folder Watcher. Chaque ligne : l'icône de sa plateforme, le nom du déclencheur et sa condition. Cliquez sur l'un d'eux pour le modifier ; faites glisser pour réordonner ; Dupliquer (pour donner une autre condition à la copie) et Supprimer sont dans son menu.
Captures d'écran
Le webhook Screenshots poste chaque nouvelle image d'un dossier, sous-dossiers compris.
Surveillez le dossier dans Streamer.Bot
Dans Streamer.Bot, ouvrez Services › File/Folder Watcher, faites un clic droit dans la liste, puis cliquez sur Ajouter. Choisissez le dossier où vos images sont créées, cliquez sur OK pour enregistrer, et vérifiez que le watcher est activé. Aucune action n'est nécessaire.
Tapez votre dossier dans le déclencheur
Dans la Liste des déclencheurs du webhook Screenshots, cliquez sur le déclencheur File/Folder
Watcher › Created. Sa condition indique fullPath Commence par YOUR FOLDER PATH :
remplacez YOUR FOLDER PATH par le dossier du watcher, par exemple
C:\Users\Vous\Pictures\Screenshots. Majuscules et minuscules n'ont pas d'importance.
Un autre dossier : dupliquez le déclencheur et tapez l'autre dossier. Un autre salon : dupliquez le webhook et collez l'URL de l'autre salon.
Poster au nom du viewer
Avec Poster au nom du viewer activé, le webhook poste avec le nom et la photo de profil de la personne qui a lancé le déclencheur : la personne qui écrit dans le chat, l'abonné, le donateur d'une intégration (le nom réglé dans Réglages › Streamer.Bot)… Si personne n'est trouvé, il poste avec le Pseudo par défaut et la URL de l’image par défaut du webhook.
Certains déclencheurs ne nomment personne — un nouveau fichier dans un dossier, par exemple. La page affiche alors un avertissement sous l'interrupteur. Pour ceux-là, votre action Streamer.Bot peut enregistrer le spectateur dans des variables globales temporaires avant de lancer le déclencheur — avant la sous-action qui crée l'image, pour une capture d'écran.
Dans votre action, ajoutez deux sous-actions Core › Globals › Global (Set) avec les informations suivantes :
| Champ | User name global | User platform global |
|---|---|---|
| Destination | Global | Global |
| Persisted | Non-Persisted | Non-Persisted |
| Variable Name | streamUi.discordViewer | streamUi.discordViewerPlatform |
| Valeur | %user% | %eventSource% * |
* Le nom de la variable peut changer selon le déclencheur utilisé : vérifiez les noms des variables de l'événement pour savoir laquelle contient la plateforme.
La photo de profil du spectateur enregistré est celle que le Premier du chat ou les cartes de viewers ont enregistrée pour lui, sinon, sur Twitch, celle que trouve Stream UI - Get Profile Pic. Chaque spectateur enregistré ne sert que pour un message, et seulement dans les 60 secondes. Un message posté plus de 60 secondes après, ou sans spectateur enregistré — une capture faite au raccourci clavier, par exemple — utilise le Pseudo par défaut et la URL de l’image par défaut du webhook.
L'avertissement sous Poster au nom du viewer, sur la page, renvoie ici.
Contrôles
Chaque webhook est activé ou désactivé, et seuls les webhooks activés postent. Son interrupteur dans Liste des webhooks l'affiche et le change. Dans l'onglet Commandes :
- Commandes, une colonne à côté de la liste des webhooks, contient Activer et Désactiver. Choisissez-en un pour voir ses déclencheurs dans Liste des déclencheurs.
- Liste des déclencheurs : les déclencheurs Streamer.Bot qui activent, ou désactivent, le webhook choisi — début du stream, fin du stream, une commande… Ajouter un déclencheur en ajoute un, conditions comprises. Un déclencheur qui active un webhook le laisse aussi poster sur ce même déclencheur.
- La zone principale affiche la tuile du webhook choisi, qui indique
Go live notification: On, avec les boutons Activer et Désactiver. La fenêtre de contrôles a une tuile par webhook.
L'état est gardé dans Streamer.Bot, dans la variable globale persistante
streamUi.off.discordwebhooks.<id du webhook> (1 : désactivé ; 0 ou absente : activé) :
l'interrupteur, les boutons, les déclencheurs et toutes les pages se suivent aussitôt. Vos
propres actions peuvent aussi activer ou désactiver un webhook, avec une sous-action
Global (Set) sur cette variable. L'interrupteur et les boutons demandent Streamer.Bot
connecté et l'action Backend.
Événements Streamer.Bot écoutés
| Événement | Ce qu'il déclenche |
|---|---|
Chaque déclencheur de chaque webhook (le webhook de live : Twitch.StreamOnline, YouTube.BroadcastStarted, Kick.StreamOnline ; Screenshots : FileWatcher.Created) | Le message de ce webhook |
General.Custom | La photo de profil Twitch trouvée par Stream UI - Get Profile Pic. Seulement avec Poster au nom du viewer |
| Chaque déclencheur Activer / Désactiver de chaque webhook | Active ou désactive ce webhook |
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreated | Un webhook activé ou désactivé ailleurs (la page, la fenêtre de contrôles, vos actions) |
Générique de fin
Générique défilant plein écran pour Twitch, YouTube et Kick — followers, subs, cadeaux, raids, modérateurs et chatteurs, tirés des crédits de Streamer.Bot sur Twitch et de groupes Streamer.Bot sur YouTube et Kick.
Apparence
Le style d'overlay que suivent tous les widgets — cartes, textes, images, barres de progression et animation — et comment l'onglet Style d'un widget le remplace.