Files
carlospalanca.es/docs/setup/04-discord.md

126 lines
4.0 KiB
Markdown

# Setup 04 — Discord Apps y Bots
Necesitas crear **9 Discord Applications** separadas (una por agente). Cada una tiene su propio bot token.
## 1. Activar Developer Mode en Discord
1. Abre Discord → **Ajustes** (icono de rueda)
2. **Avanzado** → activa **"Modo desarrollador"**
Esto te permitirá hacer click derecho en canales y copiar sus IDs.
## 2. Crear los 9 canales en tu servidor Discord
Ve a tu servidor → crea estos canales de texto:
| Canal | Agente |
|-------|--------|
| `el-trono-de-hierro` | Tyrion (orquestador) |
| `el-pajarillo` | Varys |
| `la-ciudadela` | Samwell |
| `el-banco-de-hierro` | Bronn |
| `el-muro` | Bran |
| `desembarco-del-rey` | Davos |
| `cara-sin-nombre` | Arya |
| `poniente-en-llamas` | Daenerys |
| `la-guardia-de-la-noche` | Jon |
**Recomendado:** Crea una categoría llamada `LA MANO DEL REY` y agrupa todos los canales ahí.
## 3. Copiar los Channel IDs
Para cada canal:
1. Click derecho en el canal
2. Clic en **"Copiar ID del canal"**
3. Guárdalo — lo necesitarás para el `.env` de los agentes
## 4. Crear las 9 Discord Applications
Repite este proceso 9 veces (una por agente):
### Paso a paso para CADA bot:
1. Ve a [discord.com/developers/applications](https://discord.com/developers/applications)
2. Clic en **"New Application"**
3. Nombre según la tabla:
| Application Name | Variable del token |
|-----------------|-------------------|
| `Tyrion Lannister` | `DISCORD_TOKEN_TYRION` |
| `Varys` | `DISCORD_TOKEN_VARYS` |
| `Samwell Tarly` | `DISCORD_TOKEN_SAMWELL` |
| `Bronn` | `DISCORD_TOKEN_BRONN` |
| `Bran Stark` | `DISCORD_TOKEN_BRAN` |
| `Davos Seaworth` | `DISCORD_TOKEN_DAVOS` |
| `Arya Stark` | `DISCORD_TOKEN_ARYA` |
| `Daenerys Targaryen` | `DISCORD_TOKEN_DAENERYS` |
| `Jon Snow` | `DISCORD_TOKEN_JON` |
4. Acepta los Terms of Service → **"Create"**
5. Ve a la pestaña **"Bot"** (menú izquierdo)
6. Activa los **Privileged Gateway Intents**:
-**Message Content Intent** (OBLIGATORIO)
- Los otros son opcionales
7. Clic en **"Reset Token"** → **"Yes, do it"** → **Copia el token**
> Guárdalo inmediatamente, solo se muestra una vez.
8. Ve a **OAuth2****URL Generator**:
- Scopes: ✅ `bot`
- Bot permissions: ✅ `Read Messages/View Channels`, ✅ `Send Messages`, ✅ `Read Message History`
- Copia la URL generada
9. Abre la URL en el navegador → selecciona tu servidor → **"Autorizar"**
Repite los pasos 2-9 para los 9 agentes.
## 5. Verificar que los bots están en el servidor
En tu servidor Discord, en la lista de miembros o en los canales, deberías ver los 9 bots como miembros (aparecerán como offline hasta que los levantes).
## 6. (Opcional) Personalizar los bots
Para que cada bot tenga avatar y descripción:
1. En la app de Discord Developer → **General Information**
2. Sube una foto de perfil (imagen del personaje de GoT)
3. Añade descripción
## Checklist
- [ ] Developer Mode activado en Discord
- [ ] 9 canales creados en el servidor
- [ ] 9 Channel IDs copiados
- [ ] 9 Discord Applications creadas
- [ ] "Message Content Intent" activado en las 9
- [ ] 9 Bot Tokens copiados
- [ ] Los 9 bots invitados al servidor
## Resumen de variables `.env` de esta fase
```bash
# Tokens (de Discord Developer Portal)
DISCORD_TOKEN_TYRION=<token>
DISCORD_TOKEN_VARYS=<token>
DISCORD_TOKEN_SAMWELL=<token>
DISCORD_TOKEN_BRONN=<token>
DISCORD_TOKEN_BRAN=<token>
DISCORD_TOKEN_DAVOS=<token>
DISCORD_TOKEN_ARYA=<token>
DISCORD_TOKEN_DAENERYS=<token>
DISCORD_TOKEN_JON=<token>
# Channel IDs (click derecho en canal > Copiar ID)
DISCORD_CHANNEL_TRONO=<id> # #el-trono-de-hierro
DISCORD_CHANNEL_VARYS=<id> # #el-pajarillo
DISCORD_CHANNEL_SAMWELL=<id> # #la-ciudadela
DISCORD_CHANNEL_BRONN=<id> # #el-banco-de-hierro
DISCORD_CHANNEL_BRAN=<id> # #el-muro
DISCORD_CHANNEL_DAVOS=<id> # #desembarco-del-rey
DISCORD_CHANNEL_ARYA=<id> # #cara-sin-nombre
DISCORD_CHANNEL_DAENERYS=<id> # #poniente-en-llamas
DISCORD_CHANNEL_JON=<id> # #la-guardia-de-la-noche
```