ChainPatrol Discord Bot
If you have a Discord server, you can use the ChainPatrol Discord bot to let your server members submit scam reports to ChainPatrol. The bot will generate new reports that get sent to your admin dashboard for review.

​
Setup

If you have a dedicated scam-reports channel, we recommend pinning a message in this channel and directing your server members to use the bot there for easy reporting

​
Install the bot

To add the bot to your server, you need to be an admin of the server. Then, you can use the following link to add the bot: 🚀 Add ChainPatrol to your server Next, you need to configure the bot to send reports to your admin dashboard on ChainPatrol. Right now, this is can be done by reaching out to us via email and letting us know that you want to add the bot to your server. We will create an organization for you on ChainPatrol and you can then use the /setup connect slash command to link your Discord server to your organization on ChainPatrol. To check that the bot is working, you can use the /setup status command to see if the bot is connected to your ChainPatrol organization.

​
Features

​
Scam Reports

The bot allows server members to submit scam reports directly to ChainPatrol.

​
Usage

Once the bot is added to your server, you can use the following commands:
  • /report <url> - Submit a scam report for the given URL
  • /check <url> - Check if the given URL is a scam

​
Example

Here is an example of how to use the bot to submit a scam report: Example of using the ChainPatrol Discord bot Loading of the ChainPatrol Discord bot Success of the ChainPatrol Discord bot

​
Reports Feed

You can create a feed channel of all reports to your organization. This feature allows you to see all scam reports submitted through the bot in a dedicated channel.

​
Setup

  1. Create a new channel on your Discord server and name it something like chainpatrol-reports
  2. Use the following command to link the channel to your ChainPatrol organization: 
    /setup feed <channel>
  3. Follow the instructions in the bot’s response to link the channel to your ChainPatrol organization
Image showing the Discord bot's response to the setup feed command You can check that the feed is connected correctly by running the /setup status command. If the feed is connected correctly, you should see the channel name in the bot’s response. Image showing the Discord bot's response to the setup status command after setting up the feed As a final test, you can try submitting a test scam report using the /report command. You should see a message in the feed channel with the scam report shortly after submitting. Example of the feed channel ChainPatrol can monitor your Discord channels for suspicious links and automatically take action when they are detected. This feature helps protect your community from scams and malicious content.

​
Setup

To enable link monitoring in a channel:
  1. Navigate to the channel you want to monitor
  2. Run the /setup linkmonitoring command
  3. Confirm the setup when prompted
Only server administrators or users with “Manage Server” permissions can enable link monitoring

​
How it Works

Once enabled, ChainPatrol will:
  1. Monitor all messages in the configured channel for URLs
  2. Check each URL against ChainPatrol’s comprehensive blocklist, which includes:
    • Known scam websites
    • Phishing attempts
    • Malicious domains
    • Other security threats reported to ChainPatrol
  3. Take action based on your server’s configuration when suspicious links are detected
The blocklist is continuously updated with new threats reported by the ChainPatrol community and security researchers. You can search through our blocklist to see what threats we’re protecting against.

​
Response Actions

When a suspicious link is detected, ChainPatrol can be configured to:
  • React with 🚨 - Adds a warning reaction to the message
  • Delete the message - Automatically removes the message
  • Notify moderators - Sends an alert to your moderator channel
The response action is configured by your server administrator through the ChainPatrol dashboard

​
Example

Here’s what happens when a suspicious link is detected: Example of link monitoring in action

​
Common Issues

no-response

​
Custom Elevated Permissions

  • Bot role may need elevated permission to interact with private channels
  • If you are adding the bot to a channel that is not normally visible to @everyone, then you will need to Slash commands not visible to Discord members

    Private Channel Permissions

    Kebab Menu

    Adding ChainPatrol Bot

    Report Modal
  • Embed links permissions are required for your reports feed
    channel embeds
  • Make application commands available to users
    • Server members will not be able to use the ChainPatrol bot commands if they do not have access to application commands
      application commands

​
Debugging Tips

​
View Server As Role

  • You can right click the ChainPatrol role in server settings to see the server as the bot role
    view as role
Trying to access a feature in an inaccessible part of the server will lead to an error. Make sure the bot’s permissions can see and interact with what you are debugging.Check out Discord’s Role Management 101 Article for additional help!

​
Privacy

The bot does not collect any personal information. It only collects the URL and the Discord ID for the user that submitted the report (in case a moderator needs more information about why the URL is a scam). The bot does not store any information about the server it is added to.

​
Source Code

The source code for the bot is available on GitHub: chainpatrol/discord-bot