Phrase automations

A phrase automation posts every new X post containing a phrase, from an author who clears the follower and check-mark gates.

Trigger

Every 10 seconds, the bot searches X's Latest feed for the phrase.

A post matches when it contains the phrase exactly (case-insensitive) and its author clears the minimum-follower and check-mark gates. Reposts are not announced; replies are.

Up to 5 new posts announce per check. If more turn up, the newest 5 send first and the rest wait for the next check.

Setup

Setup, in order

  1. Open Dashboard → Beta → Automations with the bot selected.
  2. Click Add and pick Phrase Filter in the Which automation? picker.
  3. Enter the phrase in phrase to scan for — up to 120 characters.
  4. Set the author gates: min followers (0 = everyone) and the check-mark dropdown (Any account, Any check mark, Blue check, Gold check, Gray check).
  5. Pick the destination group from Posts in group… — only groups already authorized for the bot are listed.
  6. Optional: add rules on the same form — rules here are about the post's author.
  7. Optional: write the message, upload or link an image, set the link label and position, add buttons.
  8. Click Create.
  9. Optional, from the saved automation's card: open the Topics icon to route its messages into a forum topic, or the Recap icon to add a scheduled recap.

Settings

SettingAcceptsDefault
PhraseText, 1–120 characters, no " characterRequired
Minimum followersWhole number, 0 to 1,000,000,0000 — everyone qualifies
Check markAny account, Any check mark, Blue check, Gold check, Gray checkAny account
Destination groupOne of the bot's authorized groupsRequired
MessageTextEmpty — uses the default message (see Output)
Imagejpg, jpeg, png or webp, 5MB maxEmpty — uses the matching post's own photo when it has one
Link labelText; empty shows the bare post URLView post on X
Link positionTop or bottomBottom
Show quoted postOn or offOn
ButtonsUp to 12; label up to 64 characters; URL must start with http(s)://None
Button layoutStacked or inlineStacked
RulesUp to 8 — set on this formNone
RecapScheduled summary of the automation's posts — set from the saved cardOff
TopicsRoute messages into a forum topic — set from the saved cardGeneral

Output

The message has up to three parts: the link line (top or bottom), your message text (or the default below), and — unless Show quoted post is off — the post's own text as a quote, cut to 600 characters (400 when there is an image).

Default message (message left empty)

InputOutput
Message🔎 **@handle posted** the phrase

The phrase is shown in italics.