# Bienvenidas

## ¿Qué son las Bienvenidas?

Las Bienvenidas te permiten **enviar un mensaje personalizado** (Embed) cuando alguien se une a tu servidor. Puedes personalizar colores, imágenes, texto y más.

### Casos de Uso

* ✅ Dar bienvenida a nuevos miembros
* ✅ Explicar reglas al llegar
* ✅ Mostrar logo del servidor
* ✅ Redirigir a canales importantes

***

## 🚀 Configuración Básica (Para Usuarios Nuevos)

{% stepper %}
{% step %}

### Elegir el canal

Decide dónde quieres enviar el mensaje de bienvenida:

* Un canal #bienvenidas
* Un canal privado
* O cualquier canal de texto
  {% endstep %}

{% step %}

### Activar Bienvenidas

Usa este comando:

```bash
/bienvenidas embed setup #bienvenidas
```

**Explicación:**

* `/bienvenidas` = comando principal
* `embed` = tipo de mensaje (con diseño bonito)
* `setup` = crear la bienvenida
* `#bienvenidas` = canal donde enviar
  {% endstep %}

{% step %}

### Personalizar mensaje

El bot te mostrará un menú para elegir:

* **Color** del embed
* **Mostrar foto** del nuevo miembro
* **Título** personalizado
* **Descripción** del mensaje
  {% endstep %}

{% step %}

### ¡Listo!

Cada nuevo miembro recibirá un bonito mensaje de bienvenida
{% endstep %}
{% endstepper %}

***

## ⚙️ Opciones Avanzadas

### Editar la Bienvenida

```bash
/bienvenidas embed edit
```

Puedes cambiar:

* ✏️ **Color:** 20+ colores disponibles
  * Random (aleatorio)
  * Blanco, Azul, Verde, Rojo, Morado, Oro, etc.
* 📸 **Thumbnail:** Mostrar/Ocultar foto del miembro
* 🖼️ **Imagen:** URL de una imagen de fondo
* 🎨 **Texto:** Personalizar título y descripción

### Cambiar Canal

```bash
/bienvenidas embed setchannel #nuevo-canal
```

### Eliminar Bienvenida

```bash
/bienvenidas embed eliminar
```

***

## 🎨 Colores Disponibles

```
Random (Aleatorio)
Defecto (Gris)
Blanco
Azul marino (Aqua)
Azul marino oscuro (Dark Aqua)
Verde
Azul
Amarillo
Morado
Rosa vivido
Fuchsia
Oro
Naranjado
Rojo
Rojo oscuro
Gris
Navy
Morado azulado (Blurple)
Azul oscuro
Verde oscuro
```

***

## 📝 Variables y Placeholders

Puedes usar estas variables en el mensaje:

| Variable        | Qué hace            | Ejemplo     |
| --------------- | ------------------- | ----------- |
| `{user}`        | Menciona al usuario | @Nombre     |
| `{username}`    | Nombre del usuario  | Nombre      |
| `{mention}`     | Etiqueta el usuario | <@ID>       |
| `{membercount}` | Total de miembros   | 42          |
| `{servername}`  | Nombre del servidor | Mi Servidor |

**Ejemplo:**

```
¡Bienvenido {user}! 
Eres el miembro número {membercount} de {servername}
```

***

## 🖼️ Agregar Imágenes

{% tabs %}
{% tab title="Método 1: URL Directa" %}
Si tienes una URL de imagen (JPG, PNG):

```bash
/bienvenidas embed edit imagen-url:https://ejemplo.com/imagen.png
```

{% endtab %}

{% tab title="Método 2: Subir Imagen" %}

1. Sube la imagen a un servicio como [imgur.com](https://imgur.com/)
2. Copia el enlace directo (termina en .jpg o .png)
3. Úsalo en el comando anterior
   {% endtab %}
   {% endtabs %}

***

## 🔍 Solución de Problemas

| Problema                      | Solución                                     |
| ----------------------------- | -------------------------------------------- |
| **No se envía bienvenida**    | Verifica permisos en el canal                |
| **Imagen no aparece**         | La URL debe terminar en .jpg, .png o similar |
| **Colores raros**             | Usa colores disponibles del menú             |
| **No ve la foto del usuario** | Activa "Mostrar thumbnail" en edit           |

***

## 📝 Ejemplo Práctico

**Servidor de Comunidad Gaming:**

```bash
/bienvenidas embed setup #bienvenidas
Color: Azul
Thumbnail: Activar
Texto: "¡Bienvenido a NombreServidor! 
Somos una comunidad de +1000 gamers.
Lee #reglas antes de participar.
¡Que disfrutes!"
```

Resultado: Cada nuevo miembro verá un bonito embed azul con su foto y el mensaje personalizado.

***

## 🎯 Combina con Otros Sistemas

* **+ AutoRole:** Bienvenida + Asignar rol
* **+ Logs:** Registra bienvenidas
* **+ Verify:** Primero verifica, luego bienvenida

***

## 📞 ¿Problemas?

1. Comprueba que el bot tiene **"Enviar Mensajes"** en el canal
2. Verifica que **"Leer Historial"** está permitido
3. Revisa que la URL de imagen sea válida
4. Pide ayuda en [soporte](https://discord.gg/2ZKdT6SRsZ)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://okaa.gitbook.io/okaa-wiki/configuracion/bienvenidas.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.