Las acciones de componentes te permiten decidir qué hace Nekotina cuando alguien pulsa un botón en un mensaje. Puedes usarlas para responder, editar mensajes, enviar mensajes a un canal, mandar mensajes directos, cambiar roles, borrar el mensaje original o crear un hilo privado.
Por ejemplo, puedes crear un mensaje con botones como estos:
[ Recibir anuncios ] [ Abrir ticket ] [ Ver normas ]
Cada botón puede abrir un enlace o ejecutar una acción configurada desde el dashboard.
Para crear o editar acciones de componentes:
También puedes crear una acción nueva mientras editas un botón desde otros módulos del dashboard. En ese caso, primero se guarda el nombre de la acción y luego puedes entrar a editar sus pasos.
Las acciones de componentes se vinculan a botones dentro de mensajes configurables. Puedes encontrarlas en secciones que permiten añadir botones, como mensajes de bienvenida, respuestas automáticas, mensajes recurrentes, tags, comandos personalizados y el constructor de mensajes.
Un botón puede funcionar de dos formas:
| Tipo de botón | Qué hace |
|---|---|
| Enlace | Abre una URL en el navegador. |
| Acción | Ejecuta una acción de servidor configurada en Nekotina. |
Los botones de enlace no necesitan una acción. Los botones de acción sí deben apuntar a una acción existente o a una acción nueva que crearás desde el editor.
| Plan | Pasos por acción |
|---|---|
| Gratis | 1 |
| Premium | 10 |
También hay límites dentro de los mensajes con botones:
| Elemento | Límite |
|---|---|
| Filas de botones por mensaje | 5 |
| Botones por fila | 5 |
| Acciones encadenadas | 5 |
| Enfriamiento mínimo | 0 segundos |
| Enfriamiento máximo | 300 segundos |
| Embeds por mensaje | 10 |
Cada acción solo puede usarse en un botón del mismo mensaje. Esto evita que dos botones del mismo mensaje intenten ejecutar exactamente la misma acción.
El nombre se muestra en la lista de acciones y al elegir qué acción usará un botón.
Ejemplos:
| Nombre | Uso recomendado |
|---|---|
| Dar rol de anuncios | Botón para recibir o dejar de recibir avisos. |
| Abrir hilo privado | Botón para iniciar una conversación privada. |
| Ver normas | Botón que responde con información del servidor. |
Usa nombres cortos y fáciles de reconocer. Si tienes muchos botones, un buen nombre te ayudará a encontrar la acción correcta rápidamente.
Puedes dejar la acción disponible para todos o limitarla por canales y roles.
| Opción | Para qué sirve |
|---|---|
| Canales permitidos | La acción solo funciona si el botón se pulsa desde esos canales. |
| Canales ignorados | La acción no funciona en esos canales. |
| Roles permitidos | Solo quienes tengan uno de esos roles pueden usar la acción. |
| Roles ignorados | Quienes tengan esos roles no pueden ejecutar la acción. |
Si dejas las listas vacías, Nekotina usará el comportamiento más abierto posible.
Los enfriamientos evitan que una acción se ejecute demasiadas veces seguidas.
| Tipo | Ejemplo |
|---|---|
| Por usuario | Cada persona debe esperar 10 segundos antes de volver a pulsar un botón que usa esa acción. |
| Por servidor | Todo el servidor debe esperar 30 segundos antes de que la acción pueda ejecutarse otra vez. |
Usa 0 para desactivar un enfriamiento.
Una acción se compone de uno o varios pasos. Nekotina ejecuta los pasos en orden.
Ejemplo:
Listo, ya recibirás avisos.En servidores gratis, cada acción puede tener 1 paso. En servidores premium puedes encadenar varios pasos dentro de la misma acción.
Envía una respuesta cuando alguien pulsa el botón.
Puedes usarlo para:
Ejemplo:
Listo, te he dado el rol de anuncios.
Puedes marcar la respuesta como Efímera para que solo la vea la persona que pulsó el botón.
Edita el mensaje donde estaba el botón.
Puede servir para:
Úsalo con cuidado si muchas personas interactúan con el mismo mensaje, porque el cambio será visible para todos.
Envía un mensaje a un canal específico.
Puede servir para:
Debes elegir el canal donde Nekotina enviará el mensaje. La bot necesita permisos para ver el canal y enviar mensajes allí.
Envía un mensaje privado a la persona que pulsó el botón.
Puede servir para:
Ten en cuenta que Discord puede bloquear mensajes directos si el usuario tiene su privacidad cerrada.
Elimina el mensaje donde se pulsó el botón.
Puede servir para:
Para que funcione, Nekotina necesita permisos para gestionar mensajes en ese canal.
Añade uno o varios roles a la persona que pulsó el botón.
Uso común:
[ Recibir anuncios ]
Al pulsarlo, Nekotina da el rol configurado.
La bot necesita permiso para gestionar roles, y su rol debe estar por encima de los roles que intentará añadir.
Quita uno o varios roles a la persona que pulsó el botón.
Uso común:
[ Dejar de recibir anuncios ]
Al pulsarlo, Nekotina retira el rol configurado.
Añade el rol si el usuario no lo tiene, o lo quita si ya lo tiene.
Uso común:
[ Anuncios ]
Este tipo de paso es útil para menús de roles simples, porque un solo botón puede activar y desactivar la misma opción.
Crea un hilo privado en el mensaje donde se pulsó el botón.
Puede servir para:
Puedes configurar el nombre del hilo y un mensaje inicial. En el nombre y en el mensaje puedes usar variables como el nombre del usuario o el nombre de la acción.
Los pasos que envían o editan mensajes pueden incluir contenido, embeds y botones.
El contenido es el texto principal del mensaje.
Ejemplo:
Hola {{user.name}}, el staff recibió tu solicitud.
Puedes combinar texto normal con variables.
Los embeds permiten crear mensajes más visuales con título, descripción, color, imágenes y campos.
Úsalos cuando quieras:
Puedes combinar texto y embeds, o usar solo embeds.
Un paso de mensaje también puede incluir botones. Esos botones pueden abrir enlaces o apuntar a otras acciones.
Ejemplo:
[ Ver normas ] [ Contactar staff ]
Esto permite crear flujos encadenados: una acción responde con un mensaje que contiene botones, y esos botones ejecutan otras acciones.
La cadena no puede superar 5 acciones para evitar ciclos o flujos demasiado largos.
Cuando editas un botón, puedes elegir su estilo.
| Estilo | Uso recomendado |
|---|---|
| Primario | Acción principal o destacada. |
| Secundario | Acción normal o neutral. |
| Éxito | Confirmar, aceptar o activar algo. |
| Peligro | Cancelar, borrar, cerrar o quitar algo. |
| Enlace | Abrir una URL externa. |
El estilo de enlace siempre necesita una URL. Los demás estilos pueden ejecutar acciones de servidor.
Cada botón debe tener al menos texto o emoji.
Ejemplos válidos:
| Texto | Emoji | Resultado |
|---|---|---|
Recibir anuncios |
vacío | Botón con texto. |
| vacío | 🔔 |
Botón solo con emoji. |
Anuncios |
🔔 |
Botón con texto y emoji. |
El texto puede tener hasta 100 caracteres. Para que el botón se vea bien en Discord, conviene usar frases cortas.
Puedes usar variables en los mensajes de una acción para mostrar información dinámica.
| Variable | Qué representa |
|---|---|
{{user.mention}} |
Mención de la persona que pulsó el botón. |
{{user.id}} |
ID de Discord de esa persona. |
{{user.name}} |
Nombre visible de esa persona. |
{{server.name}} |
Nombre del servidor. |
{{server.id}} |
ID del servidor. |
{{server.icon}} |
URL del icono del servidor. |
{{server.members}} |
Cantidad actual de miembros. |
{{channel.name}} |
Nombre del canal donde se pulsó el botón. |
{{channel.id}} |
ID del canal. |
{{action.name}} |
Nombre de la acción ejecutada. |
{{roles}} |
Lista de roles afectados en pasos de roles. |
{{date}} |
Fecha actual. |
Ejemplo:
{{user.mention}}, ya actualicé tus roles en {{server.name}}.
En los pasos de mensaje puedes decidir qué menciones interpretará Discord.
| Opción | Resultado |
|---|---|
| Usuarios | Permite mencionar usuarios. |
| Roles | Permite mencionar roles. |
| @everyone y @here | Permite menciones masivas. |
Si no marcas ninguna opción, las menciones quedan desactivadas.
Activa solo las menciones que realmente necesites. Para mencionar @everyone, @here o roles no mencionables, tu cuenta debe tener permiso suficiente.
Objetivo: permitir que los miembros activen o desactiven un rol.
Alternar anuncios.Alternar anuncios.Texto sugerido del botón:
Anuncios
Objetivo: crear una conversación separada desde un mensaje.
Abrir solicitud.Solicitud - {{user.name}}.Mensaje inicial sugerido:
{{user.mention}}, cuéntanos qué necesitas. El staff revisará tu solicitud pronto.
Objetivo: que el usuario vea una confirmación sin llenar el canal.
Confirmar lectura.Respuesta sugerida:
Listo, registré tu confirmación.
Revisa que el botón esté vinculado a una acción existente. Si el editor muestra que la acción no existe, reemplázala por otra o crea una nueva.
Es intencional. Cada acción solo puede usarse una vez dentro del mismo mensaje. Crea una acción separada si necesitas dos botones parecidos.
Comprueba que Nekotina tenga permiso para gestionar roles y que su rol esté por encima de los roles que quieres modificar.
Es posible que la persona tenga los mensajes directos cerrados para ese servidor. En ese caso, Discord impide que Nekotina le escriba por privado.
Revisa que Nekotina tenga permiso para gestionar mensajes en el canal donde está el botón.
Comprueba que Nekotina pueda ver el canal, crear hilos privados y enviar mensajes en hilos.
Revisa la sección Menciones permitidas del paso. Si no permites menciones de usuarios, roles o @everyone, Discord las mostrará como texto normal o no las notificará.
| Idea | Pasos recomendados |
|---|---|
| Panel de autoroles | Alternar roles + respuesta efímera. |
| Solicitud privada | Crear hilo privado + mensaje inicial. |
| Botón de normas | Responder con mensaje efímero o editar mensaje original. |
| Aviso al staff | Enviar mensaje a canal. |
| Confirmación personal | Responder con mensaje efímero. |
| Botón para dejar un rol | Quitar roles + respuesta efímera. |
Las acciones de componentes convierten los botones en flujos interactivos. Primero creas una acción de servidor, luego defines sus pasos y finalmente la vinculas a un botón en un mensaje.
Para empezar de forma sencilla, crea una acción con un solo paso y una respuesta efímera. Cuando ya tengas el flujo claro, puedes añadir roles, mensajes a canales, hilos privados o más botones para construir interacciones más completas.