Twitch renueva su API: mensajes fijados para bots y eventos de stream más fiables

Mientras la comunidad discutía sobre la supuesta subida de duración de los anuncios, Twitch ha ido soltando en silencio una tanda de cambios en su API para desarrolladores que afectan directamente a la maquinaria que sostiene los directos: los bots de chat, los overlays y los paneles de estadísticas. Ninguno sale en portada, pero cualquiera que dependa de un bot los va a notar.

Mensajes fijados: el chat ya no depende del ratón

Desde el 15 de mayo, la API Helix permite gestionar los mensajes fijados por moderación con cuatro endpoints en beta abierta: fijar un mensaje, consultar el que está activo, cambiar su duración y desfijarlo. Solo puede haber un mensaje fijado por mods a la vez en cada canal; si se fija otro, sustituye al anterior. Además, el endpoint de envío de mensajes acepta ahora un parámetro pin, de modo que un bot puede publicar un aviso y dejarlo fijado en una sola petición.

Para los streamers esto significa que sus bots podrán, por fin, fijar automáticamente las reglas de un sorteo, el enlace del día o el aviso importante de turno, sin que nadie tenga que ir a la web a hacerlo a mano.

stream.offline con identificador: adiós a los cierres fantasma

El cambio más discreto es probablemente el más útil. Desde el 26 de junio, el evento stream.offline de EventSub incluye un campo id en su payload, igual que ya hacía stream.online.

¿Por qué importa? Los bots y paneles de estadísticas abren una “sesión” cuando empieza el directo y la cierran cuando termina: de ahí salen los resúmenes post-stream, los picos de espectadores o el watchtime. Pero cuando un directo se cae y vuelve en cuestión de segundos —un reinicio de OBS, un bajón de conexión—, el aviso de cierre del stream viejo puede llegar tarde y cerrar por error la sesión del stream nuevo. Con un identificador en ambos eventos, el software puede comprobar si ese “final de directo” corresponde de verdad al directo en curso o es un eco del anterior.

Hitos nuevos en el chat y metas nuevas para creadores

El resto de la tanda de junio se centra en dar visibilidad a la fidelidad de la audiencia:

• Watch Streaks: el chat notifica cuando un espectador alcanza una racha de visionado (tipo viewermilestone en IRC).
• Modiversary: aviso automático cuando un moderador cumple años en el cargo, también en canales con chat compartido.
• Creator Goals: los paneles pueden mostrar metas de primer bit (new_bit) y primer cheerer (new_cheerer), pensadas para canales pequeños que aún celebran cada primera vez.

Como nota de archivo: Twitch también ha retirado de su documentación la guía de migración de PubSub, el sistema de eventos antiguo. La transición a EventSub queda oficialmente enterrada.

Lectura Digital Bite

Esta es la clase de actualización que no genera clips virales pero decide si tu bot funciona bien o “más o menos”. El identificador en stream.offline ataca un problema real que cualquier desarrollador de herramientas de streaming ha sufrido —nosotros incluidos: Leksimus, nuestro bot, ya está adaptado para usarlo en la correlación de sesiones—. Y los mensajes fijados por API abren la puerta a automatizaciones que llevaban años pidiéndose.

La asignatura pendiente sigue siendo la coherencia: de poco sirve poder fijar mensajes por API si ningún cliente de terceros puede enterarse de que existe un mensaje fijado. Si Twitch quiere que su ecosistema de desarrolladores trate los pins como algo más que un adorno del chat oficial, el siguiente paso obvio es un evento de EventSub para ellos.

Fuentes: Changelog de Twitch Developers, Referencia de la API Helix, Tipos de suscripción EventSub