document super reactions

[Mateo-tem]

This PR documents the information about the super reactions feature.

[Lulalaby]

Can bots even create super reactions?

[Mateo-tem]

Can bots even create super reactions?

I tried to create super reactions with a bot and it worked. If I am not mistaken, I created two super reactions, but now, I am trying again and this error appears: No available burst currency for user.

As far as I know, Discord is giving two free super reactions for users, but I think this is also happening in bots. Is this a bug?

[Lulalaby]

I believe bots shouldn't be able to do this. It's probably not gonna be checked for bot

[sklein12]

👋 thanks for doing this, however, there's still some updates we need to make to the shape of the API response so let's hold off on merging this.

[thehatkid]

Also for now GET /channels/{channel.id}/messages/{message.id}/reactions/{emoji} takes new query parameter type.
Type 0 for getting normal reaction users list and 1 for getting burst (super) reaction users list.
(e.g. GET /channels/{channel.id}/messages/{message.id}/reactions/{emoji}?type=1)

[jaw0r3k]

Also for now GET /channels/{channel.id}/messages/{message.id}/reactions/{emoji} takes new query parameter type. Type 0 for getting normal reaction users list and 1 for getting burst (super) reaction users list. (e.g. GET /channels/{channel.id}/messages/{message.id}/reactions/{emoji}?type=1)

Btw default type is 0

[JJRcop]

MESSAGE_REACTION_ADD also has updates, which aren't in this PR. Is this usable yet or still subject to changes?

Screenshots

[advaith1]

api surface is still unstable. hopefully soon:tm:

[NeloBlivion]

Any further updates on this?

[JJRcop]

MESSAGE_REACTION_ADD also has updates, which aren't in this PR.

Will these be added? They are missing from documentation.

@Mateo-tem Any feedback?

[Mateo-tem]

MESSAGE_REACTION_ADD also has updates, which aren't in this PR.

Will these be added? They are missing from documentation.

@Mateo-tem Any feedback?

We might wait for a staff response, because as it was said, the API needs to be updated

[Jay-Madden]

Is there any movement on this? has the api stabilized?

[MinnDevelopment]

These docs are very confusing to me.

• What are the colors used for and why are they hex? Does this imply it can also be #FFF equivalent of #FFFFFF?
• Why is it an array if the reaction only has 1 color in the UI?
• Why are there 2 different counts now? The client doesn't let you send a normal reaction of the same emoji

I would prefer if the documentation would be more detailed than "this is a color thats used".

[advaith1]

for the last one, that's only for one user - different people can super react and normal react with the same emoji, but one person could not do both (though that has changed)