📢 Social Notifications Documentation

Notify your community when creators on YouTube, Twitch or Bluesky post or go live!
The docs are still work in progress!
Wamellow requries permission:
View ChannelSend MessagesEmbed LinksMention Everyone
  • Instant notifications for YouTube, Twitch and Bluesky (bsky.app), more comming soon!
  • Every server can have up to 30 different channels and streamers for free.
  • Notifications are sent within five to ten seconds 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 @handle.
  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.

🥳 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.

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.ago8 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.since8 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.ago8 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.

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

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)

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

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!