Social Notifications
Automatically announce new posts from your favorite creators.
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.
Creating a new feed
Creating a new feed
Use the twitter add subcommand receive notifications for a specific user.
For YouTube, you can use a channel URL instead of a username.
Removing a social feed
Removing a social feed
Customizing the message
Customizing the message
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.
Viewing all users being monitored
Viewing all users being monitored
Use the twitter list subcommand to view all users being monitored.
Specific Commands
Twitter Retweets
Twitter Retweets
The twitter retweets subcommand allows you to toggle notifications for retweets.
Pinterest Embeds
Pinterest Embeds
The pinterest embeds subcommand allows you to toggle the embed for the notification.
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.