When · Triggers · supported
First chat this stream (Welcome Back)
Fires the first time a viewer sends a message this stream session — the same event that shows the Welcome Back badge. Optionally filter to specific usernames.
trigger.viewer_join · 2.8.0
Requirements and availability
Connected supported event provider; enabled automation and matching filters.
Picker contexts: automation.
Incoming providers: twitch, youtube, kick, tiktok.
Behavior
Requires the dedicated viewer_join event, first-session flag and not first-ever. Optional usernames are trimmed, case-insensitive, one per line.
Configure in the app
Open: Bot → Automations → + New → When
Steps
- Choose Trigger category: Chat & viewers.
- Choose Trigger event: First chat this stream (Welcome Back).
- Fill the Trigger filters below, set Cooldown (seconds), then open Where and choose a supported Platform.
- Open Do, add actions, then Create Automation or Save Changes.
Trigger filters
| Field | Input / options | Defaults / limits | Availability |
|---|---|---|---|
Usernames (one per line)usernames | textarea | Example hint: StreamerBot MyFriend ... | Trigger filter |
Contract details
- Cooldown
- Automation cooldownSec defaults 0; keyed by automation ID and event platform; held in memory until restart.
- Delay
- No additional trigger delay.
Examples
Trigger selection and filter defaults; supply a real target/pattern when required.
{
"triggerType": "viewer_join",
"triggerPlatform": "all",
"triggerFilters": {
"usernames": ""
}
}Related entries
Source and verification
Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.
- src/features/automations.js — TRIGGER_REGISTRY.viewer_join
- src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.viewer_join
Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1