Skip to main content

Triggers

A Trigger is the condition that decides whether an alert should fire when an event arrives. When TipLink receives an event, it checks each alert's triggers to find the first match.


How Triggers Work

Each alert has:

  • A set of valid platforms (e.g. only Twitch, or Fansly + Ko-fi).
  • A set of valid accounts within those platforms.
  • A set of valid event types (e.g. Donation, New Subscriber, Gift Sub).
  • Optional conditions specific to that event type (e.g. minimum donation amount).

All conditions must match for the alert to fire.


Event Types

The following event types are supported. Available types depend on the platform connected.

Tip / Donation Platforms

Event TypeDescription
Tip / DonationA monetary tip is received
SubscriptionA paid subscription or membership
Gift SubscriptionA subscription gifted to another user
FollowA new follower
Chat MessageA message sent in chat

Twitch-specific

Event TypeDescription
BitsCheering with Twitch Bits
RaidAnother streamer raiding your channel
Hype TrainA Hype Train begins or progresses
PollA poll starts or ends
Channel Point RedemptionA viewer redeems channel points
Ad BreakAn ad break starts

Device Events

Event TypeDescription
POST RequestAn inbound webhook request (used with the Webhook platform)

Amount Conditions (Min / Max)

For event types that carry a numeric value (like a donation amount, number of gifted subs, or Bits count), you can set a minimum and maximum value range.

Example — "$5 to $20 donation" alert:

  • Minimum Value: 5
  • Maximum Value: 20
  • Disable Maximum: (off)

Example — "Any donation over $10" alert:

  • Minimum Value: 10
  • Disable Maximum: (on) — this makes the alert fire for any amount ≥ 10, with no upper limit.
How value is determined

For tips, the value is the donation amount. For subs/gift subs, it's the number of months or the number of gifts. For Bits, it's the number of Bits cheered.


Platform & Account Filtering

Platform Selection

When creating or editing an alert, you can restrict it to specific platforms. If you only want it to fire for Twitch tips (not Ko-fi tips), select only Twitch under Platforms.

Account Selection

If you have multiple accounts connected for the same platform (e.g. two Twitch channels), you can choose which account(s) the alert applies to.


Alert Ordering

Alerts are evaluated top to bottom in the order they appear on the Alerts page. The first matching alert fires. All others are skipped.

This means:

  • Put more specific alerts (e.g. "$100+ donation") above more general ones (e.g. "any donation").
  • A catch-all alert (e.g. minimum = $0.01, no maximum) should be last in the list.

Use the drag handle (⠿) to reorder alerts on the Alerts page.


Tips

  • You can select multiple event types per alert. For example, an alert could fire for both Donation and Gift Sub events.
  • If you want different behaviour for different amounts (e.g. $5–$20 vs $20+), create separate alerts with different min/max ranges.
  • To test any trigger, use the Test Actions option from the alert's ⋮ menu — no real event needed.