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

# Utilidades

> Las utilidades reúnen ayuda, latencia, encuestas y recordatorios. Los comandos de prefijo usan el prefijo actual del servidor.

## Ayuda y diagnóstico

`.help` abre el catálogo y `.help <categoría>` va a una categoría; `/help` ofrece el selector slash. Por ejemplo, `.help mod` y `.help snipes` abren secciones conocidas. `.ping` informa la latencia de la conexión con Discord; no diagnostica el proveedor, la base de datos ni los permisos de una función concreta.

> **Help V2**
>
> Explora categorías con el menú y abre enlaces de ayuda. Usa `.help` o `/help`; las secciones dependen del catálogo que Headless tenga registrado.

> **Poll**
>
> Crea encuestas con entre 2 y 9 opciones. La pregunta admite hasta 180 caracteres y cada opción hasta 80; puedes elegir una duración de 10 segundos a 7 días.

> **Remind**
>
> Programa un aviso entre 5 segundos y 7 días. El formato acepta, por ejemplo, `10m`, `2h` o `1d`; la tarea vive en memoria del proceso.

### `.help`

```headless-command Syntax theme={null}
.help [section]
```

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

También funciona: `.help tickets`

### `/help`

```headless-command Syntax theme={null}
/help [section:<section>]
```

```headless-command Example theme={null}
/help
```

### `.ping`

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

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

### `.say`

```headless-command Syntax theme={null}
.say <message>
```

```headless-command Example theme={null}
.say aviso importante
```

> [!WARNING]
>
> No compartas datos personales ni información sensible en una encuesta pública.

## Encuestas y recordatorios

`.poll` (alias `.encuesta`) y `/poll` crean una encuesta con entre 2 y 9 opciones. La pregunta puede tener hasta 180 caracteres y cada opción, hasta 80. El prefijo admite campos separados por `|` o entre comillas; `--time` es opcional y acepta de 10 segundos a 7 días. Sin duración no se programa el cierre automático; con duración, Headless actualiza el resultado cuando vence.

`.remind <duración> [mensaje]` (aliases `.reminder` y `.rm`) acepta de 5 segundos a 7 días; el mensaje predeterminado literal es `Reminder`. Headless confirma la tarea en el canal y, al vencer, intenta enviarla por mensaje privado (DM); si falla, publica el aviso en el canal original.

> [!NOTE]
>
> Los recordatorios no son persistentes: un reinicio antes del vencimiento puede impedir la entrega. Si el DM no se puede enviar, Headless publica un aviso que menciona a la persona en el canal original.

`.say <mensaje>` (alias `.echo`) publica el texto con el bot y requiere `Manage Messages` para quien lo ejecuta. Headless intenta borrar el mensaje de invocación; si Discord lo impide, ese mensaje puede seguir visible.

### `.poll`

```headless-command Syntax theme={null}
.poll [payload]
```

```headless-command Example theme={null}
.poll "¿Evento?" "Sí" "No" --time 10m
```

### `.remind`

```headless-command Syntax theme={null}
.remind <duration> [message=Reminder]
```

```headless-command Example theme={null}
.remind 10m revisar logs
```

## Consultar invitaciones

`/invites list` enumera hasta 20 invitaciones activas, ordenadas por usos, e incluye código, usos, creador y canal. `/invites info code:<código>` muestra esos datos, el máximo de usos, el vencimiento y si la invitación es temporal. Solo consulta invitaciones activas: no crea ni modifica invitaciones. Si el código ya no está activo, el comando informa que no lo encontró.

Discord marca ambos comandos con `Manage Server` como permiso predeterminado para quien los ejecuta. Headless también necesita `Manage Server` para consultar las invitaciones del servidor; si Discord rechaza la solicitud, el comando devuelve un error en vez de una lista parcial.

```headless-command Syntax theme={null}
/invites list
```

```headless-command Example theme={null}
/invites list
```

```headless-command Syntax theme={null}
/invites info code:<code>
```

```headless-command Example theme={null}
/invites info
```

## Ayuda para configurar

Las utilidades no reemplazan las páginas de configuración: revisa los permisos y riesgos del módulo antes de ejecutar setup o acciones de moderación.

## Pasos

**1. Encuentra el comando**

Usa `.help` o una categoría, y confirma la sintaxis en la guía enlazada.

**2. Prueba con un ejemplo simple**

Usa una pregunta corta o un recordatorio no sensible.

**3. Comprueba la entrega**

Verifica la respuesta del bot y, para recordatorios, que el DM pueda recibirse.

## Páginas relacionadas

* [Primeros pasos](/docs/getting-started.md)
* [Permisos](/docs/permissions.md)
* [Tickets](/docs/server/tickets.md)


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