YouTube Trigger: Chat Message Added
The Chat Message Added trigger is activated anytime a new chat message is added by a viewer in your YouTube broadcast.
You must have an active broadcast on your YouTube channel in order for this feature to work. Aitum checks your YouTube channel for a new broadcast every few minutes.
There is no default fallback value for Switch fields in Aitums YouTube triggers.
You can set a custom fallback value by clicking the cog wheel next to any of the Switch fields (True/False). This value is used only if the value of the field is used as a local variable within that rule. This fallback value will be used if the rule is triggered by another rule, rather than by a chat message being added to your chat.
Trigger Inputs
Username
The username of the user who added the chat message in your YouTube chat.
If the Username field is left blank, the Chat Message Added trigger will fire regardless of who added the message to chat. However, if you enter a username in the Username field, the Chat Message Added trigger will only fire when the specified user adds a message to the chat. The username must match the display name of the desired user exactly. (case sensitive)
| Type | Text (String) |
|---|---|
| Default Fallback | Unknown User |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Is Verified?
Whether or not the user who added the message to your YouTube chat is verified or not.
If the Is Verified field is left un-set (neither true or false), the Chat Message Added trigger will fire whether the user who added the message is verified or not. If the field is set to ‘True’, then the trigger will only fire when the user who added a message is using a verified account on YouTube. If this field is set to ‘False’, the trigger will only fire if the users account is un-verified on YouTube.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Broadcaster?
Whether or not the user who added the message to your YouTube chat is the broadcaster (i.e. If you added a message to your own chat).
If the Is Broadcaster field is left un-set (neither true or false), the Chat Message Added trigger will fire whether the user who added the message is the broadcaster or not. If the field is set to ‘True’, then the trigger will only fire when the user who added a message is the broadcaster. If this field is set to ‘False’, the trigger will only fire if the users account is not the broadcaster.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Moderator?
Whether or not the user who added the message to your YouTube chat is a moderator.
If the Is Moderator field is left un-set (neither true or false), the Chat Message Added trigger will fire whether the user who added the message is a moderator or not. If the field is set to ‘True’, then the trigger will only fire when the user who added a message is a moderator. If this field is set to ‘False’, the trigger will only fire if the user who added the message is not a moderator.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Is Member?
Whether or not the user who added the message to your YouTube chat is a paid member of your YouTube channel.
If the Is Member field is left un-set (neither true or false), the Chat Message Added trigger will fire whether the user who added the message is a paid member or not. If the field is set to ‘True’, then the trigger will only fire when the user who added a message is a paid member. If this field is set to ‘False’, the trigger will only fire if the user who added the message is not a paid member.
| Type | Switch (Boolean) |
|---|---|
| Default Fallback | (See Note Above) |
| Required | No |
| Local Variable | Yes |
Message
The message the user added in your YouTube chat.
If the Message field is left blank, the Chat Message Added trigger will fire no matter what the user message is. However, if you enter any text into the Message field, the Chat Message Added trigger will only fire when the users message is an exact match to the text specified in the Message field. (case sensitive)
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Hidden Variables
Hidden Variables are available as Local Variables within the actions of a rule, but you will not see these fields visually on the Trigger. These can also be used with a New Rule Check, more info here on Checks.
User Profile Image URL
The Profile Image URL of the user who added a message to your YouTube chat.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
User Channel URL
The URL of the users channel who added a message to your YouTube chat.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |
Channel ID
The Channel ID of the user who added a message to your YouTube chat.
| Type | Text (String) |
|---|---|
| Default Fallback | (No Default) |
| Min - Max Characters | (No Min - Max) |
| Required | No |
| Local Variable | Yes |