Triggers

Edit

General #

Once your status changes to Listening, LioranBoard will automatically start listening to all the following events. (No events are delivered if the stream is offline and status is Ready.)
The events are polled every X seconds. The frequency depends on how many current viewers your stream has. 10 seconds for less than 3 viewers, 5 seconds for less than 10 viewers and 2 seconds (or whatever YouTube API dictates) for 10+ viewers.

Sending test events You can test all available events via Transmitter in your YouTube Live tab. The test buttons will mimic real events that YouTube API sends. There are some options you can fill out as well.

Replaying events You can enable Event Replays via Transmitter in your YouTube Live tab. All new recent events (max 15) will be logged and available from the dropdown menu to either replay them or view the raw payload YouTube sends.

Event Name Description Extension Trigger
New Subscriber Triggers for all new subscribers (same as followers on Twitch) to your channel. YT Live Subscriber
New Member Triggers whenever you get a new member (same as subscribers on Twitch). YT Live Member
New Milestone Triggers whenever your member reaches a new milestone. YT Live Member Milestone
New Super Chat Triggers for all new super chat events. YT Live Super Chat
New Super Sticker Triggers for all new super sticker events. YT Live Super Sticker
New Chat Message Triggers for all chat messages. You can also use wild cards to filter messages. Regular Twitch Chat Message trigger
Live Chat Ended Triggers a few minutes after your broadcast goes offline. YT Live Chat Ended


Edit

New Subscriber #

Extension Trigger: YT Live Subscriber
Triggers for all new subscribers to your channel.
This particular endpoint is different from all other endpoints. It’s polled once every minute.
Retrieve the following values by using Math: Trigger Pull command and selecting the specified Extension Trigger pull value from the dropdown menu.

Math Trigger Pull Value Description
Value 1 Subscriber’s channel title. Chat display name not provided.
Value 2 Subscriber’s channel ID
Value 3 Subscriber’s profile (channel) image URL


Edit

New Member #

Extension Trigger: YT Live Member
Triggers for all new members (formerly sponsors) to your channel.
Retrieve the following values by using Math: Trigger Pull command and selecting the specified Extension Trigger pull value from the dropdown menu.

Math Trigger Pull Value Description
Value 1 Member’s chat display name
Value 2 The name of the level at which the viewer is a member
Value 3 Member’s channel ID.
Value 4 Member’s channel URL.
Value 5 Member’s profile image URL.


Edit

New Milestone #

Extension Trigger: YT Live Member Milestone
Triggers whenever your member reaches a new milestone.
Retrieve the following values by using Math: Trigger Pull command and selecting the specified Extension Trigger pull value from the dropdown menu.

Math Trigger Pull Value Description
Value 1 Member’s chat display name.
Value 2 The name of the level at which the viewer is a member.
Value 3 Total amount of months the viewer has been a member.
Value 4 The comment added by the member to this milestone event.
Value 5 Member’s channel ID.
Value 6 Member’s channel URL.
Value 7 Member’s profile image URL.


Edit

New Super Chat #

Extension Trigger: YT Live Super Chat
Triggers for all new super chat events.
Retrieve the following values by using Math: Trigger Pull command and selecting the specified Extension Trigger pull value from the dropdown menu.

Math Trigger Pull Value Description
Value 1 Viewer’s chat display name.
Value 2 The purchase amount, in micros of the purchase currency. 1 dollar = 1000000 micros.
Value 3 A string, like $1.00, that contains the purchase amount and currency.
Value 4 The tier for the paid message (based on the amount of money spent to purchase the message).
Value 5 The comment added by the viewer to this super chat event.
Value 6 Viewer’s channel ID.
Value 7 Viewer’s channel URL.
Value 8 Viewer’s profile image URL.


Edit

New Super Sticker #

Extension Trigger: YT Live Super Sticker
Triggers for all new super sticker events.
Retrieve the following values by using Math: Trigger Pull command and selecting the specified Extension Trigger pull value from the dropdown menu.

Math Trigger Pull Value Description
Value 1 Viewer’s chat display name.
Value 2 The purchase amount, in micros of the purchase currency. 1 dollar = 1000000 micros.
Value 3 A string, like $1.00, that contains the purchase amount and currency.
Value 4 The tier for the paid message (based on the amount of money spent to purchase the message).
Value 5 Viewer’s channel ID.
Value 6 Viewer’s channel URL.
Value 7 Viewer’s profile image URL.
Value 8 A unique ID that identifies the sticker image. (sticker image URL not available).
Value 9 A text string that describes the sticker.


Edit

New Chat Message #

This trigger is a bit different. It is a modified version of the original Twitch chat message trigger.
The trigger names come from Twitch and might not exactly match the YouTube triggers (this will be fixed in LioranBoard2), so read up!

  1. Add the trigger by right clicking on the button - Edit Twitch Triggers, and selecting Chat Message.
  2. You will see a bunch of checkboxes in the trigger options:
    • 1st - does not do anything, ignore it (leave unchecked)
    • Sub - triggers only if the viewer is your channel member (on Twitch they’re called subscribers)
    • Broadcaster - triggers only for the channel broadcaster
    • Mod - triggers only if the viewer is a mod
    • VIP - triggers only if the viewer’s status is verified
    • Message - if you use * all chat messages will pass through, you can also use Wild Cards
    • You cannot combine triggers. If you select Sub and Mod both, it means the viewer would need to be a sub (member) and a mod both. Add multiple triggers in that case, one for a mod and one for a sub (member).
    Chat Message Trigger Options
    Chat Message Trigger Options
  1. Once the trigger fires, you can retrieve the following values by using Math: Trigger Pull command and selecting the following values from the Chat Trigger submenu in the pull value dropdown menu.
Math Trigger Pull Name Description
Display Name Viewer’s chat display name.
User ID Viewer’s channel ID.
Channel Viewer’s channel URL.
Badge List Viewer’s badges. ADJUSTED to fit YouTube instead of Twitch, so it might look weird if you never used Twitch.
broadcaster/1 = viewer is a broadcaster, moderator/1 = viewer is a mod, subscriber/1 = viewer is a member, vip = viewer is verified.
Message Viewer’s message
Emote List This one is completely different. It says emote list, but it actually delivers VIEWER’S PROFILE IMAGE URL.


Edit

Live Chat Ended #

Extension Trigger: YT Live Chat Ended
YouTube should send this trigger a few minutes after your broadcast goes offline.
This means you can no longer send chat messages, ban/unban users, update broadcast, get your broadcast stats or listen to the events, as the stream has ended and chat is now closed for all the viewers as well.