Triggers

A trigger is a rule "when a message contains this, do that". Triggers answer the questions your group gets every day, point newcomers to the rules, or keep a topic on subject. They are set up in the Triggers section of the mini app.

Creating a trigger

Press Add new trigger and fill in:

• Trigger rule: the word or phrase to look for.
• Bot response: what the bot replies. Add link buttons with the buttons row under the text editor; written by hand, a button is {{button|Button label|https://example.com}}. In a group the reply is private: only the member whose message fired the trigger sees it.

Match modes

• Default: fires only when the whole message is the trigger text, ignoring upper and lower case. In practice this works like Exact match.
• Exact match: fires only when the whole message is exactly the text.
• Separate word: fires only on the whole word.
• Not in message: the reverse, fires when the text is not found. Use it with a topic to require something in every message there, for example a hashtag.

Actions

• Delete incoming message: removes the message that fired the trigger. With Deletion timer you can delete it immediately or after 10 seconds, 30 seconds, 1 minute or 2 minutes, and the bot's reply warns the person so they can copy their text first.
• Pin message: pins the message that fired the trigger, with or without a notification, instead of replying.
• Active in topic: limits the trigger to one forum topic by its ID. Empty means all topics.

Good to know

• Triggers also answer group administrators, so you can test them yourself. A trigger never deletes an admin's message.
• Filters run first. If a message breaks a filter, it is deleted and no trigger fires, so a trigger can't be used to sneak links or spam past the filters.
• A message that fires a trigger is not deleted by the Bot commands filter, so /rules-style triggers work even when bot commands are forbidden.
• A trigger that deletes the incoming message is logged as "Trigger fired" in the event log with the rule that matched. Triggers that only reply or pin are not logged.