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

# Respuestas automáticas

> Auto Responder guarda reglas por servidor y responde al primer trigger habilitado que coincida con un mensaje. Puedes elegir coincidencia exacta o parcial, limitar la regla por canal y rol, y enviar texto o un embed script.

## Acceso y configuración

Configurar reglas requiere **Manage Server** (`manage_guild=True`). Los comandos de prefijo aceptan el permiso nativo de Discord o un permiso equivalente concedido mediante **Fake Permissions** de Headless; los slash requieren **Manage Server nativo**, porque su comprobación interna no acepta el permiso virtual. Los comandos slash contestan de forma efímera. La configuración está aislada por servidor y se guarda en el almacén de Auto Responder.

`.ar reset confirmar` y `/autoresponder reset confirmar:true` eliminan todas las reglas del servidor. El slash pide confirmación booleana; si la respuesta es falsa, no hace cambios.

### `.autoresponder list`

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

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

### `.autoresponder toggle`

```headless-command Syntax theme={null}
.autoresponder toggle [state]
```

```headless-command Example theme={null}
.ar toggle off
```

### `.autoresponder reset`

```headless-command Syntax theme={null}
.autoresponder reset [confirmacion]
```

```headless-command Example theme={null}
.ar reset confirmar
```

> [!WARNING]
>
> reset borra todas las reglas del servidor. --delete intenta borrar el mensaje disparador y necesita Manage Messages del bot; si Discord rechaza el borrado, la respuesta aún puede publicarse sin reply.

**Nota:**

La configuración y el cooldown están aislados por servidor; una regla de una comunidad no se aplica a otra. El estado se guarda en el almacén existente de Auto Responder.

## Coincidencia y límites

La coincidencia predeterminada es exacta, no distingue mayúsculas y normaliza espacios consecutivos. `--not_strict` cambia a contiene; `--strict` vuelve a coincidencia exacta. Los triggers de mención de usuario pueden coincidir aunque aparezcan junto a otro texto. Hay hasta 100 reglas por servidor; cada trigger admite 160 caracteres y cada respuesta 1900.

## Filtros de canal y rol

Una lista de canales no vacía limita la regla a esos canales; una lista de roles no vacía permite activarla si el autor tiene al menos uno de esos roles. Si configuras ambos filtros, deben cumplirse los dos. Cada regla guarda hasta 25 canales y 25 roles. Ejecuta channel o role otra vez para quitar ese canal o rol del filtro.

### `.autoresponder channel`

```headless-command Syntax theme={null}
.autoresponder channel <rule_ref> <channel>
```

```headless-command Example theme={null}
.ar channel 1 #ayuda
```

### `.autoresponder role`

```headless-command Syntax theme={null}
.autoresponder role <rule_ref> <role>
```

```headless-command Example theme={null}
.ar role 1 @Miembros
```

## Entrega y seguridad

El bot ignora autores bot y mensajes vacíos. Los comandos válidos no activan reglas por defecto; la opción `ignorar_comandos` del slash o el flag `--ignore_command_check` permite incluirlos. Solo responde una regla por mensaje. Hay un cooldown de tres segundos por miembro y regla. Las menciones permitidas se limitan a ninguna: Headless desactiva pings de usuarios, roles, `@everyone` y `@here`. Comprueba que el bot pueda ver el canal, leer el historial y enviar mensajes (también en hilos cuando corresponda).

## Flags y edición parcial

En el comando de prefijo, `--reply` conserva la respuesta directa, `--no_reply` publica en el canal, `--delete` intenta borrar el mensaje disparador y publica la respuesta sin reply, y `--self_destruct N` acepta 0 a 60: 0 desactiva el borrado y los valores positivos válidos son de 6 a 60 segundos. `--not_strict` y `--strict` eligen la coincidencia. Los flags desconocidos generan un error. En `update`, solo modifica los flags que incluyes; omite los demás para conservar sus ajustes actuales. El slash `update` tiene campos opcionales para conservar igualmente las opciones que no cambies.

### `.autoresponder add — 1`

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

```headless-command Example theme={null}
.ar add hola, Hola {author.name}
```

También funciona: `.ar add soporte, {embed}$v{title:Soporte}$v{description:Abre un ticket} --not_strict --reply` · `.ar add reglas, Consulta #normas --no_reply`

### `/autoresponder add`

```headless-command Syntax theme={null}
/autoresponder add trigger:<trigger> response:<response> [match_mode:<match_mode>] [reply:<reply>] [delete_trigger:<delete_trigger>] [self_destruct:<self_destruct>] [ignore_commands:<ignore_commands>]
```

```headless-command Example theme={null}
/autoresponder add trigger:hola response:Hola
```

### `.autoresponder add — 2`

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

```headless-command Example theme={null}
.ar add spam, Mensaje eliminado --delete --self_destruct 10
```

### `.autoresponder update`

```headless-command Syntax theme={null}
.autoresponder update [rule_ref] [payload]
```

```headless-command Example theme={null}
.ar update 1 hola, Hola de nuevo
```

## Texto y scripts

Separa trigger y respuesta con la primera coma; el resto de la línea permanece en la respuesta. Se aceptan variables del contexto del mensaje y el parser de embed. Un trigger duplicado no crea una segunda regla: edita la existente con update. `--delete` necesita **Manage Messages** para el bot; si Discord rechaza el borrado, la respuesta todavía puede enviarse, pero sin reply al mensaje original.

## Pasos

**1. Crea una regla de prueba**

Usa un trigger corto en un canal privado de prueba y una respuesta sin menciones.

**2. Ajusta coincidencia y filtros**

Elige exacta o parcial y aplica filtros de canal/rol solo cuando el alcance lo requiera.

**3. Verifica el resultado**

Usa list, prueba el texto exacto y parcial y confirma que los mensajes de otros canales o roles no activen la regla.

> **Comandos de prefijo**
>
> Grupo y alias: `.autoresponder`, `.autorespond`, `.respuestaauto` y `.ar`. Subcomandos: `.ar` (estado); `.ar add <disparador>, <respuesta> [--not_strict] [--strict] [--reply] [--no_reply] [--delete] [--keep_trigger] [--ignore_command_check] [--check_commands] [--self_destruct <0|6-60>]`; `.ar update <id> <disparador>, <respuesta> [las mismas opciones]`; `.ar remove <id|disparador>`; `.ar list`; `.ar toggle <on|off>`; `.ar reset <confirmar>`; `.ar channel <id> <#canal>`; `.ar role <id> <@rol>`. `channel` y `role` alternan entre limitar a ese destino y quitarlo del filtro. `reset` requiere confirmar explícitamente; `--self_destruct 0` desactiva la autodestrucción y `1–5` no son valores válidos.

> **Comandos slash**
>
> El grupo /autoresponder expone add, remove, update, list, toggle, reset, channel y role. Las acciones de configuración requieren Manage Server y responden de forma efímera. add y update ofrecen coincidencia exacta/contiene, reply, borrar\_trigger, autodestruir y la opción ignorar\_comandos; update conserva los campos opcionales que dejes sin cambiar.

> **Evita reglas ambiguas**
>
> La guía original recomienda elegir una frase concreta, decidir si debe coincidir el mensaje completo o si basta con encontrar el trigger dentro del mensaje y probar que no responda a texto no relacionado.

## Sintaxis y ejemplos

#### `.autoresponder add`

## Páginas relacionadas

* [Scripting de embeds](/docs/resources/scripting/embeds.md)
* [Variables](/docs/resources/scripting/variables.md)
* [Mensajes](/docs/server/messages.md)


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