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

# Bot de Discord

> Instala el bot de Discord de ChainPatrol para permitir que los miembros reporten URLs de estafas, monitorear canales en busca de enlaces de phishing y transmitir los reportes de la blocklist a un canal de feed.

![Bot de Discord de ChainPatrol](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=df1671dc5db3e588cf0db4592e0a2e84)

Si tienes un **servidor de Discord**, puedes usar el [bot de Discord de ChainPatrol](https://chainpatrol.com/bot)
para que los miembros de tu servidor envíen reportes de estafas a **ChainPatrol**. El bot generará nuevos
reportes que se envían a tu **Dashboard** (panel principal) de administración para su revisión.

## Configuración

> [!TIP]
>
> Si tienes un canal dedicado `scam-reports`, te recomendamos fijar un mensaje
> en ese canal e indicar a los miembros de tu servidor que usen el bot allí para
> reportar fácilmente

### Instalar el bot

Para agregar el bot a tu servidor, necesitas ser administrador del servidor. Luego,
puedes usar el siguiente enlace para agregar el bot:

[🚀 Agrega ChainPatrol a tu servidor](https://chainpatrol.com/bot/install)

A continuación, conecta tu servidor de Discord con tu organización de ChainPatrol para que los reportes lleguen a tu dashboard. Necesitas ser **Owner** o **Admin** de la organización.

1. En el [dashboard de ChainPatrol](https://app.chainpatrol.io/admin), ve a **Settings → Integrations → Discord** (configuración → integraciones → Discord) y haz clic en **Add to Discord**.
2. Discord te pide que elijas tu servidor y apruebes el bot.
3. Discord te envía de vuelta a la página **Connect Discord** de ChainPatrol. Elige tu organización y haz clic en **Connect**.

Cada organización puede conectarse a un solo servidor de Discord, y cada servidor a una sola organización.

Para comprobar que el bot funciona, puedes usar el comando `/setup status` para ver si el bot está
conectado a tu organización de ChainPatrol.

## Funciones

### Reportes de estafas

El bot permite que los miembros del servidor envíen reportes de estafas directamente a ChainPatrol.

#### Uso

Una vez que el bot esté agregado a tu servidor, puedes usar los siguientes comandos:

* `/report <url>` - Envía un reporte de estafa para la URL indicada
* `/check <url>` - Comprueba si la URL indicada es una estafa

#### Ejemplo

Este es un ejemplo de cómo usar el bot para enviar un reporte de estafa:

![Ejemplo de uso del bot de Discord de ChainPatrol](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-prompt.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=e947b9db720da0f67d9081859fd4c336)

![Carga del bot de Discord de ChainPatrol](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-loading.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=3c69765f3020a443dbd5ca87cdcf2110)

![Resultado exitoso del bot de Discord de ChainPatrol](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-success.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=30717276da4f54c61e38a94e0760e0fb)

### Feed de reportes

Puedes crear un canal de feed con todos los reportes enviados a tu organización. Esta función te permite ver en un canal dedicado todos los reportes de estafas enviados a través del bot.

#### Configuración

1. Crea un canal nuevo en tu servidor de Discord y ponle un nombre como `chainpatrol-reports`
2. Usa el siguiente comando para vincular el canal con tu organización de ChainPatrol:
   ```
   /setup feed <channel>
   ```
3. Sigue las instrucciones de la respuesta del bot para vincular el canal con tu organización de ChainPatrol

![Imagen que muestra la respuesta del bot de Discord al comando setup feed](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-feed-setup.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=81717be0fe88c5bd82f58f0bcfe43703)

Puedes comprobar que el feed está conectado correctamente ejecutando el comando `/setup status`. Si el
feed está conectado correctamente, deberías ver el nombre del canal en la respuesta del bot.

![Imagen que muestra la respuesta del bot de Discord al comando setup status después de configurar el feed](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-feed-status.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=7cb2b729bdc0778a0d4ce564160fbde9)

Como prueba final, puedes intentar enviar un reporte de estafa de prueba con el comando `/report`. Deberías ver un mensaje
en el canal de feed con el reporte de estafa poco después de enviarlo.

![Ejemplo del canal de feed](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-feed.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=dbcc2b4c0dbe3e7f59b86a5f6b07bfad)

### Monitoreo de enlaces

ChainPatrol puede monitorear tus canales de Discord en busca de enlaces sospechosos y tomar medidas automáticamente cuando los detecta. Esta función ayuda a proteger a tu comunidad de estafas y contenido malicioso.

#### Configuración

Para habilitar el monitoreo de enlaces en un canal:

1. Ve al canal que quieres monitorear
2. Ejecuta el comando `/setup linkmonitoring`
3. Confirma la configuración cuando se te pida

> [!TIP]
>
> Solo los administradores del servidor o los usuarios con el permiso "Manage Server"
> (gestionar servidor) pueden habilitar el monitoreo de enlaces

#### Cómo funciona

Una vez habilitado, ChainPatrol hará lo siguiente:

1. Monitorear todos los mensajes del canal configurado en busca de URLs
2. Comprobar cada URL contra la amplia **Blocklist** (lista de bloqueo) de ChainPatrol, que incluye:
   * Sitios web de estafas conocidos
   * Intentos de phishing
   * Dominios maliciosos
   * Otras amenazas de seguridad reportadas a ChainPatrol
3. Tomar medidas según la configuración de tu servidor cuando se detecten enlaces sospechosos

> [!TIP]
>
> La blocklist se actualiza continuamente con nuevas amenazas reportadas por la
> comunidad de ChainPatrol y por investigadores de seguridad. Puedes [buscar en nuestra
> blocklist](https://app.chainpatrol.io/search) para ver de qué amenazas te estamos
> protegiendo.

#### Acciones de respuesta

Cuando se detecta un enlace sospechoso, ChainPatrol se puede configurar para:

* **Reaccionar con 🚨** - Agrega una reacción de advertencia al mensaje
* **Eliminar el mensaje** - Quita el mensaje automáticamente
* **Notificar a los moderadores** - Envía una alerta a tu canal de moderadores

> [!TIP]
>
> La acción de respuesta la configura el administrador de tu servidor desde el
> dashboard de ChainPatrol

#### Ejemplo

Esto es lo que ocurre cuando se detecta un enlace sospechoso:

![Ejemplo del monitoreo de enlaces en acción](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-bot-link-monitoring.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=e9fd55c453a0984c1875b2f7093dcad7)

## Problemas comunes

![sin respuesta](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-application-no-response.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=7777d495b36f0d2100043ffeaf3db253)

### Permisos elevados personalizados

* Es posible que el rol del bot necesite permisos elevados para interactuar con canales privados

* Si vas a agregar el bot a un canal que normalmente no es visible para `@everyone`, entonces tendrás que
  Comandos de barra no visibles para los miembros de Discord

  > [card] Permisos de canal privado
  >
  > ![Menú kebab](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-private-channel.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=499d05bdb2f27a329f156667e938a295)

  > [card] Agregar el bot de ChainPatrol
  >
  > ![Modal de reporte](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-select-app.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=13bee28361e013942d5eca03617c5969)

* Se requieren permisos para insertar enlaces (embed links) para tu feed de reportes

  ![inserciones del canal](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-channel-embed-links.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=817e48a07dad269ea5088eae709b44a4)

* Haz que los comandos de aplicación estén disponibles para los usuarios
  * Los miembros del servidor no podrán usar los comandos del bot de ChainPatrol si no tienen acceso a los comandos de aplicación

    ![comandos de aplicación](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-application-comands.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=54436a850d36253bd49875a3df86c6b6)

## Consejos de depuración

### Ver el servidor como un rol

* Puedes hacer clic derecho en el rol de ChainPatrol en la configuración del servidor para ver el servidor como el rol del bot

  ![ver como rol](https://mintcdn.com/chainpatrol/oLEHOzLMXL0CWKrg/images/discord-view-as-role.png?fit=max\&auto=format\&n=oLEHOzLMXL0CWKrg\&q=85\&s=57cec3d4a92e1ce205b127558fb5ce7a)

> [!TIP]
>
> Intentar acceder a una función en una parte inaccesible del servidor provocará
> un error. Asegúrate de que los permisos del bot le permitan ver e interactuar con lo que
> estás depurando.
>
> ¡Consulta el artículo [Role Management 101 de Discord](https://support.discord.com/hc/en-us/articles/214836687-Role-Management-101) para obtener más ayuda!

## Privacidad

El bot no recopila ninguna información personal. Solo recopila la URL y
el ID de Discord del usuario que envió el reporte (por si un moderador necesita
más información sobre por qué la URL es una estafa).

Por cada servidor conectado, ChainPatrol almacena el ID del servidor y la configuración del bot para ese servidor: los
canales que monitorea u omite, los roles de moderador, los nombres de usuario y el canal a los que notifica, y el
canal donde publica los reportes.

Para más información, lee la [política de privacidad](https://chainpatrol.com/legal/privacy) de ChainPatrol.

## Código fuente

El código fuente del bot está disponible en GitHub:
[chainpatrol/discord-bot](https://github.com/chainPatrol/discord-bot)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.