Webhooks de Discord
Publica en Discord cuando pasan cosas en el stream. Añade tantos webhooks como quieras — uno por canal de Discord — y dale a cada uno su mensaje, su imagen y los disparadores de Streamer.Bot que lo publican. Empieza con dos webhooks, que también sirven de ejemplo:
- Go live notification: avisa a tu servidor de que estás en directo.
- Screenshots: publica cada imagen nueva de una carpeta — una captura de pantalla hecha con una recompensa de puntos de canal, un atajo de teclado, tu programa de stream — mira Capturas de pantalla.
No tiene nada visible: nada en pantalla, ni posición, ni estilo, ni vista previa.
Plataformas: Twitch, YouTube, Kick
Paquete de acciones: Stream UI - Backend — publica los mensajes y lee las imágenes. → Quién necesita qué
Cómo funciona
- Cada webhook tiene sus disparadores. Añádelos, edítalos o quítalos como en el resto de Stream UI, con condiciones incluidas → Disparadores y condiciones.
- Una publicación por disparador que salta. En directo en Twitch y YouTube a la vez: el webhook de directo publica dos veces.
- Cada webhook se activa y se desactiva en directo, a mano o con disparadores de Streamer.Bot — mira Controles. Un webhook desactivado no publica nada.
- Las URL de tus webhooks se quedan en Streamer.Bot, nunca en la URL de tu fuente de navegador: cualquiera que tenga una puede publicar en el canal.
- Funciona en el overlay que ejecuta las acciones, mientras el widget está activado — no tiene URL propia. → Qué overlay ejecuta las acciones
Variables
El mensaje, la imagen, el nombre y la foto pueden usar variables entre {}. Los eventos
de Streamer.Bot dicen poco de ti (el Stream Online de Twitch: tu nombre, pero ni foto de
perfil ni enlace al canal), así que Stream UI añade los datos de la cuenta con la que
Streamer.Bot está conectado en la plataforma del disparador (en la primera conectada para
un disparador sin plataforma):
| Variable | Detalle |
|---|---|
{broadcastUser} | Tu nombre visible en esa plataforma |
{broadcastUserName} | Tu login |
{broadcastUserId} | Tu ID en la plataforma |
{broadcastUserProfileImage} | Tu foto de perfil |
{platform} | Twitch, YouTube o Kick |
{link} | Tu canal: https://twitch.tv/<login>, https://kick.com/<login>, o la página /live de tu canal de YouTube |
Las variables del propio disparador también funcionan — por ejemplo {fullPath} y
{fileName} de un File/Folder Watcher. Compruébalas con el botón del inspector de eventos
bajo Añadir disparador: lanza el disparador y lee lo que contiene. Un nombre, una foto o una
imagen cuya variable no se encuentra se queda vacío: se usan el nombre y la foto del
propio webhook.
La página
La página del widget funciona como una pequeña aplicación:
- Ajustes y Controles, las pestañas encima del editor, cambian lo que muestra.
- Lista de webhooks, la columna de la izquierda: tus webhooks. Haz clic en uno para editarlo. Arrastra una fila por su asa para moverla; su interruptor lo activa o lo desactiva; su menú lo duplica o lo borra. Añadir webhook añade uno.
- Lista de disparadores, la columna de al lado: los disparadores del webhook que elegiste (en la pestaña Controles, los del control elegido).
- La zona principal: los ajustes del webhook elegido, o sus botones en la pestaña Controles.
Cada columna se pliega en un riel estrecho con la flecha junto a su título, mientras sigues en la página; se abre desplegada en tu próxima visita.
Puesta en marcha
Activa el widget
Está en el grupo Utilidades y desactivado por defecto. El interruptor Añadir al overlay junto al título de su página lo activa o lo desactiva.
Pon la URL de cada webhook
En Discord: ajustes del canal › Integraciones › Webhooks › Copiar URL de webhook. Pégala en URL del webhook y luego Guardar — se guarda en Streamer.Bot. Enviar una prueba publica un mensaje de prueba en el canal. Añadir webhook añade otro.
Elige sus disparadores
En Lista de disparadores, Añadir disparador elige un disparador de Streamer.Bot; haz clic en un disparador para cambiarlo. El botón del inspector de eventos, debajo, muestra las variables de un disparador. Para el webhook Screenshots, mira Capturas de pantalla.
Actualiza tu fuente de navegador
Vuelve a copiar la URL del overlay que ejecuta las acciones en su fuente de navegador → Disposición y fuente de navegador.
Ajustes
Lista de webhooks
Una fila por webhook: su nombre y, debajo, los nombres de sus disparadores. Borrar un webhook borra su URL y su estado activado / desactivado de Streamer.Bot. Duplicar lo copia debajo del original, URL y estado incluidos: la copia publica enseguida en el mismo canal.
Un webhook nuevo empieza vacío: sin nombre, nombre de autor, foto, mensaje, imagen ni disparador.
Ajustes del webhook
El webhook elegido, en la zona principal:
| Campo | Por defecto en el webhook de directo | Por defecto en Screenshots | Detalle |
|---|---|---|---|
| Nombre del webhook | Go live notification | Screenshots | Solo sirve para distinguir tus webhooks en la página. Vacío: Webhook 1, Webhook 2… |
| URL del webhook | — | — | El enlace del webhook de Discord, guardado en Streamer.Bot. Guardar y luego Enviar una prueba. |
| Nombre de usuario por defecto | {broadcastUser} | Stream UI | El nombre de la publicación. Las variables funcionan. Vacío: el nombre del propio webhook. |
| URL de la imagen por defecto | {broadcastUserProfileImage} | vacío | Un enlace, o una variable. Vacío: la foto del propio webhook, fijada en Discord. |
| Publicar en nombre del espectador | desactivado | desactivado | Publica con el nombre y la foto de perfil de quien lanzó el disparador — mira Publicar en nombre del espectador. |
| Mensaje | {broadcastUser} is live on {platform}! {link} | vacío | Mira Variables. Vacío: la imagen sola. |
| Imagen | Enlace, vacío | Variable, {fullPath} | De dónde viene la imagen, y luego su campo. Variable: una variable del disparador que contiene la ruta de una imagen en el PC de Streamer.Bot o su enlace. Archivo local: una imagen en el PC de Streamer.Bot, escrita o elegida con Examinar…, adjunta a la publicación. Enlace: el enlace de una imagen, mostrada bajo el mensaje. Vacío: sin imagen. |
Una imagen del PC se publica cuando está escrita del todo: .png, .jpg, .jpeg, .gif
o .webp, hasta 10 MB (el límite de Discord para los webhooks). Los demás archivos no se
publican.
Lista de disparadores
Los disparadores del webhook elegido — los del webhook de directo: Stream Online de Twitch, Broadcast Started de YouTube, Stream Online de Kick; el de Screenshots: Created del File/Folder Watcher. Cada fila: el icono de su plataforma, el nombre del disparador y su condición. Haz clic en uno para cambiarlo; arrastra para reordenar; Duplicar (para darle otra condición a la copia) y Eliminar están en su menú.
Capturas de pantalla
El webhook Screenshots publica cada imagen nueva de una carpeta, subcarpetas incluidas.
Vigila la carpeta en Streamer.Bot
En Streamer.Bot, abre Services › File/Folder Watcher, haz clic derecho en la lista y luego en Añadir. Elige la carpeta donde se crean tus imágenes, haz clic en OK para guardar y comprueba que el watcher está activado. No hace falta ninguna acción.
Escribe tu carpeta en el disparador
En la Lista de disparadores del webhook Screenshots, haz clic en el disparador File/Folder
Watcher › Created. Su condición dice fullPath Empieza por YOUR FOLDER PATH:
cambia YOUR FOLDER PATH por la carpeta del watcher, por ejemplo
C:\Users\Tú\Pictures\Screenshots. Las mayúsculas y minúsculas dan igual.
Otra carpeta: duplica el disparador y escribe la otra carpeta. Otro canal: duplica el webhook y pega la URL del otro canal.
Publicar en nombre del espectador
Con Publicar en nombre del espectador activado, el webhook publica con el nombre y la foto de perfil de quien lanzó el disparador: quien escribe en el chat, el suscriptor, el donante de una integración (el nombre fijado en Ajustes › Streamer.Bot)… Si no se encuentra a nadie, publica con el Nombre de usuario por defecto y la URL de la imagen por defecto del webhook.
Algunos disparadores no nombran a nadie — un archivo nuevo en una carpeta, por ejemplo. La página muestra entonces un aviso bajo el interruptor. Para esos, tu acción de Streamer.Bot puede guardar al espectador en variables globales temporales antes de lanzar el disparador — antes de la subacción que crea la imagen, para una captura de pantalla.
En tu acción, añade dos subacciones Core › Globals › Global (Set) con la siguiente información:
| Campo | User name global | User platform global |
|---|---|---|
| Destination | Global | Global |
| Persisted | Non-Persisted | Non-Persisted |
| Variable Name | streamUi.discordViewer | streamUi.discordViewerPlatform |
| Valor | %user% | %eventSource% * |
* El nombre de la variable puede cambiar según el disparador que uses: comprueba los nombres de las variables del evento para saber cuál contiene la plataforma.
La foto de perfil del espectador guardado es la que el Primero del chat o las tarjetas de espectadores guardaron para él, si no, en Twitch, la que encuentra Stream UI - Get Profile Pic. Cada espectador guardado sirve para una sola publicación, y solo en los 60 segundos siguientes. Una publicación más de 60 segundos después, o sin espectador guardado — una captura hecha con un atajo de teclado, por ejemplo — usa el Nombre de usuario por defecto y la URL de la imagen por defecto del webhook.
El aviso bajo Publicar en nombre del espectador, en la página, enlaza aquí.
Controles
Cada webhook está activado o desactivado, y solo publican los webhooks activados. Su interruptor en Lista de webhooks lo muestra y lo cambia. En la pestaña Controles:
- Controles, una columna junto a la lista de webhooks, tiene Activar y Desactivar. Elige uno para ver sus disparadores en Lista de disparadores.
- Lista de disparadores: los disparadores de Streamer.Bot que activan, o desactivan, el webhook elegido — el inicio del stream, el final del stream, un comando… Añadir disparador añade uno, con condiciones incluidas. Un disparador que activa un webhook también le deja publicar con ese mismo disparador.
- La zona principal muestra la tarjeta del webhook elegido, que dice
Go live notification: On, con los botones Activar y Desactivar. La ventana de controles tiene una tarjeta por webhook.
El estado se guarda en Streamer.Bot, en la variable global persistente
streamUi.off.discordwebhooks.<id del webhook> (1: desactivado; 0 o ninguna: activado),
así que el interruptor, los botones, los disparadores y todas las páginas se siguen al
instante. Tus propias acciones también pueden activar o desactivar un webhook, con una
subacción Global (Set) sobre esa variable. El interruptor y los botones necesitan
Streamer.Bot conectado y la acción Backend.
Eventos de Streamer.Bot que escucha
| Evento | Qué provoca |
|---|---|
Cada disparador de cada webhook (el webhook de directo: Twitch.StreamOnline, YouTube.BroadcastStarted, Kick.StreamOnline; Screenshots: FileWatcher.Created) | La publicación de ese webhook |
General.Custom | La foto de perfil de Twitch que encuentra Stream UI - Get Profile Pic. Solo con Publicar en nombre del espectador |
| Cada disparador Activar / Desactivar de cada webhook | Activa o desactiva ese webhook |
Misc.GlobalVariableUpdated, Misc.GlobalVariableCreated | Un webhook activado o desactivado en otro sitio (la página, la ventana de controles, tus acciones) |
Créditos finales
Créditos a pantalla completa para Twitch, YouTube y Kick — seguidores, subs, regalos, raids, moderadores y chatters, sacados de los créditos de Streamer.Bot en Twitch y de grupos de Streamer.Bot en YouTube y Kick.
Apariencia
El estilo de overlay que siguen todos los widgets — tarjetas, textos, imágenes, barras de progreso y animación — y cómo lo sustituye la pestaña Estilo de un widget.