📢 Social Notifications Documentation

Notify your community when creators on YouTube, Twitch, Bluesky or Reddit post or go live!
The docs are still work in progress!
Wamellow requries permission:
View ChannelSend MessagesEmbed LinksMention Everyone
  • Instant notifications for YouTube, Twitch, Bluesky and Reddit, more comming soon!
  • Every server can have up to 30 different channels and users for free.
  • Notifications are sent in real-time, almost instantly after uploading.
  • And free custom messages for every notification individually.

Setup

  1. Add Wamellow to your server by going to wamellow.com/add .
  2. Head to the dashboard by going to wamellow.com/dashboard .
  3. Select your server from the dashboard.
  4. Navigate to the Notifications tab.
  5. Click Create new Notification, select a platform and enter a channel url or username.
  6. Click Submit and start customizing your message!

No need to worry about creators changing their usernames — Wamellow updates them automatically. You also don’t need to own the channel to create notifications. As long as the channel is public, you can add it.

Channel url in browser example

✏️ Custom message & embed

 You can create a notification message with a fully customizable message and embed for free, enabling you to style the messages the way you love.

Note: Image previews might be broken on the dashboard.

🏓 Pings

 The role that should get notified about new uploads.
  • @everyone will ping every member in the server.
  • @here will ping every currently online member in the server.
  • @some-role will ping everyone with that role.

Note: If Wamellow does not have the Mention Everyone permissions inside the channel, it might not be able to actually notify members with those roles.

📫 Filter

 Allows you to select additional types or filter notifications for Bluesky:
  • Send Reposts will also notify when the user reposts any post.
  • Send Replies will also notify when the user replies to any post.
  • Send Quotes will also notify when the user quotes any post.
  • Must Contain Image will only notify when the post contains an image.

For all other services, you can take advantage of a regex to blacklist posts:
  • ^\[live\] will not post anything starting with [live].
  • insult|badword will not post anything that includes either insult or badword.
  • ^(?!support$).+$ will only post that are support. (useful for reddit flairs)

You can use regexr.com or ChatGPT to create (JavaScript-like) regexs. You can use regex keywords to negate the condition, in order to create a whitelist filter. The flags used for string matching are gi, only the titles and reddit flairs are checked.

🥳 Test notification

 Test notifications let you see how your message will look like when a video is uploaded or a streamer goes live, etc. For the purpose of testing, all pings are disabled, so no member will get notified. For streaming platforms, like Twitch, mock (fake) data is used to simulate a live stream. Notification filters will be ignored.

Better embeds

If you’d like to improve embeds (for example, fixing Bluesky embeds), you can use the following custom messages:
  • https://bskyx.app/profile/{creator.handle}/post/{post.id} (Lexedia/VixBluesky )
  • https://fxbsky.app/profile/{creator.handle}/post/{post.id} (fxbsky.app )
  • https://vxbsky.app/profile/{creator.handle}/post/{post.id} (dylanpdx/vxBsky )
  • https://bskye.app/profile/{creator.handle}/post/{post.id} (FerroEduardo/bskye )
  • https://bsyy.app/profile/{creator.handle}/post/{post.id}
A preview of all embeds can be found in this reddit post .

Offline notifications

If Wamellow is offline when a video, stream or post is published, your notification will be queued and sent as soon as Wamellow comes back online. You can view Wamellow’s current status on the status page .

Notification speed

Notifications are typically sent within these time frames:
  • YouTube: 4 to 8 seconds
  • Twitch: 10 to 100 seconds
  • Bluesky: 0.4 to 0.6 seconds (400ms to 600ms)
  • Reddit: up to 20 minutes

Platform limitations

YouTube keeps the video private for a few seconds to minutes after uploading, so the notification might be delayed by a few seconds.

Due to changes in Reddits' API pricing in 2023, we can't offer faster notification speeds, but 20 minutes should be fine. Since Reddit is still in testing, you can only setup 4 subreddits per server.

Placeholders

Placeholders allow you to use variables that change from message to message, for example to display information about the uploaded video or creator. They are always enclosed in curly braces, such as {creator.name}.

These are only available for YouTube. (*1)
Placeholder (*1)ExampleDescription
video.titleYour PC Can Look Like THIS Now!Video title
video.id74Lj5cHseI8Video id
video.linkhttps://youtube.com/watch?v=74Lj5cHseI8Video page
video.thumbnailhttps://i4.ytimg.com/vi/74Lj5cHseI8/hqdefault.jpgVideo thumnail
video.uploaded.ago9 months agoTime since upload
video.uploaded.at16 June 2024 4:58 PMUpload time & date
creator.subs16MSubscriber count
creator.videos6.9KAmount of videos
creator.views7.8BTotal channel views

These are only available for Twitch. (*2)
Placeholder (*2)ExampleDescription
stream.titleWatch my videos while I'm away on holidays in FijiStream title
stream.id45123288363Stream id
stream.linkhttps://twitch.tv/darkviperauStream page
stream.thumbnailhttps://.../...Stream thumbnail
stream.live.since9 months agoTime since live
stream.live.start16 June 2024 4:58 PMLive start time

These are only available for Bluesky. (*3)
Placeholder (*3)ExampleDescription
post.id3lck23sfi522vPost id
post.type*post [or] repost [or] replyPost type
post.linkhttps://bsky.app/profile/lunish.nl/post/3lck23sfi522vPost page
post.posted.ago9 months agoTime since post
post.posted.at16 June 2024 4:58 PMPost time & date
creator.handlelunish.nlCreator handle
creator.posts784Amount of posts
creator.followers48Amount of followers

*If a post is a reply, and your custom message is {post.type}ed it will display replied to, instead of replyed.

These are only available for Reddit. (*4)
Placeholder (*4)ExampleDescription
post.id1in69l2Post id
post.titleSome funny titlePost title
post.textA very, very long textPost body
post.thumbnailhttps://.../..Post thumbnail
post.flairSupportPost flair
post.posted.ago9 months agoTime since post
post.posted.at16 June 2024 4:58 PMPost time & date
author.usernamewayabotAuthor username
author.id1ea1sud48Author id
author.linkhttps://reddit.com/user/wayabotAuthor url
subreddit.namer/wamellowSubreddit name
subreddit.idd6lqaySubreddit id
subreddit.members1642519Subreddit members

PlaceholderExampleDescription
ping@some-roleNotify members
creator.nameLinus Tech TipsCreator username
creator.idUCXuqSBlHAE6Xw-yeJA0TunwCreator user id
creator.linkhttps://youtube.com/@LinusTechTipsCreator page
creator.avatarhttps://.../...Creator avatar url
PlaceholderExampleDescription
guild.nameSomeone'sServer name
guild.id828676951023550495Server id
guild.avatarhttps://cdn.discordapp.com/...Icon URL
guild.rules#some-channelRules channel
guild.memberCount848Member count

Frequently Asked Questions about Wamellow

Commonly asked questions about Wamellow and how to use it.

  1. Be sure to have the Manage Server permission on the server you want invite Wamellow into.
  2. Open Discord's add-app flow at wamellow.com/invite.
  3. Select a server and click on "Continue".
  4. Do not uncheck any permissions and click on "Authorize".
  5. Done! 🎉 You should now find yourself on the Dashboard for your server!

WamellowforDiscord
Blahaj