Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document Silent Messages. #5910

Merged
merged 1 commit into from Feb 8, 2023
Merged

Document Silent Messages. #5910

merged 1 commit into from Feb 8, 2023

Conversation

tpcstld
Copy link
Contributor

@tpcstld tpcstld commented Feb 8, 2023

Summary

Hey folks! This is actually my 2022 hackweek project which I got to finish to completion. :)

During a message send request, if you include the new SUPPRESS_NOTIFICATIONS flag it will not broadcast any push/desktop notifications but will still increment the relevant mention counters.

The intention is that you can get someone's attention but not feel like you could be distracting them. Like when you DM someone at 5am. I'm sure some bots can leverage this as well to avoid noise or something.

Also this should work for the webhook send request as well. And if you're looking to leverage this as a real user (gasp aren't you all just bots), you can write @silent as the very first thing in a message.

Screen.Recording.2023-02-08.at.3.12.56.PM.mov

Also sorry to all the users on Discord named silent who may have some textual conflict now. Forgive me!

FAQ (for the product not really for this documentation change lol)

Why is the UX @silent instead of a slash command?

Slash command UI is built for interactions with bots. You "basically" cannot mention anyone, or have long-form text, both of which are useful in this interaction scheme. I'm not here to promise anything just pointing it out for this feature.

When is this rolling out?

Should be available on your next Desktop refresh. Mobile 164 and up should get it I believe?

What happens if there's a user named "Silent" in the channel?

If you do not select the user in the autocomplete it will come out as a silent message. If you do select the user in the autocomplete it will mention the user instead.

Is there autocomplete?

No. And it is not planned. Currently, we're considering this like a hidden feature. I think eventually the long-term plan is to put a "proper UI" in place for this instead of it being a text-based flag, which is honestly kinda jank.

Hey folks!

This is actually my 2022 hackweek project which I got to finish to
completion. :)

During a message send request, if you include the new
`SUPPRESS_NOTIFICATIONS` flag it will not broadcast any push/desktop
notifications but will still increment the relevant mention counters.

The intention is that you can get someone's attention but not feel like
you could be distracting them. Like when you DM someone at 5am. I'm sure some
bots can leverage this as well to avoid noise or something.

Also this should work for the webhook send request as well.

[Add a picture of the UI here]

If you're looking to leverage this as a non-bot, you can write `@silent`
as the _very first_ thing in a message. Make sure your client is
up-to-date btw. Autocomplete a-la `@everyone` is not planned. Eventually we may
put this in an "actual UI", for now this is where it lives. :)

Also sorry to all the users on Discord named silent who may have some
textual conflict now. Forgive me!
@Syjalo
Copy link

Syjalo commented Feb 8, 2023

If it's possible to pass that flag on message create then the params documentation isn't updated.
https://discord.com/developers/docs/resources/channel#create-message-jsonform-params
image

@tpcstld
Copy link
Contributor Author

tpcstld commented Feb 8, 2023

FML. I'll push up another commit or PR. Thanks for letting me know.

@tpcstld
Copy link
Contributor Author

tpcstld commented Feb 9, 2023

BTW IT NEEDS TO BE MOBILE CLIENTS 164 AND UP OOPS. (I thought it was 163 originally.)

diamondburned pushed a commit to diamondburned/arikawa that referenced this pull request Feb 11, 2023
onerandomusername added a commit to DisnakeDev/disnake that referenced this pull request Feb 21, 2023
…#929)

Adds `MessageFlags.suppress_notifications`
(discord/discord-api-docs#5910), and implements
a `flags` parameter on all `send`-like methods.

Co-authored-by: arl <me@arielle.codes>
lukellmann added a commit to kordlib/kord that referenced this pull request Mar 2, 2023
In addition to adding MessageFlag.SuppressNotifications the message
create and edit builders were extended to allow setting MessageFlags
with convenience properties for setting MessageFlag.SuppressEmbeds
and MessageFlag.SuppressNotifications directly.

see discord/discord-api-docs#5910 and
discord/discord-api-docs@f7cc5dd

Co-authored-by: Lukellmann <lukellmann@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants