feat: forward important events to alerts channel

Author: lcook

config.yaml.example

@@ -21,6 +21,11 @@ bot:
   # Channel where audit events (message edits, deletes, AutoMod actions, etc)
   # are posted.
   discord_log_channel_id: ""
+  # (Optional) Channel where important events are forwarded to, and if configured
+  # pings the configured moderator role.
+  discord_alert_channel_id: ""
+  # (Optional) Role ID of moderators.
+  discord_mod_role_id: ""
   # Populate the below with the provided URL when setting up a new webhook inside
   # of Discord.  This is where we forward GitHub commit events to.
   #

internal/bot/handler/event/automod.go

@@ -23,27 +23,32 @@ func (h *Handler) AutoModExecution(
 		return
 	}
 
-	s.ChannelMessageSendEmbed(h.Settings.LogChannel, &discordgo.MessageEmbed{
-		Title: ":shield: AutoMod alert",
-		Description: fmt.Sprintf(
-			"Message sent by <@!%s> in <#%s> flagged by AutoMod. _Please exercise caution: these messages may contain malicious links, phishing attempts, or other harmful content_.",
-			user.ID,
-			am.ChannelID,
-		),
-		Timestamp: time.Now().Format(time.RFC3339),
-		Color:     embedDeleteColor,
-		Footer: &discordgo.MessageEmbedFooter{
-			Text: fmt.Sprintf("Rule: %s", am.RuleID),
-		},
-		Author: &discordgo.MessageEmbedAuthor{
-			Name:    user.Username,
-			IconURL: user.AvatarURL("256"),
-		},
-		Fields: []*discordgo.MessageEmbedField{
-			{
-				Name:  "Contents",
-				Value: truncateContent(am.Content),
+	message, _ := s.ChannelMessageSendEmbed(
+		h.Settings.LogChannel,
+		&discordgo.MessageEmbed{
+			Title: ":shield: AutoMod alert",
+			Description: fmt.Sprintf(
+				"Message sent by <@!%s> in <#%s> flagged by AutoMod. _Please exercise caution: these messages may contain malicious links, phishing attempts, or other harmful content_.",
+				user.ID,
+				am.ChannelID,
+			),
+			Timestamp: time.Now().Format(time.RFC3339),
+			Color:     embedDeleteColor,
+			Footer: &discordgo.MessageEmbedFooter{
+				Text: fmt.Sprintf("Rule: %s", am.RuleID),
+			},
+			Author: &discordgo.MessageEmbedAuthor{
+				Name:    user.Username,
+				IconURL: user.AvatarURL("256"),
+			},
+			Fields: []*discordgo.MessageEmbedField{
+				{
+					Name:  "Contents",
+					Value: truncateContent(am.Content),
+				},
 			},
 		},
-	})
+	)
+
+	h.ForwardAlert(s, message, false)
 }

internal/bot/handler/event/event.go

@@ -102,7 +102,7 @@ func (h *Handler) ProcessSpam(
 
 	if deleted > 1 &&
 		canViewChannel(session, message.GuildID, message.ChannelID) {
-		session.ChannelMessageSendEmbed(
+		message, _ := session.ChannelMessageSendEmbed(
 			h.Settings.LogChannel,
 			&discordgo.MessageEmbed{
 				Title: ":shield: Anti-spam alert",
@@ -129,5 +129,28 @@ func (h *Handler) ProcessSpam(
 				Fields: fields,
 			},
 		)
+
+		h.ForwardAlert(session, message, true)
+	}
+}
+
+func (h *Handler) ForwardAlert(
+	session *discordgo.Session,
+	message *discordgo.Message,
+	ping bool,
+) {
+	if h.Settings.AlertChannel != "" {
+		session.ChannelMessageSendReply(
+			h.Settings.AlertChannel,
+			"",
+			message.Forward(),
+		)
+
+		if ping && h.Settings.ModRole != "" {
+			session.ChannelMessageSend(
+				h.Settings.AlertChannel,
+				fmt.Sprintf("<@&%s>", h.Settings.ModRole),
+			)
+		}
 	}
 }

internal/bot/handler/event/member_add.go

@@ -28,7 +28,7 @@ func (h *Handler) GuildMemberAdd(
 	age := m.JoinedAt.UTC().Sub(created.UTC())
 
 	if age <= h.Settings.MinumumAccountAge {
-		s.ChannelMessageSendEmbed(
+		message, _ := s.ChannelMessageSendEmbed(
 			h.Settings.LogChannel,
 			&discordgo.MessageEmbed{
 				Title: ":shield: Suspected spam or advertising account",
@@ -54,5 +54,7 @@ func (h *Handler) GuildMemberAdd(
 				},
 			},
 		)
+
+		h.ForwardAlert(s, message, false)
 	}
 }

internal/bot/handler/event/member_remove.go

@@ -55,7 +55,7 @@ func (h *Handler) GuildMemberRemove(
 	}
 
 	if action != "" {
-		s.ChannelMessageSendEmbed(
+		message, _ := s.ChannelMessageSendEmbed(
 			h.Settings.LogChannel,
 			&discordgo.MessageEmbed{
 				Description: fmt.Sprintf(
@@ -75,5 +75,7 @@ func (h *Handler) GuildMemberRemove(
 				Fields: fields,
 			},
 		)
+
+		h.ForwardAlert(s, message, false)
 	}
 }

internal/config/config_settings.go

@@ -10,10 +10,12 @@ import (
 )
 
 type BotSettings struct {
-	Token      string   `yaml:"discord_token"`
-	Prefix     string   `yaml:"discord_prefix"`
-	Commands   []string `yaml:"discord_commands"`
-	LogChannel string   `yaml:"discord_log_channel_id"`
+	Token        string   `yaml:"discord_token"`
+	Prefix       string   `yaml:"discord_prefix"`
+	Commands     []string `yaml:"discord_commands"`
+	LogChannel   string   `yaml:"discord_log_channel_id"`
+	AlertChannel string   `yaml:"discord_alert_channel_id"`
+	ModRole      string   `yaml:"discord_mod_role_id"`
 
 	GithubWebhookID    string `yaml:"discord_github_webhook_id"`
 	GithubWebhookToken string `yaml:"discord_github_webhook_token"`