Node-RED_Twitch_EventSub/README.md

Node-RED_Twitch_EventSub

Node-RED flow to subscribe, receive and respond to Twitch webhook

Note

• My Twitch channel
• It is HIGHLY recommended to secure your Node-RED flow (your server will be exposed to the internet) !!
• EventSub doc
• This Flow is compatible with the "regular" Twitch API and the following flow

Prerequisites

• Node-RED running on port 443 with HTTPS enabled OR a Ngrock auth token

• Twitch APP Client ID

• Twitch APP Client Secret

Dependencies

• node-red-dashboard
• node-red-contrib-crypto-js-dynamic
• Optional : node-red-contrib-ngrok

For Ngrock users

• Create a free account on ngrock
• Save your AuthToken
• Instal the ngrock node on Node-RED
• Drag and drop a ngrock node on your flow
• Setup the node using your AuthToken
• Open a tunnel and save the URL

Twitch Setup

• Create an APP and save your APP ID and Secret
• Add the following URL using your domain name or ngrock tunnel URL

Node-RED Setup

• Import the flow
• Edit the API Settings node with your
  • Twitch client ID
  • Twitch client secret
  • Sub secret : a password (defined by the user) to validate the Twitch event signature
  • Twitch channel
  • Sub URI : your Node-RED server name or ngrock tunnel URL (Ex : https://your.domain.name or https://xxxxxxxxxxx.ngrock.io)
  • Scopes (space-separated)
• Go to the Node-RED dashboard (https://your.domain.name/ui or https://xxxxxxxxxx.ngrock.io/ui)
• Generate an APP token and USER token by clicking on Auhtorize APP and Authorize USER (will requires to loggin with your Twitch account and accept the scopes)
• Optinal : you can test the validity and expiration of the Token using "Validate" nodes on the Node-RED editor

Subscribe

• Subscribe to an event by selecting the desired Event on the Node-RED GUI
• Clic on "Subscribe"

Unsubscribe

• Refresh the subscriptions
• Select the event you want to unsubscribe
• Clicl on "Unsubscribe"

Events

• When an event is posted to /webhook the JSON will be validated using the "Sub secret" code and sent to the second flow "Reponse"

• The "Inject" node and "Fake event" function can be removes as they are only used for Testing/Debug purposes

• Retrieve and use the events informations by connectig your node/function to the annotated functions

HAVE FUN