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

# Embeds

> Crea plantillas de mensajes completas una vez y úsalas en todas partes.

## Resumen

Los embeds de Petto son plantillas guardadas: crea una (en Discord o en el dashboard), ponle un nombre y luego úsala por su nombre en comandos personalizados, autorrespuestas, mensajes de bienvenida/despedida/boost, mensajes de sorteos o paneles de tickets. Cambia la plantilla una vez y se actualiza en todos los lugares que la usan.

> [!TIP]
>
> La [página Embeds del dashboard](https://petto.sbs/dash) tiene un creador visual completo: una vista previa en vivo igual a Discord, hasta 10 embeds y 5 filas de botones de enlace por plantilla, atajos de formato markdown y una referencia de [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md) con buscador. Todo lo de abajo también funciona directamente desde Discord.

![La página Embeds con welcome\_embed abierto: su vista previa con un embed y tres botones, las reacciones, el contenido del mensaje y los campos del embed](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/embeds-dashboard-editor.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=740e7253e1cc524f27e83c358d5d43c1)

Dashboard → Diseño → Embeds: el editor visual, con la vista previa en vivo sobre los campos del mensaje.

## Crear y administrar

```javascript Sintaxis theme={null}
!embed create <name>
!embed preview <embed>
!embed send <embed> [channel]
!embed delete <embed>
!embed list
!embed vars [page]
```

```javascript Ejemplo theme={null}
!embed create welcome_embed
!embed preview welcome_embed
!embed send welcome_embed #anuncios
```

> [accordion] !embed create
>
> ![liam usa !embed create announcement\_embed y Petto responde con el panel: botones para el título, la descripción, el color, el autor, el pie, las imágenes, la hora, los campos, y Guardar, Restablecer y Cancelar](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-create-panel.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=edb72abbc73ff6e4bee975f744282945)
>
> En Discord: !embed create abre el panel de edición del embed nuevo.

> [accordion] !embed preview
>
> ![liam usa !embed preview welcome\_embed y Petto muestra el embed con liam mencionado y 1840 miembros](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-preview.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=beaba11d3818a1bcf7073c87e2c60c25)
>
> En Discord: !embed preview arma el embed guardado contigo como miembro.

> [accordion] !embed preview (no existe)
>
> ![kira pide la vista previa de welcome y Petto dice que no hay ningún embed con ese nombre y cómo crearlo](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-preview-missing.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=ed05d3770839f0a87c9cd274376d961a)
>
> En Discord: un nombre que no está guardado recibe una pista para crearlo.

> [accordion] !embed send
>
> ![liam envía welcome\_embed al canal de anuncios y Petto lo confirma](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=9d515a6f7963bda2dc82f1091019674a)
>
> En Discord: !embed send confirma adónde fue el embed.
>
> ![El embed de bienvenida publicado por Petto en el canal de anuncios](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=3d91aa26f41ef8b845515146bb6c59ce)
>
> En Discord: el embed como lo ven los miembros en el canal.

> [accordion] !embed delete
>
> ![liam borra old\_rules y Petto lo confirma](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-delete.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=37d18671838c314db56fa73d648eb90d)
>
> En Discord: !embed delete borra un embed guardado.

> [accordion] !embed list
>
> ![Petto lista en orden los cinco embeds guardados del servidor](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-list.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=9277d4a3c0b72ec3e2c35371f768aef0)
>
> En Discord: !embed list muestra los embeds guardados del servidor.

> [accordion] !embed vars
>
> ![chu usa !embed vars y Petto muestra las variables del usuario con lo que da cada una, página 1 de 10](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-vars.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=e7c5299509a8489e955100c3229698e0)
>
> En Discord: !embed vars, la primera página de variables, con botones para pasar las páginas.

> [!NOTE]
>
> `!embed create` abre un panel de edición interactivo con botones para cada campo (título, descripción, color, campos, etc.), no una respuesta de texto simple.

`vars` muestra la referencia de variables directamente en Discord, por páginas.

## Crear desde un código

```javascript Sintaxis theme={null}
!embed create <name> <code>
```

```javascript Ejemplo theme={null}
!embed create welcome {embed}&v{title: Bienvenido {user.display_name}}&v{description: Lee las reglas}&v{color: #ff91c2}
```

![liam crea welcome con un código y Petto lo confirma y muestra el embed con el título Bienvenido liam](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-create-code.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=e42be3364093673aa5838598da77c27f)

En Discord: un embed hecho con un código se guarda y se muestra al instante.

Todo el embed se puede escribir como un solo código y se guarda y se muestra al instante, sin el panel de edición. Los bloques se unen con `&v` (también se lee `$v`), `&&` va entre los valores de un bloque, y el texto antes de `{embed}` o `{message: ...}` es el texto del mensaje. Un código puede tener hasta 10 embeds: `{embed}&v{...}&v{embed}&v{...}`.

Un diseño de **Components V2** también se puede crear desde un código: pega el código que empieza con `p2.` (el que te dan el dashboard y el Embed Builder) en el mismo lugar, y el diseño se guarda y se muestra al instante.

![liam pega un código p2. y Petto guarda el diseño rules\_v2 y lo muestra: las reglas, una imagen y los botones Acepto y petto.sbs](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-create-v2-code.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=aed227e0935255823a8709f896f387c6)

En Discord: un código p2. guarda un diseño Components V2 y lo muestra.

| Bloque | Uso |
| - | - |
| `title`, `url`, `description`, `color` | Los campos básicos |
| `thumbnail`, `image` | Imágenes |
| `author`, `footer` | Autor y pie, con `&&` para el texto y el icono |
| `field` | Un nombre y un valor (y `inline`) |
| `timestamp` | Muestra la hora |
| `button` | Un botón de enlace, o un botón con acciones (roles, embeds guardados) |
| `message` | El texto del mensaje fuera del embed |

El [Generador de códigos de embed](https://petto.sbs/embed-code) de la web arma un mensaje con vista previa y lo copia como un código de una línea. Todo lo que no se admite se avisa y se deja fuera, no se guarda nada si Discord rechazaría el embed, y variables como `{user}` funcionan dentro de los valores. Discord no permite saltos de línea reales en una opción de comando, así que escribe `{newline}`. `!embed create` sin código abre el panel de edición como antes. Con el comando slash, el código va en su opción `code` (`/embed create name code:`). Un código con texto de mensaje o botones se guarda en el formato del dashboard y se edita ahí. Mira `!embed vars` para la página de códigos.

![El generador de códigos de embed con un título, una descripción, un color y un botón verde Aceptar, su vista previa y el código de una línea](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/embeds-code-generator.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=174d26d806f192c344e37ef6ae856f0e)

Generador de códigos de embed (petto.sbs/embed-code): el formulario, la vista previa y el código para copiar.

![chu usa !embed vars 10 y Petto lista cada bloque de un código de embed con un ejemplo y el enlace al generador](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-vars-code.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=06ce80eb154ac16d75e62d0165e04d48)

En Discord: la página del código de !embed vars (página 10).

## Enviar y cambiar un código

Un código de embed funciona en más lugares que `!embed create`:

* **Autorrespuestas**: escribe el código como respuesta, `!autoresponder add test, {embed}$v{description: Hola {user.mention}} --reply`. Mira [Autorrespuestas](https://wiki.petto.sbs/es/automation/autoresponder.md#flags) para los flags.
* **Cambiar un mensaje que Petto ya envió**: `!editembed` lo reemplaza con un código nuevo.

```javascript Sintaxis theme={null}
!editembed <message link or id> <code>
!editembed <code>   (como respuesta al mensaje)
```

```javascript Ejemplo theme={null}
!editembed https://discord.com/channels/123/456/789 {embed}$v{description: Texto nuevo}$v{embed}$v{description: Un segundo embed}
```

![liam usa !editembed con el enlace de un mensaje y un código con dos embeds, y Petto confirma que cambió el mensaje en anuncios](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-editembed-done.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=da9b060685bd314fb73b540ea97f5952)

En Discord: !editembed confirma el cambio con un enlace al mensaje.

![El mensaje de Petto en anuncios ahora tiene dos embeds, Texto nuevo y Un segundo embed](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-editembed-result.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=cfce3581d8f5d870c970043e0f5eba38)

En Discord: el mensaje después de !editembed: exactamente lo que dice el código nuevo.

Necesita **Gestionar mensajes** en ese canal y solo funciona con mensajes que envió Petto. Lo que el código nuevo no define se borra, así que el mensaje queda exactamente como dice el código. Un mensaje hecho con Components V2 no se puede convertir en un mensaje con embed normal; envía uno nuevo con `!embed send`.

![liam apunta !editembed a un mensaje de kira y Petto responde en rojo que solo puede cambiar sus propios mensajes](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-editembed-notmine.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=aa6f90b81f2f1a091bedca43dbbd707f)

En Discord: !editembed rechaza un mensaje que no envió Petto.

> [!TIP]
>
> Si a un bloque le falta su llave de cierre, por ejemplo `{message: {user.mention}$v{description: ...}`, el bloque termina donde empieza el siguiente y Petto te avisa, en vez de leer el resto del código como texto.

![liam usa un código cuyo bloque message perdió su llave; Petto cambia el mensaje y agrega una línea que dice que un bloque se cerró antes del siguiente](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-editembed-warning.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=db4a522bd571bc25618918865528cbd0)

En Discord: un bloque sin su llave de cierre: el mensaje se cambia y Petto dice dónde se cerró el bloque.

## Botones con acción

Además de los botones de enlace, un código puede tener botones que **hacen algo** al pulsarlos:

```javascript Sintaxis theme={null}
{button: <color> && <etiqueta> && <acción> [&& <acción>...] [&& emoji:<emoji>] [&& disabled]}
```

```javascript Ejemplo theme={null}
{embed}$v{title: Reglas}$v{description: Pulsa para aceptar.}$v{button: green && Aceptar && role:@Miembros}$v{button: blurple && Ver las reglas && embed:reglas:ephemeral}$v{button: grey && Por privado && embed:reglas:dm}
```

![Un embed Reglas de Petto con un botón verde Aceptar, uno azul Ver las reglas y uno gris Por privado](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-buttons-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=905dfdc9fe596d7923927a9548f0d4bf)

En Discord: el código de ejemplo enviado en el canal de reglas: tres botones con acciones.

| Color | Se ve |
| - | - |
| `blurple`, `green`, `grey`, `red` | Azul, verde, gris o rojo (gris si no pones color) |

| Acción | Qué hace |
| - | - |
| `role:<rol>` | Da el rol, o lo quita si la persona ya lo tiene |
| `addrole:<rol>` | Solo da el rol |
| `removerole:<rol>` | Solo quita el rol |
| `embed:<nombre>` | Responde con un embed guardado, **solo a quien pulsó** |
| `embed:<nombre>:public` | Lo publica en el canal (con una pausa de 5 segundos por persona) |
| `embed:<nombre>:dm` | Lo envía al privado de quien pulsó |

> [accordion] role:
>
> ![Debajo del mensaje de reglas Petto le responde a Mia, solo a ella, que se agregó el rol Miembros](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-buttons-role.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=6ed0b644c7132c6e2303abd0839cf713)
>
> En Discord: un clic en Aceptar da el rol, y solo quien hizo clic ve la respuesta.

> [accordion] embed:\<name>
>
> ![Petto le muestra a Mia el embed guardado de reglas con las cuatro reglas, como un mensaje que solo ella ve](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-buttons-ephemeral.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=a370d4a19e99fc7143a1c6a6fbe611e6)
>
> En Discord: Ver las reglas responde con el embed guardado, solo a quien hizo clic.

> [accordion] embed:\<name>:dm
>
> ![Petto le dice a Mia, solo a ella, que le envió el embed por mensaje directo](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-buttons-dm.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=7515e415feda16ebd34d17b1c36042c4)
>
> En Discord: Por privado envía el embed por mensaje directo y lo avisa.
>
> ![El embed de reglas en un mensaje directo de Petto](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-buttons-dm-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=eb8fceee0ece94f133bc4216730d1d00)
>
> En Discord: el embed guardado en los mensajes directos de quien hizo clic.

`<rol>` es una mención, un ID o el nombre del rol. Un botón puede tener hasta **4 acciones** (por ejemplo dar un rol y mostrar un embed a la vez) y un código hasta 5 botones, en una fila. Petto solo cambia roles que estén **por debajo de su rol más alto**, que no sean de una integración, y necesita el permiso **Gestionar roles**. Lo que hace cada botón queda dentro del propio botón, así que sigue funcionando después de reiniciar Petto.

> [!NOTE]
>
> Los botones con acción también se hacen sin escribir código: en el [generador de códigos](https://petto.sbs/embed-code) y en el creador de embeds del dashboard, cada botón puede ser **Enlace** o **Acción** (con color, rol o embed guardado).

![La sección Botones del editor: Aceptar las reglas da un rol, Ver las reglas muestra un embed guardado y petto.sbs es un enlace](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/embeds-dashboard-buttons.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=51cf91adfcd83358709ea29d760857a4)

Dashboard → Diseño → Embeds: cada botón es un Enlace o una Acción, con su color, emoji y acciones.

## Enviar mensajes con !send

```javascript Sintaxis theme={null}
!send [#canal] <mensaje>
```

```javascript Ejemplo theme={null}
!send #anuncios Hola @Miembros, mira https://petto.sbs
!send #reglas {embed}$v{title: Reglas}$v{description: Sé amable}$v{button: green && Aceptar && role:@Miembros}
```

Solo los miembros con **Gestionar mensajes** en el servidor pueden usar `!send` (y `petto send`, `!message send` y `/message send`). El permiso se comprueba primero, en todas las formas de enviar, y sin él Petto rechaza en privado. Petto también necesita ver y escribir en el canal.

> [accordion] !send (texto y un rol)
>
> ![liam envía un texto que menciona el rol Miembros a anuncios y Petto lo confirma](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-text.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=6275a077728c534e0920765942e37ecd)
>
> En Discord: !send confirma con un enlace al mensaje.
>
> ![El mensaje de Petto en anuncios con la mención de Miembros y el enlace](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-text-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=bc07cbf349a9791c58784b0a5bcc47ee)
>
> En Discord: el mensaje tal como lo envió Petto.

> [accordion] !send (un código de embed)
>
> ![liam envía un embed Reglas con un botón Aceptar a reglas y Petto lo confirma](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-code.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=0b8013fb822eb17e3ac7e536a5714282)
>
> En Discord: un código de embed con un botón enviado al canal de reglas.
>
> ![El embed Reglas con el botón verde Aceptar](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-code-message.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=675b09f5d2c82617a2c9ec9fdb8299b1)
>
> En Discord: el embed y su botón en el canal.

Envía un mensaje **como Petto**. Puede ser texto con saltos de línea, enlaces, menciones de roles, un código de embed, y las imágenes, videos o archivos que **adjuntes al comando** (hasta 10). Si no pones canal, se envía en el actual; si respondes a un mensaje de ese canal, el mensaje enviado también le responde.

* Necesitas **Gestionar mensajes** en ese canal, y Petto necesita poder escribir ahí (y **Adjuntar archivos** o **Insertar enlaces** si hace falta).
* Los **pings** siguen tus permisos: las personas siempre, un rol solo si se puede mencionar, y `@everyone` o roles bloqueados solo si tienes **Mencionar a todos**.
* Las [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md) como `{user.mention}` y `{server_name}` se rellenan contigo como miembro.
* Un código con botones que dan o quitan roles necesita que tengas **Gestionar roles** y que esos roles estén por debajo de tu rol más alto; un botón que muestra un embed necesita que ese embed exista.

![kira intenta enviar un botón que da el rol Admin y Petto dice que ese rol no está por debajo de su rol más alto](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-send-refused.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=2d87ac203cc3eb9a53608772825c598d)

En Discord: un botón con un rol por encima de tu rol más alto se rechaza.

## Editar campos

```javascript Sintaxis theme={null}
!embed edit title <embed> <title> [url]
!embed edit description <embed> <description>
!embed edit color <embed> <color>
!embed edit author <embed> <text> [icon] [url]
!embed edit footer <embed> <text> [icon]
!embed edit thumbnail <embed> <image>
!embed edit image <embed> <image>
!embed edit timestamp <embed> <true|false>
```

```javascript Ejemplo theme={null}
!embed edit title welcome_embed "¡Bienvenido!" https://petto.sbs
!embed edit color welcome_embed #8399ff
!embed edit description welcome_embed "¡Qué bueno que estés aquí, {user}!{newline}Mira #reglas para empezar."
```

> [accordion] !embed edit title
>
> ![liam usa !embed edit title en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-title.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=bc347a6f94df2b7eb376eeae8f163a22)
>
> En Discord: !embed edit title, y luego !embed preview muestra el título nuevo, con su enlace, en la vista previa.

> [accordion] !embed edit description
>
> ![liam usa !embed edit description en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-description.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=6bca1ae089a732ad11172d711cad1434)
>
> En Discord: !embed edit description, y luego !embed preview muestra la descripción nueva, con su salto de línea.

> [accordion] !embed edit color
>
> ![liam usa !embed edit color en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-color.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=2b14c8a0b0dc27e4b1ed5ea04a510b6c)
>
> En Discord: !embed edit color, y luego !embed preview muestra el color nuevo de la barra lateral.

> [accordion] !embed edit author
>
> ![liam usa !embed edit author en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-author.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=a6a2fa3c75c82ed922b4b0eeaefbe152)
>
> En Discord: !embed edit author, y luego !embed preview muestra la línea del autor con su icono.

> [accordion] !embed edit footer
>
> ![liam usa !embed edit footer en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-footer.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=f5e0ccec9fc823cb90dd8ab376421e93)
>
> En Discord: !embed edit footer, y luego !embed preview muestra el pie, con una variable llena.

> [accordion] !embed edit thumbnail
>
> ![liam usa !embed edit thumbnail en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-thumbnail.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=5d3e8e0d521d8ac5fe060416abea247b)
>
> En Discord: !embed edit thumbnail, y luego !embed preview muestra la imagen pequeña arriba a la derecha, de \{user\_avatar}.

> [accordion] !embed edit image
>
> ![liam usa !embed edit image en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-image.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=1f6a9498b9e4a9953b0fbd2a8b5e218c)
>
> En Discord: !embed edit image, y luego !embed preview muestra la imagen grande debajo del embed.

> [accordion] !embed edit timestamp
>
> ![liam usa !embed edit timestamp en welcome\_embed, Petto dice que se actualizó y la vista previa muestra el cambio](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-edit-timestamp.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=ebdd3d39b05311cb86c88ee3d69b61f7)
>
> En Discord: !embed edit timestamp, y luego !embed preview muestra la hora del mensaje en el pie.

## Campos (los pares nombre/valor)

```javascript Sintaxis theme={null}
!embed field add <embed> <name> <value> [inline]
!embed field remove <embed> <position>
```

```javascript Ejemplo theme={null}
!embed field add welcome_embed Reglas "Mira #reglas" true
!embed field remove welcome_embed 1
```

![liam agrega el campo Reglas a welcome\_embed, Petto cuenta 2 de 25 y la vista previa muestra los dos campos](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-field-add.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=c2e0a25664b30b4f925135c14fddc390)

En Discord: !embed field add: el segundo campo, Reglas, en la vista previa.

![liam quita el campo 1 de welcome\_embed y la vista previa ya no tiene el campo Miembros](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-field-remove.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=69de644095b1c75241c9c8ed7dbf2e8b)

En Discord: !embed field remove 1: el primer campo ya no está.

Hasta 25 campos por embed. `position` empieza en 1, según el orden que muestra `!embed preview`.

## Usar un embed guardado

> [accordion] En un comando personalizado
>
> Usa un embed guardado en `!customcommand` en vez de un texto de respuesta simple; `embed_template` tiene prioridad sobre `response`.

> [accordion] En una autorrespuesta
>
> Una autorrespuesta puede enviar un embed guardado (`--embed_template`), un código de embed escrito como respuesta, o el modo de embed en línea más ligero (color, título, pie).

> [accordion] En mensajes de bienvenida/despedida/boost/MD al entrar
>
> Cada subcomando `setup` (`!welcome setup`, `!leave setup`, `!boost setup`, `!dmonjoin setup`) tiene una opción `embed` que tiene prioridad sobre el `message` simple. El `message` también puede ser **un código de embed** escrito allí mismo, así configuras el canal y el embed (con sus botones) en un solo comando.

> [accordion] En un panel o categoría de tickets
>
> Tanto `!ticket panel create` como `!ticket category add` aceptan un embed guardado para el mensaje del panel o el mensaje de bienvenida del ticket.

> [accordion] En un mensaje con páginas
>
> Varios embeds guardados (o códigos de embed) pueden ser las páginas de un mismo mensaje, con botones para pasarlas: `!pagination create #reglas reglas_generales` y luego `!pagination add`. Mira [Paginación](https://wiki.petto.sbs/es/resources/scripting/pagination.md).

## Reacciones

Un embed guardado puede llevar hasta **5 reacciones**: emojis que Petto agrega al mensaje cuando lo envía. En el editor del dashboard van en el campo **Reacciones**, separadas por espacios (un emoji personalizado se escribe `<:name:id>`). Es lo mismo que escribir `{reactreply:emoji}` en el texto por cada uno, y se pueden usar ambos juntos. Se ponen en el mensaje cuando se envía con `!embed send`, desde autorrespuestas y comandos personalizados, en mensajes fijos, paneles, respuestas de partners, la bienvenida de subidas y un mensaje honeypot.

![El embed de la noche de juegos de Petto en anuncios con las reacciones ✅, 🤔 y ❌ ya puestas](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-reactions.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=58b45be67bbdb7e04018471b5183b4a7)

En Discord: un embed guardado con tres reacciones, enviado con !embed send.

## El dashboard y el Embed Builder

Un mensaje hecho en el dashboard se puede enviar al Embed Builder con un código para compartir, y un mensaje enviado desde el Embed Builder se puede abrir en el dashboard para seguir editándolo. El dashboard también puede enviar un mensaje de prueba a un canal antes de que lo guardes.

![El cuadro Probar y compartir con el selector de canal, Enviar prueba, Copiar código para compartir, Copiar JSON y Abrir en Embed Generator](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/embeds-dashboard-test-share.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=d7c4e056b2bbafe068d7ca076c5cdd29)

Dashboard → Diseño → Embeds: Probar y compartir: envía una prueba a un canal o a tus mensajes directos, copia el código para compartir o el JSON, o ábrelo en el Embed Generator.

## Embeds V2

La página Embeds del dashboard también tiene un **editor V2** para los mensajes de Components V2 de Discord: contenedores, texto, imágenes, secciones, divisores y filas de botones. Un diseño V2 se guarda como cualquier otro embed y se puede usar en las alertas de Misiones, sanciones, el starboard, los mensajes de verificación y de bump, y con `!embed send` y `!embed preview`. Sus textos y enlaces usan las variables de siempre. Todo lo que Discord rechazaría se limpia antes de enviarse.

![El diseño rules\_v2 abierto en el editor V2, con su vista previa y los primeros componentes del contenedor](https://mintcdn.com/wikipetto/NNb0rgWpeffY0EDH/images/dashboard/resources/es/embeds-dashboard-v2.webp?fit=max\&auto=format\&n=NNb0rgWpeffY0EDH\&q=85\&s=aa6c3340661b784d1a2329e2fb091530)

Dashboard → Diseño → Embeds: el editor V2: la vista previa, luego el contenedor con su texto, divisor, imagen y fila de botones.

Un diseño V2 se comparte con el Embed Builder con un código que empieza con `p2.`.

Un botón de un diseño V2 (en una fila de botones, o junto a una sección) es un **enlace** o una **acción**. Un botón de acción tiene un color (azul, verde, gris o rojo), un emoji opcional y hasta cuatro acciones: dar, quitar o alternar un rol, o mostrar un embed guardado (solo a quien lo pulsó, en el canal o por mensaje directo), igual que los [botones con acción](#botones-con-acción) de los códigos de embed. Un botón cuyos roles ya no existen se deja fuera.

![liam usa !embed preview rules\_v2 y Petto muestra el contenedor con las reglas de Petto Land, la imagen y dos botones](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-v2-preview.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=128024442bdc63ab59736d991c91b9d9)

En Discord: un diseño V2 mostrado con !embed preview.

Los bloques de texto de un diseño V2 también aceptan [menciones silenciosas](https://wiki.petto.sbs/es/concepts/variables-engine.md#menciones-silenciosas): `!@Rol` muestra la mención sin avisar a nadie.

## Variables dentro de los embeds

Cada texto de un embed (texto del mensaje, título, descripción, campos, autor, pie, textos de los botones) y cada enlace (URL, miniatura, imagen, iconos) acepta las [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md). Cuáles tienen datos depende de qué envía el embed: una bienvenida rellena al miembro nuevo, un sorteo las `{gw.*}`, una sanción las `{case.*}`.

```javascript Ejemplo theme={null}
!embed create profile {embed}$v{author: {user.display_name} && {user.avatar}}$v{description: 👋 Miembro de **{server_name}** desde {user.joined_at}{newline}🎖️ Rol más alto: {user.top_role}}$v{thumbnail: {user.display_avatar}}$v{footer: ID {user.id}}$v{color: #8399ff}
```

```text Resultado (para !embed preview profile) theme={null}
Liam
👋 Miembro de Cozy Corner desde 10/19/2026
🎖️ Rol más alto: Booster
ID 293504726505357312
```

![chu crea profile con el código y pide la vista previa: el nombre y la foto de chu, Miembro de Petto Land desde una fecha, el rol más alto Moderadores y el ID de chu](https://mintcdn.com/wikipetto/s2csZscuSJC9o9j0/images/discord/resources/es/embeds-variables-profile.webp?fit=max\&auto=format\&n=s2csZscuSJC9o9j0\&q=85\&s=423a5d6d1f40543c40035780b6cbf9ec)

En Discord: el código de profile, y luego !embed preview profile con chu como miembro.

Algunas cosas a tener en cuenta:

* `!embed preview` rellena las variables **contigo** como miembro y con el canal actual, así ves un resultado real. Las variables de un evento (un nivel, un caso, un sorteo) quedan vacías ahí.
* La vista previa en vivo del dashboard las rellena con datos de ejemplo (un miembro llamado Liam), y un mensaje de prueba enviado desde el dashboard usa tu cuenta real.
* Los timestamps de Discord (`{timestamp}`, `{gw.ends}`, `{case.expires}`, `<t:…>`) se muestran en el texto del mensaje, las descripciones y los valores de los campos. En títulos, pies y nombres de autor Discord muestra el código tal cual, así que usa `{date}` o palabras simples ahí.
* Un campo cuyo nombre o valor queda vacío se omite, así que un campo hecho solo de una variable desaparece cuando esa variable no tiene datos.
* Un enlace de imagen que queda vacío o no es un enlace válido simplemente se omite.

En el texto del mensaje de un código de embed y en el texto de un diseño V2, un `!` antes de una mención (`!@everyone`, `!@Rol`, `!<@&id>`, `!{user.mention}`) la muestra sin avisar a nadie, y `\!@everyone` muestra el texto. En el título, la descripción, los campos y el pie de un embed una mención nunca avisa, así que el `!` solo se quita. Mira [Menciones silenciosas](https://wiki.petto.sbs/es/concepts/variables-engine.md#menciones-silenciosas).


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