X (Twitter)

Announce new posts from X accounts.

Configure X (Twitter) in the dashboard

Overview#

X notifications announce new posts from the accounts you follow. Iris checks every 15 minutes and posts the text with a link back to the original.

Each account has its own destination channel and its own optional ping role, so an announcements account and a personal one can go to different places.

The design is written once for the platform and reused by every account you add, unless you turn the shared design off for one of them.

Setup#

  1. Open the dashboard and go to Notifications > X (Twitter).
  2. Design the announcement under Announcement design and save it. This has to exist before an account can be added.
  3. Press Add notification.
  4. Enter the Username as it appears after x.com/. A full profile URL also works.
  5. Pick the channel it Posts to.
  6. Under Advanced settings, set a Ping role if you want one.

Settings#

SettingTypeDefaultWhat it does
Embed titleTextNew post from {user}Heading of the announcement. Part of the shared design.
Embed descriptionText{text}Body of the announcement.
Embed footerTextNoneSmall line at the foot.
Large image URLTextNoneImage below the text.
Thumbnail URLTextNoneSmall image in the top right.
UsernameText-The username after x.com/. One entry per account watched.
Posts toChannel-Where this account announces. Set per entry.
Use the announcement designToggleOnReuse the shared design. Off gives this account its own embed.
Ping roleRoleNo pingMentioned at the start of every notification for this account.

Variables#

VariableBecomes
{user}The account display name
{text}The post text
{url}A link to the post

Commands#

CommandWhat it doesRequires
/alertsManage platform alerts for this server from chat.Manage Server
.twitter helpAdd, list and remove watched accounts from chat.Manage Server

Permissions#

PermissionWhy Iris needs it
View ChannelsSees the channel announcements post to.
Send MessagesPosts the announcement.
Embed LinksThe announcement is an embed.
Mention EveryoneOnly if your ping role is not mentionable on its own.

What it looks like#

I
Iris APP Today at 8:53 PM
New post from creator

Just posted something new!

A new post from a watched account.

Tips and gotchas#

The account was not found.

Use the username exactly as it appears after x.com/, not the display name, and check the account is public.

How quickly does it post?

Within about 15 minutes.

Nothing has posted at all.

Check the announcement design has been saved once, and that Iris can send and embed in the destination channel.