> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adclear.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord monitoring

> Connect Discord servers, configure Approved Copy, and review flagged affiliate messages in Adclear.

## Overview

Discord monitoring lets Adclear track messages in specific channels within an affiliate's Discord server. Relevant messages are evaluated against your **Approved Copy** library and raised for review when they do not match.

<CardGroup cols={2}>
  <Card title="Real-time monitoring" icon="bolt">
    New messages are evaluated as they are posted. No manual recheck is needed.
  </Card>

  <Card title="Approved Copy library" icon="file-lines">
    Named message templates that pass evaluation automatically when matched.
  </Card>

  <Card title="Affiliate link patterns" icon="link">
    Only messages containing your configured link patterns are evaluated.
  </Card>

  <Card title="Per-affiliate configuration" icon="user-group">
    Configure servers and scope per affiliate in **Monitor Settings**.
  </Card>
</CardGroup>

## Prerequisites

Before configuring Discord monitoring, the Adclear bot must be present in the Discord server you want to monitor.

<Steps>
  <Step title="Invite the Adclear bot">
    Open **Settings → Discord** in your workspace. Use the bot invite link on that page and accept the invite in the target Discord server.
  </Step>

  <Step title="Confirm the bot is active">
    Verify the bot appears in the server's member list before adding the server in Adclear.
  </Step>
</Steps>

<Warning>
  The affiliate or their server administrator must have permission to add bots to the Discord server. Without this, the bot cannot join.
</Warning>

For workspace-level Discord setup steps, see [Settings → Discord](/settings#discord).

## Where to configure Discord

<Tabs>
  <Tab title="Workspace-wide">
    Configure default Discord settings at **Settings → Discord**. This is the starting point for bot connection and workspace-level Approved Copy.
  </Tab>

  <Tab title="Per affiliate">
    Open **Affiliates → \[affiliate] → Monitor Settings → Discord** to add servers, channels, monitored usernames, and affiliate link patterns scoped to that affiliate.
  </Tab>
</Tabs>

Most teams configure the bot at workspace level first, then add per-affiliate server details in **Monitor Settings**.

## Add a Discord server

<Steps>
  <Step title="Open Monitor Settings">
    Navigate to **Affiliates**, open the affiliate, and click **Monitor Settings**. Scroll to the **Discord** section.
  </Step>

  <Step title="Add a server">
    Click **Add server** to open the **Add Discord Server** dialog.
  </Step>

  <Step title="Enter the Guild ID">
    Paste the server's **Guild ID**. Right-click the server in Discord (with Developer Mode enabled) and select **Copy Server ID**. Adclear loads the server name, channels, and members automatically.
  </Step>

  <Step title="Select channels">
    Choose which channels Adclear should watch using the multi-select list. Messages in unselected channels are ignored.
  </Step>

  <Step title="Select monitored usernames">
    Choose which Discord members to track from the member list. You can also add custom usernames manually if a member is not listed.
  </Step>

  <Step title="Add affiliate link patterns">
    Enter one pattern per line. Adclear evaluates messages that contain a matching affiliate link.
  </Step>

  <Step title="Save">
    Click **Add** to save. You should see a confirmation that the server is configured for monitoring.
  </Step>
</Steps>

<Tip>
  Enable **Developer Mode** in Discord (**User Settings → Advanced → Developer Mode**) to copy server and channel IDs.
</Tip>

## Approved Copy library

Approved Copy is a library of pre-approved message templates. When a Discord message matches an entry in your library, Adclear marks it as compliant even if it contains an affiliate link.

<Steps>
  <Step title="Open the Approved Copy section">
    In **Monitor Settings → Discord**, find the **Approved Copy** group.
  </Step>

  <Step title="Add a template">
    Click **Add** and enter the exact approved wording. Give each entry a descriptive name so reviewers can identify which template matched.
  </Step>

  <Step title="Save">
    The library is used for all subsequent message evaluations on that affiliate's configured servers.
  </Step>
</Steps>

<Tip>
  Add your standard launch messages, weekly recap formats, and other templates affiliates reuse. This is the easiest way to reduce false positives.
</Tip>

## How message evaluation works

Once configured, Adclear evaluates messages automatically when all of the following are true:

* The message is in a configured channel.
* The sender is a monitored username.
* The message contains an affiliate link pattern you configured.

If the message matches an **Approved Copy** entry, it is marked **No Issues Found**. If it does not match, it is raised for review in **Monitoring → Discord**.

## Reviewing flagged messages

<Steps>
  <Step title="Open the Discord tab">
    Navigate to **Monitoring** and select the **Discord** tab. Use **Show: Flagged for Review** to focus on items needing attention.
  </Step>

  <Step title="Open a message">
    Click a row to open the message detail view. The posted content appears alongside the Approved Copy it was evaluated against.
  </Step>

  <Step title="Compare and decide">
    Review the difference between what was posted and what was expected.
  </Step>

  <Step title="Record your review decision">
    Use the **Review** actions: **No Issues Found**, **Changes Needed**, **In Review**, or **Escalate**.
  </Step>
</Steps>

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What triggers a Discord message to be reviewed?" icon="circle-question">
    A message is evaluated when it is sent by a monitored username in a configured channel and contains an affiliate link pattern. Messages from other users, in other channels, or without matching link patterns are not evaluated.
  </Accordion>

  <Accordion title="What is the difference between workspace and affiliate Discord settings?" icon="circle-question">
    **Settings → Discord** connects the bot and can hold workspace-wide defaults. **Monitor Settings → Discord** on an affiliate scopes servers, channels, usernames, and link patterns to that specific affiliate.
  </Accordion>

  <Accordion title="Can I edit a server after adding it?" icon="circle-question">
    Yes. Open the server card in **Monitor Settings → Discord** and edit channels, usernames, or link patterns. The dialog title changes to **Edit Discord Server**.
  </Accordion>
</AccordionGroup>

## Next steps

<CardGroup cols={2}>
  <Card title="Affiliate monitoring overview" icon="radar" href="/monitoring/overview">
    The Monitoring inbox, Affiliates hub, and operating cadence.
  </Card>

  <Card title="Workspace Discord settings" icon="gear" href="/settings#discord">
    Bot invite, workspace-level configuration, and Approved Copy.
  </Card>

  <Card title="Social media monitoring" icon="instagram" href="/monitoring/social-media-monitoring">
    Social media post monitoring with relevancy filtering.
  </Card>
</CardGroup>

## Still need help?

Contact support at [support@adclear.ai](mailto:support@adclear.ai).