Triggers: Commands, Timers and Events — HAL 8580 User Guide
Set up HAL 8580 triggers for your Twitch chat: keyword, pattern and command triggers on every plan, and silence, timed, raid, follow and sub on Premium.
A trigger is a fixed answer or action: a command like !schedule, a timer, or a reaction to an event. Nobody needs to mention HAL for it to run. Find triggers in the dashboard under How HAL behaves, then Triggers.
Use stream notes instead when you want HAL to answer in its own words.
Kinds of triggers
On every plan:
- Keyword: runs when a chat message contains one of your words.
- Pattern: runs when a chat message matches a pattern you write.
- Command with a name: runs when someone types a command and text after it, like
!so name.
On Premium:
- Silence: runs when chat has been quiet for a while.
- Busy chat: runs when chat suddenly gets busy.
- Timed: runs on a schedule you set.
- Raid: runs when another channel raids you.
- Follow: runs when someone follows you.
- Sub: runs when someone subscribes.
Timed and event triggers run only while you're live. The free plan has 5 triggers, Premium 100. On the free plan, Premium triggers you saved (for example during the Premium trial) are paused with their settings kept, and run again when you upgrade.
When a chat trigger matches, HAL sends that trigger's reply instead of its normal AI reply. If several triggers match the same message, only the first one runs.
Keyword
Enter one or more keywords, separated by commas. The trigger runs if any of them appears in the message.
- Case sensitive (off by default): when off,
!Discord matches !discord. - Exact match (off by default): when off, the keyword can sit inside a longer word (
sing runs on "singing"). When on, the word must stand alone: sing runs on "can you sing?" but not on "singing". This works for !commands and for phrases like good night too.
Keywords: !discord, !social
Reply: Join the Discord: discord.gg/example
Runs on: "!discord", "where is the !social link"
Not on: "what's the discord?" (no "!")
Pattern
Enter a regular expression. The trigger runs when it matches anywhere in the message. Matching ignores capital letters. Use ^ and $ to match the whole message. A pattern that isn't valid never runs.
Pattern: ^!(help|commands)$
Reply: Commands: !discord !socials !lurk
Runs on: "!help", "!COMMANDS"
Not on: "!help me please"
Pattern: ^!?lurk(\s.*)?$
Reply: Enjoy the lurk
Runs on: "!lurk", "lurk going to bed"
Not on: "lurker"
Command with a name
A chat command that takes text after it. The message must start with the command word, followed by a space or nothing at all. Everything after the command becomes {{parameter}}.
!so runs on "!so @friend", but not on "!sorry".- Who can use it: Everyone, or Mods only (moderators and you).
- What HAL does: Sends a reply, with
{{parameter}} replaced by the text; or Calls a web address, with {{parameter}} in the address replaced by the text. Calling a web address posts nothing to chat.
Command: !so (Mods only)
Reply: Go follow {{parameter}}, they're great
Chat: !so @friend
HAL: Go follow @friend, they're great
Command: !sr (Calls a web address)
Address: https://example.com/queue?song={{parameter}}
Chat: !sr Never Gonna Give You Up
Only {{parameter}} is filled in. Other placeholders such as {username} are sent exactly as written.
Premium kinds
- Silence: set the minutes of quiet chat before it runs. It runs once per quiet stretch; chat has to speak again before it can run again.
- Busy chat: set a number of messages within a number of minutes.
- Timed: set a schedule in cron form and your time zone.
0 * * * * is every hour, */30 * * * * every 30 minutes, 0 0 * * * once a day. - Raid, Follow and Sub: run when Twitch tells HAL about the event.
Options on every trigger
- Cooldown (minutes): how long a trigger waits before it can run again.
- Most runs an hour: caps how often it runs.
- Let HAL word the reply: HAL says your reply in its own voice and keeps its facts and links.
Tips
- Use cooldowns so a trigger can't spam chat.
- Try a pattern before you rely on it, and check "Last ran" in your list to see what runs.
- Examples:
!commands lists your commands; pattern gg|wp|gj replies "Nice play"; silence for 5 minutes asks chat a question; every hour reminds everyone to drink some water; a new follower gets a welcome.
HAL 8580 is an AI-powered chat bot for Twitch streamers. It joins your chat as a co-host, talks with your viewers, welcomes raids and regulars, and remembers your community. 15 personalities. Free to start.
This site is a single-page application and requires JavaScript to use the dashboard. To learn more or sign up, please enable JavaScript and reload.