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

# Bienvenidas

> Welcome publica un saludo cuando entra un miembro al servidor. Configura el canal, el formato y el contenido, revisa la vista previa y activa el módulo cuando el bot tenga los permisos necesarios.

## Permisos y activación

Los subcomandos de prefijo requieren Administrator y solo funcionan dentro de un servidor. El bot necesita ver y enviar mensajes en el canal; en formato embed también necesita **Embed Links** (Insertar enlaces). `set-channel` comprueba esos permisos y `on` no activa el módulo si falta el canal o un permiso. El evento de entrada admite nuevos miembros, incluidas cuentas bot; si `Join Gate` mantiene activo el estado de raid, la entrega de bienvenidas se pausa. El filtro de bots usado por los logs de entrada no desactiva por sí mismo las bienvenidas.

Hay dos controles de activación: `.welcome on` activa el módulo maestro después de validar el canal; `.welcome off` cambia el indicador heredado `welcome.enabled`, pero no cambia ese interruptor maestro (`modules.welcome`). Como la entrega consulta el interruptor del módulo, `.welcome off` por sí solo no garantiza que las bienvenidas se detengan. Para pausarlas realmente, desactiva Welcome en el Dashboard o usa `/welcome enabled:false`, que actualiza ambos controles.

> [!NOTE]
>
> `.welcome off` solo cambia el indicador heredado; no desactiva `modules.welcome`. Para pausar las entregas usa el Dashboard o `/welcome enabled:false`. Los saludos predeterminados nuevos están en inglés. Al leer la configuración, Headless traduce únicamente los textos predeterminados antiguos que coinciden exactamente; el contenido personalizado de cada servidor, incluido el español, se conserva.

### `.welcome set-channel`

```headless-command Syntax theme={null}
.welcome set-channel <channel>
```

```headless-command Example theme={null}
.welcome set-channel #bienvenida
```

### `.welcome on`

```headless-command Syntax theme={null}
.welcome on
```

```headless-command Example theme={null}
.welcome on
```

### `.welcome`

```headless-command Syntax theme={null}
/welcome [channel:<channel>] [enabled:<enabled>]
```

```headless-command Example theme={null}
/welcome channel:#bienvenida enabled:true
```

**Nota:**

Welcome conserva una sola configuración por servidor. Desactivar el interruptor maestro pausa futuras entregas; no borra el canal, el texto, las variables ni los medios guardados. El indicador que presenta `.welcome off` es heredado y no sustituye ese interruptor. La comprobación de `.welcome set-channel` también puede pedir Embed Links aunque el formato guardado sea texto, porque valida ese canal con el formato embed predeterminado.

## Contenido y variables

El mensaje puede ser texto, un embed configurado o un script de embed del parser compartido. Usa welcome variables para consultar las claves disponibles; algunas pertenecen a otros eventos y pueden producir N/A. Se admiten enlaces [texto](https://...), el token `{link:Texto|https://...}` y menciones de canal `{channel:ID}`. La vista previa renderiza una muestra con quien ejecutó el comando.

### `.welcome set-title`

```headless-command Syntax theme={null}
.welcome set-title <title>
```

```headless-command Example theme={null}
.welcome set-title ¡Hola {user.display_name}!
```

### `.welcome set-message`

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

```headless-command Example theme={null}
.welcome set-message Te damos la bienvenida a {guild.name}
```

### `.welcome format`

```headless-command Syntax theme={null}
.welcome format [mode=embed]
```

```headless-command Example theme={null}
.welcome format embed
```

## Menciones y borrado

La mención opcional del nuevo miembro se publica fuera del embed y se puede activar o desactivar con `mention`. El envío permite menciones de usuarios, pero bloquea @everyone, @here y menciones de roles. `autodelete 0` conserva el saludo; un número positivo programa el borrado del mensaje. El Dashboard ofrece además un control separado para el borrado de la mención; ese temporizador no se configura con un subcomando de prefijo.

### `.welcome mention`

```headless-command Syntax theme={null}
.welcome mention <state> [message]
```

```headless-command Example theme={null}
.welcome mention on {user.mention}
```

## Botones, imágenes y apariencia

El Dashboard puede guardar hasta cinco botones URL; el grupo de comandos de prefijo solo expone tres ranuras fijas: reglas, soporte y extra. En el Dashboard los botones se publican solo con etiqueta y URL HTTPS válida; los subcomandos aceptan http\://, https\:// o discord://. El Dashboard también expone avatar, thumbnail, banner, GIF, color, footer y un texto de autor. `set-banner` y `set-gif` aceptan URL pública o `off` para quitar el medio. En un embed, el GIF se usa como thumbnail salvo que haya un thumbnail personalizado; el banner ocupa la imagen principal.

### `.welcome set-banner`

```headless-command Syntax theme={null}
.welcome set-banner <url>
```

```headless-command Example theme={null}
.welcome set-banner https://example.com/banner.png
```

### `.welcome button-rules`

```headless-command Syntax theme={null}
.welcome button-rules <url> [label]
```

```headless-command Example theme={null}
.welcome button-rules https://example.com/rules Reglas
```

### `.welcome preview`

```headless-command Syntax theme={null}
.welcome preview
```

```headless-command Example theme={null}
.welcome preview
```

## Alcance de los comandos

El grupo `.welcome` muestra el estado. También existe `/welcome` con opciones `channel` y `enabled` para consultar o cambiar el canal y la activación maestra; por ejemplo, `/welcome enabled:false` la desactiva. La mayoría de los ajustes de contenido se hacen con subcomandos de prefijo o desde el Dashboard.

## Pasos

**1. Elige un canal**

Usa .welcome set-channel #bienvenida. Corrige cualquier permiso que indique el diagnóstico.

**2. Redacta y personaliza**

Configura título, mensaje y formato; añade medios y botones si los necesitas.

**3. Prueba antes de activar**

Ejecuta .welcome preview y comprueba el texto, las variables, la imagen, las menciones y los enlaces.

**4. Activa o pausa el módulo**

Usa `.welcome on` después de validar los permisos. Para pausar entregas usa `/welcome enabled:false` o el control maestro del Dashboard; `.welcome off` no cambia ese interruptor maestro.

> **Comandos de prefijo**
>
> El prefijo predeterminado es punto y puede cambiar por servidor. Comandos: .welcome; .welcome set-channel #canal; .welcome on u off; .welcome set-title texto; .welcome set-message texto; .welcome variables; .welcome format embed|text; .welcome set-banner URL|off; .welcome set-gif URL|off; .welcome mention on|off \[texto]; .welcome avatar on|off; .welcome buttons on|off; .welcome button-rules URL \[etiqueta]; .welcome button-support URL \[etiqueta]; .welcome button-extra URL \[etiqueta]; .welcome autodelete segundos; .welcome preview. Alias del grupo: .bienvenida. Alias adicionales están disponibles en varios subcomandos.

> **Opciones que no cambian la política de seguridad**
>
> El comando .welcome autopin está reservado y siempre mantiene el auto-pin desactivado; no fija ni cambia mensajes. Para editar cinco botones, los campos visuales completos o el borrado separado de la mención, usa el Dashboard del servidor.

## Pautas de configuración

> **Setup**
>
> Define el canal de bienvenida, configura mensaje y botones y prueba con welcome preview.

> **Diseño**
>
> Mantén un título corto, un texto claro y un botón de reglas fácil de reconocer.

> **Errores comunes**
>
> Revisa permisos del canal, valida la URL de reglas y acorta los mensajes que no se puedan renderizar.

## Páginas relacionadas

* [Variables de plantillas](/docs/resources/scripting/variables.md)
* [Scripting de embeds](/docs/resources/scripting/embeds.md)
* [Auto Responders](/docs/server/auto-responders.md)


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