Skip to main content

Supported Platforms

There are nine social notification commands, each with the same subcommands.

Subscription Required

Instagram requires a subscription to use, while the other social notification commands are available to all users without any additional cost.
  • TikTok - Dispatched whenever a new video is uploaded.
  • Instagram - Dispatched whenever a new post or story is uploaded.
  • YouTube - Dispatched whenever a new video or short is uploaded.
  • Twitter - Dispatched whenever a new tweet is posted by a user.
  • Subreddit - Dispatched whenever a new post is made in a subreddit.
  • SoundCloud - Dispatched whenever an artist releases a song or album.
  • Pinterest - Dispatched whenever a new pin is saved to a board.
  • Twitch & Kick - Dispatched whenever a streamer goes live.

Commands

The following examples use the twitter command, but the same syntax applies to the other social notification commands.
Use the twitter add subcommand receive notifications for a specific user.
For YouTube, you can use a channel URL instead of a username.
,twitter add (channel) (username)
Use the twitter remove subcommand to no longer receive notifications for a specific user.
,twitter remove (channel) (username)
Use the twtter message subcommand to customize the message content that is displayed when a social notification is dispatched.
This command is usually used to ping a role or user. In order for the message to actually notify the role or user, you must include the --pingable on flag in the command.
,twitter message (username) (message) [--pingable on|off]
Use the twitter list subcommand to view all users being monitored.

Specific Commands

The twitter retweets subcommand allows you to toggle notifications for retweets.
,twitter retweets (channel) (username) (yes|no)
The pinterest embeds subcommand allows you to toggle the embed for the notification.
,pinterest embeds (channel) (yes|no)

Important Notes

Twitter Spamming

It’s important to make the channel private while setting up Twitter. This is to avoid spamming the channel with notifications, as the bot will bulk send the first few tweets from the user, which can cause people to get pinged multiple times repeatedly in a short period of time.

YouTube Channel Incorrect

Sometimes YouTube provides the incorrect channel from the username. This is because the channel isn’t a known result on YouTube. If this happens, you can use the channel URL instead of the username to fix this issue.

Slight Delay in Notifications

Most social notifications are monitored at an interval. This can cause a slight delay in the notification being dispatched, however YouTube and Twitch notifications should be dispatched instantly whenever a new video or stream goes live.

Customizing the Message

You can’t customize the embed for social notifications. However you can customize the message content that is dispatched with the message subcommand. The pinterest command is the only exception, as it has an embeds subcommand which can be used to toggle the embed for the notification.
I