Hace un tiempo decidí hacer un concurso para celebrar el hecho que había logrado el gran hito del afiliado en Twitch. La idea el concurso era simple: quienes me siguieran en el canal, podían unirse al concurso a través del comando !sorteo, y donde mientras más horas pase viendo el canal más oportunidades tendría de ganar; luego de todo obtendría una lista que luego sería parte de una gran tómbola. Básicamente un programa de fidelización, un win-win para mi (como streamer) y los viewers.

En el papel sonaba simple: Streamlabs me ayudaría a la gestión, a través de los módulos Giveaway y Loyalty, donde todo se juntaría para obtener la lista de participantes.

El tema que estos módulos no conversan entre sí, o sea si quería hacer que el usuario tenga más tickets a partir del tiempo, no era posible. Debido a esto es que tomé la decisión de hacer un script que tomase toda la información de las APIs y las juntara para obtener la lista.

La parte de obtener la lista de followers fue un tanto truculenta dado que la API de Twitch no se explica muy bien - gracias a Stackoverflow por las pistas. La parte de la API de Streamlab fue la gran piedra: para usar la API de Loyalty debía solicitar un permito de forma manual, el cual no me aseguraba la autorización, ya que no tenía una aplicación publica para demostrar su uso.

Como solución al problema es que usé directamente las API que usa el dashboard web de Streamlabs para acceder la información; a pesar de la falta de documentación es bastante fácil de comprender.

Luego de definitivamente sortear todas las dificultades me puse manos a la obra. El código original es de marzo de 2021, pero la versión que verán tiene un par de modificaciones para hacerlo más configurable a las necesidades.

Antes de todo y se ir al código, se entiende que si estás aquí tendrás por lo menos una cuenta de Twtich y potencialmente una cuenta de Streamlabs. Si no las tienes, empieza creando una cuenta en Twitch y luego ocupala para iniciar sesión en Streamlabs, y enlaza la información de tu canal.

Necesitamos extraer unos valores desde ambos servicios. Para el caso de las credenciales de Twitch:

1. Ve a https://dev.twitch.tv/console e inicia sesión con tus credenciales.
2. En el dashboard, crea una extención has click en Create Extension. No es necesario crear una aplicación.
3. Dale un nombre a tu extensión.
4. La extensión ya está creada. Toma la clave de Twitch API Client ID., es la que usaremos más tarde.

Para el caso de Streamlabs necesitamos usar un par de módulos antes de obtener la clave:

1. Ve a https://streamlabs.com/dashboard e inicia sesión con tus credenciales de Twitch. Si quieres ocupar otra cuenta, asegúrate de tener asociado el canal de Twitch que quieres usar.
2. Asegura que el bot de Streamlabs tiene acceso de moderador. Si no, pone /mod Streamlabs en el chat de tu canal.
3. En la sección Cloudbot, ve al módulo Loyalty. Activa el módulo y has la configuración según tu gusto, asignado puntos por tiempo y acciones.
4. Ve al módulo Giveaways, y crea un nuevo sorteo con el botón Add Giveaway, del tipo Custom. Dale un nombre, dale un timer si quieres que el cierre sea automático; en Advanced puedes definir si quieres que solo los followers puedan unirse. No te preocupes por los puntos, dado que no serán parte del script. Guarda y activa el concurso.

Con todo creado necesitamos obtener las claves de Streamlabs:

1. Usando la consola del navegador (se activa pulsando la tecla F12) vamos a la sección de Red (o network).
2. Ingresamos al módulo Giveaways. Si ya estabas en él, ve a otro módulo y vuelve a entrar.
3. Dentro de las consultas, revisamos aquella que tenga por URL https://streamlabs.com/api/v5/giveaway/active , es del tipo GET.
4. Obtenemos el valor del parámetro token, la usaremos más tarde.
5. En la misma consulta, en la sección Cookies tomamos los valores de las cookies slsid y XSRF-TOKEN, ambas las usaremos más tarde.

Ahora a lo que venimos...

El script lo hice en base a Python 3.8.5, así que no aseguro su funcionamiento en versiones inferiores. En mi caso lo hice funcionar en dicha versión de Python, bajo el kernel de Ubuntu en el WSL 1 (ambiente virtual de Windows 10).

Antes de todo, es necesario instalar un par de dependencias: requests y dotenv. Podemos instalarlas a mano o bien con Pip con el comando pip3 install -r requirements.txt

Por otro lado es necesario definir algunos valores en la variables de entorno dentro del archivo .env dentro de la misma carpeta donde pondremos el código.

• TWITCH_CLIENT_ID: ID de la extensión de Twitch.
• TWITCH_CHANNEL_ID: ID de nuestro canal. Podemos obtener ese valor con el endpoint Get Users, o bien inspeccionar las consultas en el dashboard de nuestro canal y obtener el parámetro número que acompaña a las request hacia https://api.twitch.tv/v5/.
• STREAMLABS_GIVEAWAY_TOKEN: Es token de Streamlabs asociado a nuestro concurso.
• STREAMLABS_COOKIE: La cookie XSRF-TOKEN de Streamlabs.
• STREAMLABS_SLSID: La coockie SLSID de Streamlabs.

Finalmente, el código.

El código básicamente realiza varias request a diversas API y junta la información. Específicamente a la API de Twitch para obtener la lista de followers, y la API de Streamlabs para obtener los usuarios en el concurso y la información del sistema de lealtad. Con todos los datos, comprueba cuales de los usuarios participantes del sorteo son efectivamente seguidores del canal, y sobre esa lista añade los puntos del sistema de fidelidad.

El código contiene algunos parámetros que podemos usar.

• --loyalty: Usar el sistema de lealtad en Streamlabs, para usar los puntos asociados. Si no está presente todos los usuarios quedan con el puntaje por defecto (1).
• --ltime: Para el sistema de letaltad, ocupar el tiempo de visualización como sistema de puntos.
• --lmin: Mínimo de puntos de otorgar.
• --lmax: Máximo de puntos a otorgar.
• --outfolder: Cambiar el nombre de la carpeta de los archivos de salida.

Una vez ejecutado obtendremos varios archivos de salida.

• list_users_error.json: lista de usuarios con errores en el cruce de información.
• list_users_giveaway.txt: lista resultante de usuarios del concurso.
• streamlabs_loyalty.json: respuesta de la API de Streamlabs con la información del módulo de lealtad.
• list_users_giveaway.json: lista de la información desde las API, resultante de usuarios del concurso.
• streamlabs_entries.json: respuesta de la API de Streamlabs con la información del módulo de consursos.
• twitch_followers.json: respuesta de la API de Twitch con la información de los seguidores.

Con todos estos archivos podemos hacer gráficas, o usarlo en servicios de sorteo como AppSorteos o Wheel of names.

La gracia de esto es que podemos adaptarlos para sorteos a largo plazo en función de la fidelidad, o bien usarlo para un sorteo breve para solo quienes se unan en el momento - aunque en dicho caso el módulo Giveaway puede ser suficiente por si solo. 👌