Skip to main content

Alerts

What is an Alert?​

Alerts watch for specific conditions in events, like when a donation amount matches what you set, and automatically trigger a set of actions in response.

Think of an Alert as a rule: "When this happens, do these things."

Only one Alert fires per event

Events are matched against your alert list in order. The first matching alert wins. Any others are skipped.

How Does It Work?​

  1. An Event arrives (e.g. someone tips $10 on Twitch).
  2. TipLink checks your alerts top-to-bottom.
  3. The first matching alert runs all of its Actions (e.g. show an overlay, post to Discord).
  4. The event is marked as complete.

Creating an Alert​

  1. Go to the Alerts page in the sidebar.

  2. Click Create New Alert in the top-right corner.

  3. Enter a Title for your alert (e.g. "$5 Donation").

  4. Under Platforms, select which platform(s) this alert should apply to.

    • Example: select Twitch if you only want this alert to fire for Twitch events.

  5. Under each selected platform, choose the account(s) this alert should match.

  6. Under Valid Events, select the event type(s) that trigger this alert (e.g. Donation / Tip).

    • Some event types have additional settings (like a minimum dollar amount). These appear below under Settings For Selected Events.

  7. Scroll down to the Actions section and click Add Action.

  8. Select an action type (e.g. Stream Overlay, Discord Webhook, PiShock Device).

  9. Configure the action settings.

  10. Click Save to save your alert.

Add multiple actions

You can add as many actions as you like to a single alert. They all run together when the alert fires.

Managing Alerts​

Enable / Disable​

Use the toggle switch next to each alert to enable or disable it without deleting it. Disabled alerts are skipped during event matching.

Reordering Alerts​

Drag alerts up and down using the drag handle (⠿) on the left side. Order matters — the first matching alert wins.

Duplicating an Alert​

Click the ⋮ (more options) menu on an alert and select Duplicate to create a copy.

Testing an Alert​

Click the ⋮ menu and select Test Actions to fire the alert's actions immediately, without needing a real event.

Filtering by Alert Set​

If you have Alert Sets, use the filter button at the top of the Alerts page to show only alerts belonging to a specific set.

Next Steps​