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

# Mensajes de bienvenida

> Publica un saludo en el canal que elijas cada vez que alguien entra, como texto con variables o un embed guardado, y míralo antes de que llegue nadie.

## Resumen

Se envía a un canal que tú elijas cada vez que entra un nuevo miembro. Usa texto simple con [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md), o un [embed](https://wiki.petto.sbs/es/resources/scripting/embeds.md) guardado.

![Petto le da la bienvenida a Mia a Petto Land en el canal de bienvenidas y le dice que es el miembro 1841](https://mintcdn.com/wikipetto/ym43wKcqHRA_RnWi/images/discord/onboarding/es/welcome.webp?fit=max\&auto=format\&n=ym43wKcqHRA_RnWi\&q=85\&s=f1b2ecf6e5e028cb9cc3e482d05dbe41)

En Discord: la bienvenida que Petto publica cuando entra un miembro.

En la dashboard, los mensajes de bienvenida, salida y boost están uno al lado del otro en **Seguridad → Filtro de ingreso → Mensajes**, cada uno con una vista previa en vivo de cómo se ve en Discord.

![La pestaña Mensajes de la página Bienvenida con los mensajes de bienvenida, salida y boost de Petto Land y sus vistas previas](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/dashboard/onboarding/es/welcome.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=cd4f4484d41a769a5b3e04a8b9f601e6)

Dashboard → Seguridad → Filtro de ingreso → Mensajes: los mensajes de bienvenida, salida y boost, cada uno con su vista previa.

## Comandos

```javascript Sintaxis theme={null}
!welcome setup <channel> [embed] [message]
!welcome status
!welcome test
!welcome disable
!welcomeconfig
```

```javascript Ejemplo theme={null}
!welcome setup #welcome --message "¡Bienvenido {user} a {server_name}!"
!welcome setup #welcome welcome-embed
```

```text Resultado theme={null}
✅ Los mensajes de bienvenida se publicarán en #welcome.
Mensaje: ¡Bienvenido {user} a {server_name}!
```

> [accordion] !welcome setup (un mensaje)
>
> ![kira configura la bienvenida en #bienvenidas con --message y Petto confirma el canal y muestra el mensaje con sus variables](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-setup-message.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=1523075673d285befaf7d741173cab63)
>
> En Discord: la bienvenida queda con un texto usando `--message`.

> [accordion] !welcome setup (un embed guardado)
>
> ![kira apunta la bienvenida al embed guardado welcome-embed y Petto lo confirma](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-setup-embed.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=6238a8ddc9adb6ad4ff8e4857c842214)
>
> En Discord: la bienvenida usa el embed guardado `welcome-embed`.

> [accordion] !welcome status
>
> ![Petto muestra el canal #bienvenidas, ningún embed y el mensaje de texto](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-status.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=764919f9fa1e76fd05f74a3ed5f212a5)
>
> En Discord: el canal, el embed y el mensaje de la bienvenida.

> [accordion] !welcome test
>
> ![kira usa !welcome test en #bienvenidas, Petto le da la bienvenida a kira como miembro 1841 y dice que la prueba se envió](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-test.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=8b86afc391595dd7115b9ffbcc362571)
>
> En Discord: la prueba publica la bienvenida con tu propia cuenta y luego lo confirma.

> [accordion] !welcome test (sin configurar)
>
> ![Petto responde que los mensajes de bienvenida no están configurados del todo y que uses !welcome setup primero](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-test-not-configured.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=b6e8b659c2bed105a19ae2e289c8a085)
>
> En Discord: una prueba antes de que la bienvenida tenga canal y mensaje.

> [accordion] !welcome disable
>
> ![Petto confirma que los mensajes de bienvenida están desactivados](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-disable.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=55289a6e14c43e0a1bddcd2ee4431640)
>
> En Discord: los mensajes de bienvenida se desactivan.

> [accordion] !welcomeconfig
>
> ![liam escribe !welcomeconfig y Petto responde con la configuración actual de las bienvenidas, los comandos y un botón Documentación](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-config-card.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=df72428bd51f703aa34e6689e88391b9)
>
> En Discord: `!welcomeconfig`, la configuración de las bienvenidas y los comandos para cambiarla.

`embed` tiene prioridad sobre `message` si los dos están configurados. `test` envía el mensaje con tu propia cuenta como el nuevo miembro, sin que nadie entre de verdad. `!welcome` también funciona como `!wc`. `!welcomeconfig` muestra lo que está configurado ahora para las bienvenidas y cada comando para cambiarlo.

> [!WARNING]
>
> Escribe `--message` antes de un mensaje de texto. Sin eso, la primera palabra después del canal se lee como el nombre de un embed guardado: `!welcome setup #welcome Hola {user}` busca un embed llamado `Hola`. Un **código de embed** no necesita `--message`: `!welcome setup #welcome {embed}$v{description: Hola {user.mention}}$v{button: green && Reglas && embed:reglas}` lo guarda entero como mensaje, con sus [botones](https://wiki.petto.sbs/es/resources/scripting/embeds.md#botones-con-acción).

![kira escribe !welcome setup #bienvenidas Hola \{user} y Petto responde que no encontró ningún embed llamado Hola](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-setup-no-embed.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=8375265ad53ec6a159672a392455ea2f)

En Discord: sin `--message`, la primera palabra se lee como el nombre de un embed guardado.

## Cuándo se envía la bienvenida

Por defecto la bienvenida se envía en el momento en que el miembro entra, como siempre. Un servidor puede elegir cuándo sale (dashboard: **Seguridad → Filtro de ingreso → Mensajes → Bienvenida → Enviar la bienvenida**):

| Valor | Cuándo se envía la bienvenida |
| - | - |
| En cuanto el miembro entra (el valor por defecto) | Al instante. Nada cambia para los servidores que no lo tocan. |
| Después de que el miembro acepte las reglas | Cuando el miembro acepta las reglas del servidor (Membership Screening). Un miembro que nunca las acepta nunca recibe la bienvenida. |
| Después de las reglas y la incorporación | Cuando el miembro además termina la incorporación (onboarding) de Discord, las preguntas que dan roles y canales. En algunos servidores los miembros pueden saltarse la incorporación, así que la bienvenida se envía igualmente **10 minutos después de aceptar las reglas**, o **30 minutos después de que el miembro entre** si el servidor no tiene reglas que aceptar. |

Esto solo funciona cuando **Membership Screening** u **Onboarding del servidor** están activados en Discord (Ajustes del servidor → Configuración de seguridad e Incorporación). Un miembro que no espera nada (un bot, alguien que ya terminó, un miembro que se fue y volvió) recibe la bienvenida al instante.

Solo la bienvenida espera. Todo lo demás sigue siendo inmediato: el [MD al entrar](https://wiki.petto.sbs/es/onboarding/dm-on-join.md) suele llevar las reglas o los pasos de verificación y el [ping al entrar](https://wiki.petto.sbs/es/onboarding/ping-on-join.md) existe para traer al miembro, así que ambos salen al instante, igual que los logs de entrada, el seguimiento de invitaciones, los [roles de entrada](https://wiki.petto.sbs/es/onboarding/join-roles.md) y el bono de nivel. Un miembro que se va antes de que se envíe la bienvenida se descarta, una bienvenida en espera sobrevive a un reinicio de Petto, y una espera de 7 días se olvida. Si apagas el ajuste mientras hay miembros esperando, no se les da la bienvenida tarde: solo los nuevos reciben la bienvenida al instante.

## Segunda bienvenida

Un servidor puede tener **dos bienvenidas**: por ejemplo una en un canal de bienvenida y otra en el chat general. La segunda tiene su propio canal, mensaje (o embed o diseño guardado, con las mismas [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md)) y su propio interruptor. Se envía justo después de la primera, sigue el mismo [ajuste de espera](#cuándo-se-envía-la-bienvenida), y si una no se puede publicar (el canal ya no existe o Petto no puede escribir) la otra se envía igual; el log lo dice una vez por hora.

```javascript Syntax theme={null}
!welcome second-setup <canal> [embed] [mensaje]
!welcome second-disable
```

```javascript Example theme={null}
!welcome second-setup #general --message "¡Todos saluden a {user}!"
```

`!welcome status` y `!welcome test` cubren las dos bienvenidas, y la dashboard tiene una tarjeta **Segunda bienvenida** junto a la primera.

## Ejemplos

Cada ejemplo se puede pegar tal cual. Los resultados muestran lo que ve un miembro llamado Liam cuando entra a **Cozy Corner** como su miembro número 1204.

> [tab] Simple
>
> ```javascript Comando theme={null}
> !welcome setup #welcome --message "¡Bienvenido {user} a **{server_name}**! 🎉"
> ```
>
> ```text Resultado theme={null}
> ¡Bienvenido @Liam a Cozy Corner! 🎉
> ```

> [tab] Número de miembro
>
> ```javascript Comando theme={null}
> !welcome setup #welcome --message "¡Hola {user}, eres nuestro miembro **{user.join_position_suffix}**! Elige tus roles y saluda."
> ```
>
> ```text Resultado theme={null}
> ¡Hola @Liam, eres nuestro miembro 1204.º! Elige tus roles y saluda.
> ```

> [tab] Quién lo invitó
>
> ```javascript Comando theme={null}
> !welcome setup #welcome --message "¡Bienvenido {user}! Te invitó {inviter}, que ahora tiene {inviter.invites} invitaciones."
> ```
>
> ```text Resultado theme={null}
> ¡Bienvenido @Liam! Te invitó @Mia, que ahora tiene 12 invitaciones.
> ```
>
> Las variables de invitaciones necesitan que Petto tenga **Gestionar servidor**. Cuando Petto no puede saber qué invitación se usó (un enlace vanity, por ejemplo), `{inviter}` dice Desconocido.

> [tab] Saludo al azar
>
> ```javascript Comando theme={null}
> !welcome setup #welcome --message "{choose:Miren quién llegó|Apareció un miembro salvaje|Bienvenido a bordo}, ¡{user}! {reactreply:👋}"
> ```
>
> ```text Resultado theme={null}
> Apareció un miembro salvaje, ¡@Liam!
> (Petto reacciona 👋 a su propio mensaje)
> ```

> [tab] Con una tarjeta de imagen
>
> ```javascript Comando theme={null}
> !welcome setup #welcome --message "¡Bienvenido {user}! {imgcard:welcome}"
> ```
>
> Envía el texto con la [tarjeta de imagen](https://wiki.petto.sbs/es/resources/image-cards.md) llamada `welcome` dibujada para el miembro (su avatar y su nombre sobre tu diseño).

## Usar un embed guardado

**1. Crea el embed**

Créalo en la página **Embeds** de la dashboard, o desde un solo código:

```javascript Comando theme={null}
!embed create welcome-embed {embed}$v{title: ¡Bienvenido a {server_name}!}$v{description: Hola {user}, eres el miembro número **{server_membercount}**.{newline}Lee las reglas y elige tus roles.}$v{thumbnail: {user.avatar}}$v{color: #f0a88f}
```

![kira crea welcome-embed desde un código y Petto responde con el embed: Bienvenido a Petto Land, miembro número 1841](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-embed-step-1-create.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=4bcbeee42d97e7bea859004afc9e32c7)

En Discord: el embed se guarda desde un código y Petto lo muestra lleno para ti.

**2. Apunta la bienvenida a él**

```javascript Comando theme={null}
!welcome setup #welcome welcome-embed
```

![Petto confirma que las bienvenidas van a #bienvenidas con el embed welcome-embed](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-embed-step-2-setup.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=05195d5d6b462c3427ac3daf4c436a82)

En Discord: la bienvenida ahora usa `welcome-embed`.

**3. Pruébalo**

```javascript Comando theme={null}
!welcome test
```

Recibes el embed en `#welcome` con tu propio nombre, tu avatar y el número real de miembros.

![kira usa !welcome test y Petto publica el embed de bienvenida para kira con su avatar y el número de miembro 1841](https://mintcdn.com/wikipetto/g4OHEKGglGg73djn/images/discord/onboarding/es/welcome-embed-step-3-test.webp?fit=max\&auto=format\&n=g4OHEKGglGg73djn\&q=85\&s=088d97abe99f5b11a30d372020b77ef3)

En Discord: la prueba publica el embed con tu nombre, tu avatar y el número real de miembros.

## Variables

Todas las [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md) funcionan. Las pensadas para las bienvenidas:

| Variable | Qué da | Ejemplo |
| - | - | - |
| `{user}` | Menciona al nuevo miembro | @Liam |
| `{user.display_name}` | Su nombre en el servidor | Liam |
| `{user.join_position_suffix}` | Su número de miembro en ordinal | 1204.º |
| `{user.created_at_timestamp}` | Cuándo se creó la cuenta, para usar como `<t:…:R>` | hace 6 años |
| `{server_membercount}` | Miembros actuales | 1204 |
| `{inviter}` / `{inviter.name}` | Quién lo invitó | @Mia / Mia |
| `{inviter.invites}` | Cuántas invitaciones tiene esa persona | 12 |
| `{invite.code}` | La invitación que se usó | cozy |

![La pestaña Mensajes con el menú Variables abierto sobre el mensaje de bienvenida, con \{user}, \{user.mention}, \{user.name} y más](https://mintcdn.com/wikipetto/NrGrZ7c5mnuxcpr5/images/dashboard/onboarding/es/welcome-variables-menu.webp?fit=max\&auto=format\&n=NrGrZ7c5mnuxcpr5\&q=85\&s=c550e1a2278eb9f03b20f6c0c13354fb)

Dashboard → Seguridad → Filtro de ingreso → Mensajes: el menú Variables muestra cada variable; haz clic en una para copiarla.

Pon un `!` antes de una mención (`!@everyone`, `!@Moderadores`) para mostrarla sin avisar a nadie: mira [Menciones silenciosas](https://wiki.petto.sbs/es/concepts/variables-engine.md#menciones-silenciosas).

## Relacionado

> [card] [MD al entrar](https://wiki.petto.sbs/es/onboarding/dm-on-join.md)
>
> Un mensaje privado para cada nuevo miembro.

> [card] [Mensajes de despedida](https://wiki.petto.sbs/es/onboarding/leave.md)
>
> Lo mismo, cuando alguien se va.


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