# Bienvenida


> Configura el mensaje de entrada, las variables disponibles y la tarjeta de bienvenida.


- URL: https://nearsecurity.citymoon.org/docs/comunidad/bienvenida
- Sección: Comunidad
- Idioma: Español
- Palabras clave: bienvenida, welcome, mensaje de entrada, embed, tarjeta, placeholders

El sistema de bienvenida envía un mensaje cuando alguien entra al servidor. Se configura únicamente desde el dashboard: el comando `/setup welcome` solo muestra el enlace al panel. Podés usar un mensaje de texto simple o un embed con imagen, miniatura, color y pie.


### Dónde se configura


| Ajuste | Dónde | Qué hace |
| --- | --- | --- |
| Activación | **Bienvenida → Activar Sistema** | Envía el mensaje a los nuevos miembros. |
| Canal | **Bienvenida → Canal de Bienvenida** | Canal donde se publica el mensaje. |
| Tipo | **Bienvenida → Tipo de mensaje** | Texto normal o embed. |
| Contenido | **Bienvenida → Mensaje** | Texto o campos del embed. |
| Apariencia | **Bienvenida → Color, miniatura, imagen y pie** | Solo para el formato embed. |


### Variables disponibles


| Variable | Se reemplaza por |
| --- | --- |
| `{user}` | Mención del nuevo miembro. |
| `{server}` | Nombre del servidor. |
| `{user.tag}` | Nombre de usuario sin discriminador. |
| `{user.id}` | ID de la cuenta. |
| `{user.avatar}` | URL del avatar. |
| `{server.memberCount}` | Cantidad de miembros al momento del ingreso. |


> **Las variables funcionan en ambos formatos**
> En un embed, las variables se reemplazan en el título, la descripción y el pie. Si una variable no se puede resolver, se reemplaza por un valor vacío.


### Mensaje normal o embed


| Formato | Ventajas | Cuándo usarlo |
| --- | --- | --- |
| Texto normal | Rápido de editar y compatible con cualquier canal. | Comunidades que prefieren un saludo breve. |
| Embed | Permite color, imagen, miniatura y pie. | Servidores con identidad visual definida. |


### Tarjeta de bienvenida


Si elegís el formato embed y no definís una imagen personalizada, NearSecurity genera una tarjeta con el avatar y el nombre del miembro. Si definís una imagen `https`, se usa esa imagen y no se genera la tarjeta. La generación de la tarjeta puede fallar si el servidor no tiene los recursos de imagen disponibles; en ese caso el mensaje se envía sin la tarjeta.


> **Permisos del canal**
> El bot necesita `Ver canales`, `Enviar mensajes` e `Insertar enlaces` en el canal de bienvenida. Si el canal es privado, verificá que el rol del bot tenga acceso. Un error de permisos no se anuncia en el servidor; revisá el estado del canal si el mensaje no llega.


### Buenas prácticas


- Mencioná al nuevo miembro con `{user}` para que la bienvenida sea visible.
- Incluí una referencia breve a las normas y al canal de soporte.
- No prometas roles ni beneficios que el servidor no entrega automáticamente.
- Probá el mensaje con una cuenta de prueba antes de activarlo en producción.
- Revisá la bienvenida cuando cambien el nombre, el icono o la identidad del servidor.
