Beta reference. Prepared from development builds for this version. This reference does not describe the current stable release.

A verified stable reference is not available yet. Choose a prepared beta version above.

When · Triggers · supported

First chat ever

Fires the very first time a viewer sends a chat message on any platform.

trigger.first_chat · 2.8.0

Requirements and availability

Connected supported event provider; enabled automation and matching filters.

Picker contexts: automation.

Incoming providers: twitch, youtube, kick, tiktok.

Matches the first-chat-ever flag; the viewer has not previously chatted in tracked history.

Open: Bot → Automations → + New → When

Choose Trigger category: Chat & viewers.
Choose Trigger event: First chat ever.
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.

Cooldown: Automation cooldownSec defaults 0; keyed by automation ID and event platform; held in memory until restart.
Delay: No additional trigger delay.

Trigger selection and filter defaults; supply a real target/pattern when required.

{
  "triggerType": "first_chat",
  "triggerPlatform": "all",
  "triggerFilters": {}
}

Source-reviewed for 2.8.0. Connected-service validation remains subject to release UAT.

src/features/automations.js — TRIGGER_REGISTRY.first_chat
src/features/automation-provider-capabilities.js — AUTOMATION_TRIGGER_PLATFORMS.first_chat

Source revision: 472fb34b484eeef0b663d28cacb628a7b9f14ff1