# Auto Role

### ¿Qué es AutoRole?

AutoRole es un sistema que **asigna automáticamente un rol a cada miembro nuevo** que se une a tu servidor. Perfecto para dar bienvenida y categorizar miembros.

#### Casos de Uso

* ✅ Dar acceso a canales automáticamente
* ✅ Identificar miembros nuevos
* ✅ Aplicar roles por defecto a todos
* ✅ Facilitar la integración de nuevos miembros

***

### 🚀 Configuración Básica (Para Usuarios Nuevos)

#### Paso 1: Preparar el Rol

1. Abre Configuración del Servidor → Roles
2. Crea un nuevo rol (ej: "Miembro")
3. **Nota:** El rol debe estar **por debajo** del rol del bot en la jerarquía

#### Paso 2: Activar AutoRole

Usa este comando:

```
/autorole setup @rol:Miembro
```

**Explicación:**

* `/autorole` = comando principal
* `setup` = activar la función
* `@rol:Miembro` = el rol que se asignará

#### Paso 3: ¡Listo!

Ahora cada miembro nuevo recibirá automáticamente el rol "Miembro"

#### Desactivar (si lo necesitas)

```
/autorole disable
```

***

### ⚙️ Opciones Avanzadas

#### Información Técnica

```
Rol asignado: El que especifiques
Tiempo de asignación: Inmediato al unirse
Requiere permisos: Gestionar Roles
```

#### Limitaciones & Consideraciones

⚠️ **Importante:**

* El rol debe estar **más abajo** en la jerarquía que el rol del bot
* No puedes asignar roles de **Booster** o **Integración**
* Si el bot no tiene permisos, el rol no se asignará

***

### 🔍 Solución de Problemas

| Problema                | Solución                                        |
| ----------------------- | ----------------------------------------------- |
| **No se asigna el rol** | Verifica que el rol está debajo del rol del bot |
| **Permiso denegado**    | Asegúrate que el bot tiene "Gestionar Roles"    |
| **El rol desaparece**   | Es un rol especial (Booster/Bot)                |

***

### 📝 Ejemplo Práctico

**Escenario:** Quieres que todos los nuevos miembros tengan acceso a #general

1. Crea rol: "Acceso Inicial"
2. Asigna permisos al rol para ver #general
3. Usa: `/autorole setup @Acceso Inicial`
4. ¡Listo! Nuevos miembros verán #general automáticamente

***

### 🎯 Combina con Otros Sistemas

* **+ Bienvenidas:** Envía mensaje + asigna rol
* **+ Logs:** Registra quién recibió el rol
* **+ Verify:** Asigna rol solo después de verificación

***

### 📞 ¿Problemas?

Si algo no funciona:

1. Asegúrate que el bot tiene permisos de **Administrador**
2. Verifica la **jerarquía de roles** (bot debe estar más arriba)
3. Revisa que el rol **no sea especial** (Booster, Bot, etc.)
4. Pide ayuda en nuestro [servidor de soporte](https://discord.gg/2ZKdT6SRsZ)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://okaa.gitbook.io/okaa-wiki/configuracion/auto-role.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.