Skip to main content

Event reference

Every event type AveloBot can react to, with its label, default chat message, and the template variables you can use.

tip

Every event has a Test button on the /events page. Use it to preview your message with sample values before going live.

Follow​

A viewer follows the channel.

  • Variables: {user}, {displayname}
  • Default message: 
    Welcome @{displayname}! Thanks for following! 💜

Subscription​

A viewer subscribes (paid tier 1 / 2 / 3, first month).

  • Variables: {user}, {displayname}, {tier}
  • Default message: 
    Thanks for the Tier {tier} sub @{displayname}! Welcome aboard!

Prime Subscription​

A viewer subscribes using Twitch Prime.

  • Variables: {user}, {displayname}
  • Default message: 
    Thanks for the Prime sub @{displayname}! 👑

Resubscription​

A returning subscriber renews.

  • Variables: {user}, {displayname}, {tier}, {months}, {streak}
    • {months} — total cumulative months
    • {streak} — consecutive months
  • Default message: 
    @{displayname} just resubbed for {months} months! 🎉

Gift Subscription (gifter)​

Fired for the gifter when someone gifts subs.

  • Variables: {user}, {displayname}, {tier}, {count}, {total}
    • {count} — number of subs gifted in this batch
    • {total} — lifetime total gifted to this channel
  • Default message: 
    @{displayname} just gifted {count} subs! 🎁

Gift Subscription (recipient)​

Fired for each recipient of a gifted sub.

  • Variables: {user}, {displayname}, {gifter}, {tier}
  • Default message: 
    Welcome @{displayname} — thanks @{gifter} for the gift sub!

Stream Online​

Your stream goes live. Posted as Twitch announcement.

  • Variables: {channel}, {title}, {game}
  • Default message: 
    {channel} is now live playing {game}: {title}

Stream Offline​

Your stream ends.

  • Variables: {channel}
  • Default message: 
    {channel} just went offline. Thanks for hanging out! 💜

Raid​

Another channel raids yours.

  • Variables: {user}, {displayname}, {viewers}
  • Default message: 
    Welcome raiders from @{displayname}! {viewers} viewers incoming! 🚨

Cheer (Bits)​

A viewer cheers bits.

  • Variables: {user}, {displayname}, {bits}, {message}
  • Default message: 
    Thanks @{displayname} for {bits} bits! ✨

Ad Break — 60s Warning​

Twitch is about to start an ad break. Posted as Twitch announcement.

  • Variables: {channel}, {duration} (in seconds)
  • Default message: 
    Heads up — ads start in 60 seconds! Sub to skip them 💜

Ad Break — Start​

An ad break starts. Posted as Twitch announcement.

  • Variables: {channel}, {duration} (in seconds)
  • Default message: 
    Ads are running for {duration}s. Back soon! ⏱️

Channel Title Changed​

Your stream title changes (via !settitle, the dashboard, or another tool).

  • Variables: {channel}, {title}
  • Default message: 
    New stream title: {title}

Channel Category Changed​

Your stream category changes.

  • Variables: {channel}, {category}
  • Default message: 
    Now streaming: {category}

Tip (StreamElements)​

A donation comes in via StreamElements. Requires StreamElements connected.

  • Variables: {user}, {amount}, {currency}, {message}, {separator}
    • {separator} — printed between amount and viewer message; defaults to " | " and is omitted if there is no message.
  • Default message: 
    {user} just tipped {amount} {currency}{separator}{message}