Elegir un modo de fuente de Twitch
| Modo | Ideal para | Diferencia importante |
|---|---|---|
| Standard | Captura básica de chat público desde una página de chat de Twitch o su ventana emergente. | Lee lo que expone la página. Es sencillo, pero no proporciona todos los eventos de EventSub. |
| WebSocket / EventSub | Seguimientos, suscripciones, Bits, recompensas, raids, estado de la transmisión, trenes del Hype, sincronización de moderación, envío de chat y detalles del canal. | Requiere OAuth de Twitch. Los eventos solo se habilitan cuando lo permiten la cuenta conectada, el rol en el canal, los requisitos del canal y los permisos concedidos. |
Configuración de la aplicación de escritorio
- Selecciona Añadir fuente → Twitch.
- Introduce el nombre de usuario del canal de Twitch que aparece en su URL. Para
twitch.tv/examplechannel, introduceexamplechannel. - Deja WebSocket seleccionado para la fuente EventSub más completa. Twitch usa actualmente este modo por defecto en la aplicación.
- Selecciona Activar fuente (Activate source), luego Iniciar sesión en Twitch.
- Autoriza los permisos solicitados y mantén abierta la ventana de origen de Twitch.
Configuración de EventSub en la extensión del navegador
- Instala y activa la versión actual de la extensión Social Stream Ninja.
- Abre: página de origen de Twitch EventSub.
- Sustituye
examplechannelen la URL por el nombre de usuario del canal que quieras supervisar. - Selecciona Iniciar sesión en Twitch y aprueba el acceso solicitado.
- Mantén esa página abierta. Confirma que sus campos Usuario y Canal sean correctos antes de probar las alertas.
https://socialstream.ninja/sources/websocket/twitch.html?channel=CHANNEL_LOGIN
Para usar captura Standard básica, abre la página normal de chat de Twitch o su ventana emergente y mantén visible el chat.
Qué solicita Twitch
Social Stream solicita un token de usuario con los permisos necesarios para los controles y suscripciones compatibles. Conceder un permiso no convierte una cuenta en emisor o moderador; Twitch sigue comprobando su rol en el canal seleccionado.
| Grupo de permisos | Se usa para |
|---|---|
| Chat | Leer chat, enviar chat y listar participantes. |
| Seguidores y suscriptores | Eventos de seguidores, suscriptores, suscripciones regaladas y mensajes de renovación. |
| Bits, recompensas y trenes del Hype | Cheers, canjes de recompensas personalizadas de Puntos del canal y estado del tren del Hype. |
| Moderación | Eliminación de mensajes, bloqueos/silenciamientos y sincronización de bloqueos cuando la cuenta puede moderar el canal. |
| Gestión del canal | Leer o actualizar el título y la categoría, leer o gestionar anuncios y mostrar métricas del canal. |
Consulta la documentación oficial de Twitch: referencia de permisos y tipos de suscripción de EventSub.
Eventos que procesa la fuente actual
- Seguimientos:
new_follower. - Suscripciones:
new_subscriber,resub, ysubscription_gift. - Bits:
cheercon un valor de donación. - Puntos del canal:
reward. - Raids:
raid. - Estado de transmisión y anuncios:
stream_online,stream_offline, yad_break. - Tren del Hype:
hype_trainactualizaciones de inicio, progreso y finalización. - Moderación: actualizaciones de bloqueos y eliminación de mensajes cuando esté permitido.
Los eventos de suscriptores de Twitch requieren un canal Afiliado/Socio apto y acceso del emisor. Las suscripciones de seguimiento y moderación requieren que el usuario conectado sea el emisor o un moderador autorizado, según el evento.
Para los nombres de alertas posteriores y los campos de datos, usa la guía de compatibilidad de eventos y alertas y Referencia de eventos.
Primeras comprobaciones cuando falta un evento
- Confirma que la página de origen muestre los valores correctos de Usuario y Canal (Channel).
- Mantén abierta la página o ventana de origen y confirma que la conexión de chat esté activa.
- Si el chat funciona pero los seguimientos, suscripciones o recompensas no, cierra la sesión y vuelve a autorizar para conceder los permisos actuales.
- Verifica que la cuenta conectada sea el emisor o un moderador autorizado de ese canal.
- Comprueba que el Dock y la superposición de alertas usen el mismo ID de sesión de Social Stream.
- Usa el mensaje de prueba ficticio del menú emergente o la vista previa de Multi Alerts para distinguir problemas de captura de problemas de superposición.
EventSub puede entregar un aviso más de una vez. Twitch documenta la entrega al menos una vez. Social Stream incluye protección contra duplicados, pero los consumidores personalizados de API deben deduplicar por identidad de evento/mensaje cuando sea posible. Consulta la documentación oficial descripción general de EventSub.