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

# Permisos y acceso

> Los permisos de Headless se comprueban por comando y por acción. Tener permiso para configurar una función no otorga permisos al bot ni cambia las sobrescrituras de Discord.

## Permiso del usuario

Cada comando indica el requisito aplicable: por ejemplo, `.vanity` pide Administrator, `.alias` pide Manage Server, `.afklist` pide Manage Messages y `.privatevc lobby` pide Manage Channels. Las verificaciones se hacen en el servidor y pueden variar entre subcomandos.

### Ejemplos de permisos del actor

```headless-command Syntax theme={null}
.vanity action <action>
```

```headless-command Example theme={null}
.vanity action log
```

```headless-command Syntax theme={null}
.alias list
```

```headless-command Example theme={null}
.alias list
```

```headless-command Syntax theme={null}
.afklist
```

```headless-command Example theme={null}
.afklist
```

## Permisos del bot y jerarquía

Además de la autorización del usuario, Headless necesita los permisos nativos requeridos por la acción. Para crear o modificar canales revisa Manage Channels; para roles, Manage Roles y la jerarquía del rol del bot; para voz, Move Members cuando corresponda. Un comando autorizado puede fallar si Discord bloquea la acción.

### Cambios de canales

```headless-command Syntax theme={null}
.privatevc lobby <channel>
```

```headless-command Example theme={null}
.privatevc lobby #Crear-VC
```

## Permisos virtuales

Fake Permissions es un sistema separado y limitado. No modifica los permisos de Discord; solo añade un contexto virtual para las comprobaciones de Headless. Solo el propietario del servidor o el owner de Headless puede gestionarlo; la clave virtual `administrator` amplía mucho el acceso.

### Consultar permisos virtuales

```headless-command Syntax theme={null}
.fakepermissions list [role]
```

```headless-command Example theme={null}
.fakepermissions list
```

## Pasos

**1. Lee el requisito del comando**

Abre la guía de la función y comprueba el permiso de Discord del actor y los permisos del bot.

**2. Verifica rol y canal**

Revisa la jerarquía del bot y las sobrescrituras del canal objetivo.

**3. Prueba con alcance mínimo**

Ensaya con un canal y miembro de prueba antes de conceder permisos más amplios.

## Acceso, configuración y soporte

> **[1. Acceso con Discord](/docs/dashboard.md)**
>
> OAuth2 identifica al operador y muestra los servidores donde su cuenta tiene autorización. Ser miembro no basta; la autorización del servidor se vuelve a comprobar para las acciones sensibles.

> **[2. Configuración por servidor](/docs/dashboard.md)**
>
> Los módulos mantienen sus propios ajustes. Los canales, roles y otros valores se validan para el servidor seleccionado, y el permiso requerido puede variar entre funciones.

> **[3. Mantenimiento](/docs/dashboard.md)**
>
> La vista de servidor expone estado de salud, actividad reciente y último sync para ayudar a localizar permisos faltantes o una configuración que aún no se haya sincronizado.

> **[4. Cambios seguros](/docs/dashboard.md)**
>
> La API vuelve a validar el acceso antes de aceptar cambios; algunas acciones muestran una vista previa antes de confirmarse. Los backups no son una opción del Dashboard público y no deben darse por disponibles desde esta guía.

> **[5. Soporte](/docs/common-issues.md)**
>
> Usa soporte cuando el problema requiera revisar permisos del bot, una integración o una incidencia. Nunca envíes tokens, contraseñas ni secretos de webhook.

> [!WARNING]
>
> No concedas Administrator al bot para resolver un error aislado. Los permisos virtuales de Headless no sustituyen el control de acceso nativo de Discord.

## Páginas relacionadas

* [Fake Permissions](/docs/security/fake-permissions.md)
* [Moderation setup](/docs/security/moderation.md)
* [Voice permissions](/docs/voice/permissions.md)


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