> ## 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. # Roles por reacción > Menús de roles en cualquier mensaje: los miembros reaccionan o pulsan un botón para recibir un rol, con modos alternar, solo dar y solo quitar. ## Resumen Crea menús de roles flexibles sin comandos de barra. Petto admite las reacciones clásicas con emoji y botones en los que se puede hacer clic, con un comportamiento independiente de alternar, solo dar o solo quitar para cada rol vinculado. Úsalos para que los miembros elijan sus colores, avisos o intereses, o para dar el rol de miembro cuando alguien acepta las reglas. Lo más rápido es el creador del dashboard; los comandos también funcionan en cualquier mensaje. ## Comandos ```javascript Sintaxis theme={null} !reactionrole add [channel] [mode] [type] [label] !reactionrole remove [channel] !reactionrole list [channel] !reactionrole clear [channel] ``` ```javascript Ejemplo theme={null} !reactionrole add 123456789012345678 🎮 @Gamer #general toggle !reactionrole list 123456789012345678 !reactionrole add 123456789012345678 :joystick: @Gamer #general toggle button Gamer ``` > [accordion] !reactionrole add (reacción) > > ![kira vincula 🎮 en un mensaje del canal de roles al rol Eventos y Petto lo confirma en modo toggle](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-add-reaction.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=d37d1cea423fae9aba0794f2b017dfd3) > > En Discord: un emoji de un mensaje vinculado a un rol. > [accordion] !reactionrole add (botón) > > ![liam agrega un botón 🏆 para Cazadores de misiones al menú de colores y Petto confirma el rol del botón](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-add-button.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=3928cf2a7f76159679855ed6404f2fff) > > En Discord: un botón agregado al menú de colores. > [accordion] !reactionrole remove > > ![liam quita el vínculo 🎉 del menú de colores, Petto lo confirma, y el mismo comando otra vez dice que ese emoji no estaba vinculado](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-remove.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=b26a79e57ee5f029e6d3210143fbed77) > > En Discord: un vínculo quitado, y la respuesta cuando el emoji ya no está vinculado. > [accordion] !reactionrole list > > ![chu lista el menú de colores y Petto responde con sus cinco roles por botón y su modo](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-list.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=4e328790ae00bbdd64f56c01b9345183) > > En Discord: los roles de un mensaje, listados con !rr. > [accordion] !reactionrole clear > > ![liam limpia el mensaje de avisos y Petto dice que quitó tres vínculos](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-clear.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=dffed4f15b8b3e4838b4ceccafb0d5a4) > > En Discord: todos los vínculos de un mensaje quitados de una vez. > [accordion] Cuando no funciona > > ![Petto rechaza 🔴 porque ya está vinculado, dice que no encuentra un mensaje y avisa a nova del permiso manage\_roles que le falta](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-errors.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=5866ca3b0eb920a33f3034e9826f5521) > > En Discord: un emoji ya vinculado, un mensaje que no se encuentra y un miembro sin Gestionar roles. `channel` es el canal actual por defecto. `emoji` acepta tanto emojis personalizados como los de por defecto. `type` es `reaction` por defecto. Usa `button` para convertir el mensaje en un menú de roles con botones; un mensaje puede tener hasta 25 botones de Petto en cinco filas. `label` es el texto del botón y por defecto es el nombre del rol. El modo de botón no se puede agregar a un mensaje que ya tiene otro panel de componentes, como un panel de tickets o de VoiceMaster. Nombre corto: `!rr`. `!reactionroleconfig` muestra todos los roles por reacción y por botón del servidor y los comandos para cambiarlos. ![Petto lista los nueve roles vinculados de Petto Land con su canal, emoji, rol y modo, y después los comandos de reactionrole](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-config.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=186ddd746b28e465769e631c5ce20553) En Discord: la tarjeta de !reactionroleconfig con los roles de Petto Land y los comandos. ## Creador en la dashboard La forma más rápida de hacer un menú de roles es el creador de la dashboard: **Automatización → Roles por reacción → Crear un menú de roles con embed y botones**. **1. Elige el canal y escribe el mensaje** Elige dónde se publica el mensaje, luego agrega texto y un embed (título, descripción, color, pie, miniatura e imagen). Puedes cargar un embed guardado del generador de embeds como punto de partida, y un enlace abre el generador. ![El creador con #roles elegido y el panel Mensaje: un embed guardado para empezar, el contenido y el embed con su título, descripción y color](https://mintcdn.com/wikipetto/1Wz8dc-Kr9ITtTNY/images/dashboard/automation/es/reaction-roles-builder-message.webp?fit=max\&auto=format\&n=1Wz8dc-Kr9ITtTNY\&q=85\&s=9c40030ede8786a1d09fba177c434ea5) Dashboard → Automatización → Roles por reacción → Crear reaction role: el canal y el mensaje, con el embed del menú de colores. **2. Agrega filas de botones** Cada fila tiene hasta 5 botones y un mensaje tiene hasta 5 filas (25 botones). Para cada botón elige un nombre (o **Vacío (solo el emoji)** para mostrar solo el emoji), un color (Azul, Gris, Verde o Rojo), el rol, el comportamiento (alternar, solo dar o solo quitar) y un emoji opcional. ![La fila 1 del creador con los botones Rojo, Azul y Verde, su color, rol, comportamiento alternar y emoji, y las herramientas para moverlos, copiarlos y quitarlos](https://mintcdn.com/wikipetto/1Wz8dc-Kr9ITtTNY/images/dashboard/automation/es/reaction-roles-builder-buttons.webp?fit=max\&auto=format\&n=1Wz8dc-Kr9ITtTNY\&q=85\&s=f4f5aea6b5f65e6a816c51623a7d0d76) Dashboard → Automatización → Roles por reacción → Crear reaction role: las filas de botones, cada uno con su nombre, color, rol, comportamiento y emoji. **3. Elige los emojis** El selector de emojis tiene una pestaña **Servidor** con tus emojis personalizados y una pestaña **Unicode**, ambas con búsqueda. ![La ventana Elegir emoji con las pestañas Servidor y Unicode, la búsqueda y la cuadrícula de emojis](https://mintcdn.com/wikipetto/1Wz8dc-Kr9ITtTNY/images/dashboard/automation/es/reaction-roles-builder-emoji.webp?fit=max\&auto=format\&n=1Wz8dc-Kr9ITtTNY\&q=85\&s=0d428dc48a3a89edda80725e82ed31fd) Dashboard → Automatización → Roles por reacción → Crear reaction role: el selector de emojis en su pestaña Unicode. **4. Guarda** La barra de cambios sin guardar aparece mientras editas. Al guardar se publica el mensaje, o se edita cuando abriste un menú existente. ![La vista previa del menú de colores con sus cinco botones, el botón Crear reaction role y la barra Tienes cambios sin guardar](https://mintcdn.com/wikipetto/1Wz8dc-Kr9ITtTNY/images/dashboard/automation/es/reaction-roles-builder-save.webp?fit=max\&auto=format\&n=1Wz8dc-Kr9ITtTNY\&q=85\&s=068952baf4ade44ce2abe73a0bcd4fae) Dashboard → Automatización → Roles por reacción → Crear reaction role: la vista previa del mensaje, el botón que lo publica y la barra de cambios sin guardar. ![El menú Elige tu color en el canal de roles con los botones Rojo, Azul, Verde, Morado y Eventos](https://mintcdn.com/wikipetto/Z-XTVemdYTr1KRaH/images/discord/automation/es/reaction-roles.webp?fit=max\&auto=format\&n=Z-XTVemdYTr1KRaH\&q=85\&s=1c1f27abf20768d7385cfc69a9d15492) En Discord: un menú de roles con un embed y dos filas de botones, como lo publica el creador. Los botones se pueden mover a la izquierda o a la derecha, duplicar (la copia no tiene emoji hasta que elijas uno, porque cada botón de un mensaje necesita uno distinto) y las filas se pueden mover arriba o abajo. Para cambiar un menú después, ábrelo desde la lista en **Roles por reacción** con **Editar el mensaje en el creador**. ![La lista Roles por reacción de Petto Land con nueve vínculos, el botón Rojo abierto para editar y el formulario para agregar uno](https://mintcdn.com/wikipetto/1Wz8dc-Kr9ITtTNY/images/dashboard/automation/es/reaction-roles-list-dashboard.webp?fit=max\&auto=format\&n=1Wz8dc-Kr9ITtTNY\&q=85\&s=fd550d762608977799b0b3fa6fe1ec53) Dashboard → Automatización → Roles por reacción: los roles vinculados del servidor, uno abierto con Editar el mensaje en el creador. > [!NOTE] > > El creador funciona con embeds clásicos. Los mensajes de Components V2 no pueden tener botones de roles. El mismo selector de emojis se usa en Reacciones a mensajes, Activadores de reacción, Starboard, Tickets, Botones con respuesta y Partners. ## Botones desde comandos `!reactionrole add` también acepta `embed` (con `message_id` en `new`, publica un mensaje a partir de un embed guardado), `style` (color del botón) y `row` (1 a 5), para que los menús hechos con comandos puedan usar la misma disposición. ![liam publica el embed giveaway-pings en #roles con un botón Sorteos y Petto responde con el enlace del mensaje y cómo agregar más botones](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-new-message.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=453a8239bc51b3f10fede2487c14bcdc) En Discord: un mensaje nuevo publicado desde un embed guardado, con su primer botón. ## Ejemplos > [tab] Roles de color con botones > > **1. Crea el mensaje del menú** > > ```javascript Comando theme={null} > !embed create color-roles {embed}$v{title: 🎨 Elige tu color}$v{description: Pulsa un botón para recibir un color, y púlsalo otra vez para quitarlo.}$v{color: #f0a88f} > ``` > > ![liam crea color-roles desde un código y Petto muestra el embed Elige tu color](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-example-embed.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=c17c7a200a4ce4c064bbf94a8012fc16) > > En Discord: el embed guardado del menú, hecho con !embed create. > > **2. Publícalo con el primer botón** > > ```javascript Comando theme={null} > !reactionrole add new 🔴 @Red #roles --embed color-roles --label Rojo --style 4 > ``` > > `new` publica el embed guardado en `#roles` y le pone el botón. Copia el ID de ese mensaje para los siguientes botones. > > ![Petto publica Elige tu color con un botón rojo Rojo y responde con el enlace del mensaje](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-example-first-button.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=09af18be33f44ed0b83136b1a04c0fe3) > > En Discord: el embed publicado en #roles con su botón Rojo. > > **3. Agrega los otros botones** > > ```javascript Comando theme={null} > !reactionrole add 123456789012345678 🔵 @Blue #roles --type button --label Azul --style 1 > ``` > > ![El menú ahora tiene los botones Rojo y Azul, después de que liam agrega el azul con --style 1](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-example-more-buttons.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=1c82480044f38e23028673c0273d6131) > > En Discord: el mismo mensaje con su segundo botón, Azul. > > `style` es el color del botón: `1` azul (blurple), `2` gris, `3` verde, `4` rojo. > [tab] Roles de aviso con reacciones > > ```javascript Comandos theme={null} > !reactionrole add 123456789012345678 📢 @Announcements #roles > !reactionrole add 123456789012345678 🎉 @Events #roles > !reactionrole add 123456789012345678 🎁 @Giveaways #roles > ``` > > Los miembros reaccionan para recibir el rol y quitan su reacción para perderlo. > > ![Un mensaje en #roles que explica los avisos, con las reacciones 📢, 🎉 y 🎁 y cuántos miembros eligieron cada una](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-example-pings.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=ae66decb2e0bf1a46e63ef7edd648b3e) > > En Discord: el mensaje de avisos con las tres reacciones que usan los miembros. > [tab] Aceptar las reglas > > ```javascript Comando theme={null} > !reactionrole add 123456789012345678 ✅ @Member #rules add > ``` > > El modo `add` solo da el rol: quitar la reacción no lo quita, así que los miembros no pueden perder el acceso por error. > > ![liam vincula ✅ en el mensaje de las reglas al rol Miembros en modo add y Petto lo confirma](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-accept-rules.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=c4969a051cc2e912fea1b8cf43d20e65) > > En Discord: ✅ en el mensaje de las reglas, en modo add. Un embed guardado publicado con `new` puede usar [variables](https://wiki.petto.sbs/es/resources/scripting/variables.md), que se llenan para quien usa el comando, así que las del servidor como `{server_name}` o `{server_membercount}` son las que más sentido tienen ahí. ## Modos > [accordion] Alternar (por defecto) > > Reaccionar da el rol, y reaccionar otra vez lo quita. > > ![El menú de colores y las dos respuestas privadas de Petto, se agregó Rojo y se quitó Rojo](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-press-toggle.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=6f4c85ca8bd38e7a900cbdbe043c28f1) > > En Discord: nova pulsa Rojo dos veces: recibe el rol y luego se le quita. Solo nova ve las respuestas. > [accordion] Solo dar > > Reaccionar da el rol, y quitar la reacción no hace nada. > > ![Mia pulsa Eventos, Petto dice que le dio el rol, y la segunda vez dice que ya lo tiene](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-press-add-only.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=f792f1f9fcfe4080817a86e0ef80c362) > > En Discord: Eventos en modo solo dar: la segunda pulsación no quita el rol. > [accordion] Solo quitar > > Reaccionar quita el rol; útil junto con un rol que los miembros tienen desde el inicio. > > ![tommy pulsa el botón rojo Sin avisos de eventos, Petto le quita Eventos, y la segunda vez dice que no lo tiene](https://mintcdn.com/wikipetto/wamA7GwMGpN2qRGP/images/discord/automation/es/reaction-roles-press-remove-only.webp?fit=max\&auto=format\&n=wamA7GwMGpN2qRGP\&q=85\&s=a4a0d788b0ac72d33e73eb3855acf5bc) > > En Discord: un botón Sin avisos de eventos en modo solo quitar: solo quita el rol. Los botones siguen los mismos modos y Petto le responde al miembro en privado (solo él lo ve). Con reacciones Petto no dice nada: el rol simplemente cambia. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.