Add Automod documentation

[Mateo-tem]

Just adds the documentation for auto-moderation, the new feature of Discord.
See https://support.discord.com/hc/en-us/articles/4421269296535.

[RedDaedalus]

I'm guessing this will be documented along with the rest of auto mod features when it becomes open to bots.

[i0bs]

This is still being rolled out with a beta pill in servers. That gives reason for me to believe it's still WIP, so PRing docs now doesn't seem to be necessary

[Mateo-tem]

I will mark this as a draft until Discord adds the feature completely and for all the servers.

[splatterxl]

https://github.com/discord/discord-api-docs/blob/main/CONTRIBUTING.md

Unwanted changes
Additions that document unreleased product functionality

[advaith1]

in addition to what others have said, message type 24 is AUTO_MODERATION_ACTION

[Le0Developer]

There's also a new guild feature flag: AUTO_MODERATION

[Mateo-tem]

I noticed one audit log event is missing. The event has the 143 action type.
Is emitted when the AutoMod system user blocks a message of a user in a channel according to an auto-moderation rule.
What would be/is the name of the event?

[advaith1]

AUTO_MODERATION_BLOCK_MESSAGE

[splatterxl]

Is there a route to update automod rules?

[advaith1]

also, when will the automod message format be stabilized? can it be changed to have an object of data instead of abusing embed fields

[hemu]

@hemu Let me know if all is right to mark this as ready for review.

sounds good :) feel free to mark it for review

[hemu]

I added this section to explain the different ways keywords can match based on how you use the * wildcard. If it's not clear it's something we can iterate on and improve as a follow up

[Mateo-tem]

@hemu Let me know if all is right to mark this as ready for review.

sounds good :) feel free to mark it for review

All right!

[Mateo-tem]

I added this section to explain the different ways keywords can match based on how you use the * wildcard. If it's not clear it's something we can iterate on and improve as a follow up

Nice!

[hemu]

also, when will the automod message format be stabilized? can it be changed to have an object of data instead of abusing embed fields

This is planned for later on after the initial launch. Yes, the data will be contained in a single object field instead of using embed fields.

[hemu]

Thank you to everyone that took the time to contribute and offer feedback :) Really appreciate all the helpful suggestions we received to improve both these docs and the API for Automod. Going to merge this in but if there are more errors / suggestions feel free to continue commenting on this PR -- will continue checking here for the next week or so.

[onerandomusername]

@hemu Will there be an audit log event for automatic timeouts? Right now the audit log does not mention that the user was timed out at all, and no audit log entry is created if the only action taken is timing out the user.

[hemu]

@hemu Will there be an audit log event for automatic timeouts? Right now the audit log does not mention that the user was timed out at all, and no event is created if the only action taken is timing out the user.

Yes, support for the timeout action will be added to the audit log