Discord Bot

Install the ChainPatrol Discord bot to let members report scam URLs, monitor channels for phishing links, and stream blocklist reports to a feed channel.

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:

​

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

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.

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.

​

Link Monitoring

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:

​

Common Issues

​

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

  

  Adding ChainPatrol Bot

  

• Embed links permissions are required for your reports feed

  

• 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
    

​

Debugging Tips

​

View Server As Role

• You can right click the ChainPatrol role in server settings to see the server as the bot 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.

For more information, please read ChainPatrol’s privacy policy.

​

Source Code

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