Struct twilight_http::request::guild::auto_moderation::CreateAutoModerationRule

pub struct CreateAutoModerationRule<'a> { /* private fields */ }

Create an auto moderation rule within a guild.

Requires the MANAGE_GUILD permission.

Examples

Create a rule that deletes messages that contain the word “darn”:

use twilight_http::Client;
use twilight_model::{guild::auto_moderation::AutoModerationEventType, id::Id};

let client = Client::new("my token".to_owned());

let guild_id = Id::new(1);
client
    .create_auto_moderation_rule(guild_id, "no darns", AutoModerationEventType::MessageSend)
    .action_block_message()
    .enabled(true)
    .with_keyword(&["darn"])
    .await?;

Implementations

impl<'a> CreateAutoModerationRule<'a>

pub fn action_block_message(self) -> Self

Append an action of type BlockMessage.

pub fn action_block_message_with_explanation( self, custom_message: &'a str ) -> Result<Self, ValidationError>

Append an action of type BlockMessage with an explanation for blocking messages.

Errors

Returns a AutoModerationBlockActionCustomMessageLimit if the custom message length is invalid.

pub fn action_send_alert_message(self, channel_id: Id<ChannelMarker>) -> Self

Append an action of type SendAlertMessage.

pub fn action_timeout(self, duration_seconds: u32) -> Self

Append an action of type Timeout.

pub const fn enabled(self, enabled: bool) -> Self

Set whether the rule is enabled.

pub const fn exempt_channels( self, exempt_channels: &'a [Id<ChannelMarker>] ) -> Self

Set the channels where the rule does not apply.

pub const fn exempt_roles(self, exempt_roles: &'a [Id<RoleMarker>]) -> Self

Set the roles to which the rule does not apply.

pub fn with_keyword( self, keyword_filter: &'a [&'a str] ) -> ResponseFuture<AutoModerationRule>

Create the request with the trigger type Keyword, then execute it.

Rules of this type require the keyword_filter field specified, and this method ensures this. See Discord Docs/Keyword Matching Strategies and Discord Docs/Trigger Metadata.

pub fn with_spam(self) -> ResponseFuture<AutoModerationRule>

Create the request with the trigger type Spam, then execute it.

pub fn with_keyword_preset( self, presets: &'a [AutoModerationKeywordPresetType], allow_list: &'a [&'a str] ) -> ResponseFuture<AutoModerationRule>

Create the request with the trigger type KeywordPreset, then execute it.

Rules of this type require the presets and allow_list fields specified, and this method ensures this. See Discord Docs/Trigger Metadata.

pub fn with_mention_spam( self, mention_total_limit: u8 ) -> Result<ResponseFuture<AutoModerationRule>, ValidationError>

Create the request with the trigger type MentionSpam, then execute it.

Rules of this type requires the mention_total_limit field specified, and this method ensures this. See Discord Docs/Trigger Metadata.

Errors

Returns an error of type AutoModerationMetadataMentionTotalLimit if the limit is invalid.

Trait Implementations

impl<'a> AuditLogReason<'a> for CreateAutoModerationRule<'a>

fn reason(self, reason: &'a str) -> Result<Self, ValidationError>

Attach an audit log reason to the request.

impl TryIntoRequest for CreateAutoModerationRule<'_>

fn try_into_request(self) -> Result<Request, HttpError>

Try to convert a request builder into a raw Request.