> ## 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.

# Preguntas frecuentes

> Esta guía combina respuestas prácticas con diferencias de Headless. No presume que los motivos o soluciones de otro bot apliquen aquí.

## Un flag no funciona en iOS

Si el comando usa flags y el texto cambió de `--` a un guion largo `—`, desactiva Smart Punctuation en iOS o reemplaza manualmente el carácter por dos guiones ASCII. Solo los comandos que documentan flags las aceptan.

## Un miembro puede escribir después de mute

Headless configura roles de mute, pero Discord combina permisos del servidor y sobrescrituras de canal. Revisa `@everyone`, roles de miembro, excepciones del canal y la jerarquía/permiso Manage Roles del bot; consulta Moderation Setup para los roles preparados por `.setupmute`.

## Headless no aparece o salió del servidor

La documentación no confirma una política de salida por inactividad. Revisa el audit log de Discord, quién removió al bot, errores de servicio y estado del bot. No uses el motivo de otro producto como explicación de una salida de Headless.

## Una acción de voz falla

Para crear salas Headless VC necesita Manage Channels y Move Members; las sobrescrituras de canal y la jerarquía también aplican. Ejecuta `.privatevc panel` para revisar la configuración.

## Configuración

> **¿Cómo invito Headless a mi servidor?**
>
> Usa la página oficial para iniciar la instalación. Discord muestra los permisos solicitados antes de confirmar.
>
> [Página oficial](https://headlesslabs.xyz/)

## Comandos

> **¿Cuál es el prefijo de los comandos?**
>
> Los ejemplos públicos usan `.`. Cada servidor puede conservar un prefijo personalizado; los comandos slash están disponibles cuando se registran.

> **¿Dónde encuentro los comandos y sus ejemplos?**
>
> La página Commands usa el registro público que publica el bot. En Discord, consulta una categoría con `.help [section]` o `/help`. Si el servicio no está disponible, no se completa con ejemplos desactualizados.
>
> [Abrir Commands](https://headlesslabs.xyz/commands/)

## Dashboard

> **¿Qué puedo administrar desde la Dashboard?**
>
> Discord OAuth identifica tu cuenta y el servidor; cada operación vuelve a validar tus permisos. La web solo muestra o modifica módulos autorizados para la cuenta y el servidor seleccionado.
>
> [Abrir Dashboard](https://headlesslabs.xyz/dashboard/)

## Seguridad

> **¿Tener Administrator hace que alguien sea de confianza en Anti-Nuke?**
>
> No. Headless separa los permisos nativos de Discord de las capacidades y excepciones de Anti-Nuke. Configúralas de forma explícita.
>
> [Leer Anti-Nuke](/docs/security/anti-nuke.md)

> **¿Smart Setup cambia la configuración inmediatamente?**
>
> No. Recommend es de solo lectura; Setup primero genera una vista previa. Los cambios solo se aplican después de que el owner revisa y confirma esa vista previa.
>
> [Ver configuración de Anti-Nuke](/docs/security/anti-nuke.md)

## Pasos

**1. Copia el mensaje de error**

Anota el servidor, canal, comando y hora sin publicar tokens ni datos privados.

**2. Comprueba el ámbito**

Distingue autorización del usuario, permisos del bot y sobrescrituras de Discord.

**3. Usa diagnóstico seguro**

Prueba los comandos de estado/diagnóstico disponibles antes de repetir una acción que borra o sanciona.

> [!WARNING]
>
> No repitas un comando destructivo o una sanción como método de diagnóstico. Para una salida del servidor, verifica primero el audit log; esta guía no conoce la causa sin esos datos.

## Páginas relacionadas

* [Permisos](/docs/permissions.md)
* [Moderación setup](/docs/security/moderation.md)
* [Headless VC](/docs/voice/overview.md)


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