How filters work
Your filter decides which alerts reach you, and how loudly.
Every time an item at one of your stores could alert, like a price drop or an item coming back in stock (see when), Nectyra runs it through your filter. The filter gives one of three answers: ping you (high priority), post quietly (regular priority), or skip it.
You don't have to write a filter by hand. The filter builder lets you click one together, and the filter tester shows what it would do with a sample item.
The three parts of a filter
| Part | What it does | Required |
|---|---|---|
| High priority | Items that match get an alert that mentions you, so your phone buzzes. | Yes |
| Regular priority | Items that match get an alert without a mention. | Yes |
| Blacklist | Items that match never alert, no matter what the other two say. | No |
Nectyra checks them in this order and stops at the first match:
- If the item matches your blacklist, there's no alert.
- Otherwise, if it matches high priority, you get pinged.
- Otherwise, if it matches regular priority, you get a quiet alert.
- Otherwise, there's no alert.
Rules and groups
Each part is built from rules and groups.
A rule checks one thing about the item, like "percent off is at least 60" or "product name contains dewalt". The reference lists everything a rule can check.
A group combines rules (and other groups) in one of three ways:
- All of these. Matches only when every rule inside matches.
- Any of these. Matches when at least one rule inside matches.
- Not all of these. Matches when at least one rule inside does not match. With a single rule inside, it simply flips that rule: "not (product name contains behr)".
Groups can go inside groups, so you can say things like "penny items, or anything over $150 that's at least 60% off".
Empty groups
An empty All of these group matches every item, and an empty Any of these group matches none. An empty All group in your blacklist would block every alert. The filter builder warns you when a group is empty.
When an item is missing information
Some items don't have every detail. Home Depot doesn't list an MSRP for everything, and some items have no UPC or store SKU. When a rule checks a detail the item doesn't have:
- The rule doesn't match. For example, "MSRP at least 150" can't be true without an MSRP.
- Except for "is not" and "does not contain", which do match, because a missing value isn't the thing you excluded.
- In the blacklist, a missing detail never blocks an alert.
Saving your filter
- Build or edit your filter in the filter builder. To start from your current filter, run /edituserfilter and click the link.
- Click Copy for Discord.
- Run /setuserfilter and paste into the
jsonoption.
Very large filters, such as long lists of SKUs, can be more than 4,000 characters, which is too long to paste into Discord reliably. The builder tells you when that happens. Click Download instead, then run /setuserfilter and attach the file to its file option.
The builder runs the same checks as the bot, so if the builder says your filter is valid, the bot will accept it.