Configuración de Twitch y EventSub

Usa captura normal de página para chat sencillo o el modo EventSub/WebSocket para seguimientos, suscripciones, Bits, recompensas, raids, trenes del Hype y controles del canal.

Elegir un modo de fuente de Twitch

ModoIdeal paraDiferencia 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

  1. Selecciona Añadir fuente → Twitch.
  2. Introduce el nombre de usuario del canal de Twitch que aparece en su URL. Para twitch.tv/examplechannel, introduce examplechannel.
  3. Deja WebSocket seleccionado para la fuente EventSub más completa. Twitch usa actualmente este modo por defecto en la aplicación.
  4. Selecciona Activar fuente (Activate source), luego Iniciar sesión en Twitch.
  5. Autoriza los permisos solicitados y mantén abierta la ventana de origen de Twitch.
Pantalla de inicio de sesión de la fuente de Twitch con métodos Navegador externo y Aplicación local
La fuente de escritorio ofrece un flujo OAuth en navegador externo y otro dentro de la aplicación. El navegador externo suele ser lo más sencillo cuando Twitch ya funciona en tu navegador habitual.

Configuración de EventSub en la extensión del navegador

  1. Instala y activa la versión actual de la extensión Social Stream Ninja.
  2. Abre: página de origen de Twitch EventSub.
  3. Sustituye examplechannel en la URL por el nombre de usuario del canal que quieras supervisar.
  4. Selecciona Iniciar sesión en Twitch y aprueba el acceso solicitado.
  5. 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 permisosSe usa para
ChatLeer chat, enviar chat y listar participantes.
Seguidores y suscriptoresEventos de seguidores, suscriptores, suscripciones regaladas y mensajes de renovación.
Bits, recompensas y trenes del HypeCheers, canjes de recompensas personalizadas de Puntos del canal y estado del tren del Hype.
ModeraciónEliminación de mensajes, bloqueos/silenciamientos y sincronización de bloqueos cuando la cuenta puede moderar el canal.
Gestión del canalLeer 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, y subscription_gift.
  • Bits: cheer con un valor de donación.
  • Puntos del canal: reward.
  • Raids: raid.
  • Estado de transmisión y anuncios: stream_online, stream_offline, y ad_break.
  • Tren del Hype: hype_train actualizaciones 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

  1. Confirma que la página de origen muestre los valores correctos de Usuario y Canal (Channel).
  2. Mantén abierta la página o ventana de origen y confirma que la conexión de chat esté activa.
  3. Si el chat funciona pero los seguimientos, suscripciones o recompensas no, cierra la sesión y vuelve a autorizar para conceder los permisos actuales.
  4. Verifica que la cuenta conectada sea el emisor o un moderador autorizado de ese canal.
  5. Comprueba que el Dock y la superposición de alertas usen el mismo ID de sesión de Social Stream.
  6. 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.