Webhooks de Discord
Incluida en Macro DeckPublica mensajes enriquecidos con embeds y menciones en canales de Discord mediante webhooks, con vista previa en directo.
El cuadro de diálogo Añadir un webhook de Discord con los campos Nombre y URL del webhook
- Guarda webhooks con un nombre, uno por canal
- Editor visual con una vista previa que se ve como Discord
- Hasta 10 embeds con campos, imágenes, autor y pie
- Las menciones no notifican a nadie salvo que lo permitas
- Las variables de plantilla se rellenan al ejecutarse la acción
Un webhook de Discord permite que cualquier cosa que conozca su URL publique en un canal de Discord. La integración Webhooks de Discord guarda webhooks con un nombre y te ofrece una acción, Enviar mensaje por webhook de Discord, con un editor visual para el mensaje. No necesita la aplicación de Discord ni una cuenta de Discord en el ordenador que ejecuta Macro Deck.
Qué puedes enviar
El editor tiene cuatro pestañas:
- Mensaje: el texto del mensaje con Markdown de Discord y saltos de línea, además de botones que insertan una mención de usuario o de rol,
@everyoneo@here. - Embeds: hasta 10 embeds, cada uno con título y enlace del título, descripción, color, marca de tiempo, autor, pie, imagen, miniatura y hasta 25 campos que se pueden mostrar uno al lado de otro.
- Perfil: un nombre de usuario y un avatar para este mensaje en lugar de los del propio webhook.
- Menciones: a quién pueden notificar las menciones del mensaje.
De forma predeterminada, un mensaje no notifica a nadie, aunque mencione a alguien, a @everyone o a @here. La mención se sigue viendo en Discord, solo que no avisa. Todos los campos de texto aceptan variables de plantilla, que se rellenan cuando se ejecuta la acción, así que un mensaje puede incluir la escena actual, la canción o el número de espectadores.
La vista previa bajo el editor cambia mientras escribes y muestra el mensaje tal como lo dibuja Discord. Nunca envía nada a Discord. Las imágenes se muestran como marcadores de posición y las variables aparecen tal como las escribiste. Enviar mensaje de prueba envía el mensaje a Discord al momento después de confirmar con Enviar ahora, para que compruebes cómo se ve de verdad.
Algunos ejemplos de configuración:
- Un botón En directo que publica un embed con el título y el enlace de tu stream en tu canal de anuncios.
- Un botón que publica la canción que está sonando en un canal de música.
- Una automatización que envía un mensaje a un canal de moderadores cuando pasa algo en tu stream.
Webhooks guardados y URL personalizadas
Añade una configuración por canal y luego elige el webhook por su nombre en cada acción. Cuando la URL cambia, la cambias en un solo sitio. Para un mensaje puntual también puedes poner Webhook en URL personalizada y pegar la URL en la acción. Macro Deck guarda cada URL de webhook cifrada, no la vuelve a mostrar y nunca la escribe en el registro.
Macro Deck comprueba los límites de Discord antes de enviar, por ejemplo 2000 caracteres de texto del mensaje y 6000 caracteres en todos los embeds juntos, y muestra cualquier problema encima de la vista previa mientras editas. Cuando Discord limita la frecuencia con la que un webhook puede publicar, Macro Deck espera y lo intenta una vez más si la espera es de 5 segundos o menos.
Qué necesitas
- Macro Deck 3 en Windows, macOS o Linux
- Conexión a internet en el ordenador que ejecuta Macro Deck
- Un canal de Discord en el que puedas gestionar webhooks, y su URL de webhook
Configúrala
Paso 1: Crea un webhook en Discord
En Discord, abre los ajustes del canal, ve a Integraciones y luego a Webhooks, y crea un webhook o elige uno. Haz clic en Copiar URL del webhook. La URL empieza por
https://discord.com/api/webhooks/. Cualquiera que la tenga puede publicar en el canal, así que trátala como una contraseña.Paso 2: Abre Webhooks de Discord en Macro Deck
En Macro Deck, haz clic en Integraciones en la barra lateral y después en Webhooks de Discord. En la pestaña Resumen, haz clic en Añadir configuración en la sección Configuración. Activar el interruptor de arriba a la derecha abre el mismo cuadro de diálogo.
Paso 3: Guarda el webhook
Rellena el cuadro de diálogo Añadir un webhook de Discord:
- Nombre: se muestra al elegir el webhook en una acción, por ejemplo el nombre del canal.
- URL del webhook: la URL que copiaste en Discord.
Haz clic en Continuar. Añade una configuración para cada canal adicional.
Paso 4: Añade la acción a un botón
En la página Deck, haz clic en el botón que quieras usar. El deck debe estar desbloqueado: cuando el botón de arriba a la derecha dice Bloquear, está desbloqueado. El editor se abre con Pulsación corta seleccionada. Haz clic en + Añadir acción, selecciona Webhooks de Discord a la izquierda del cuadro de diálogo Añadir acción y elige Enviar mensaje por webhook de Discord.
Paso 5: Escribe el mensaje
Elige el webhook guardado en Webhook. Escribe el Texto del mensaje en la pestaña Mensaje y, si quieres, añade embeds en la pestaña Embeds. Revisa la vista previa y haz clic en Enviar mensaje de prueba y Enviar ahora para ver el mensaje en Discord.
Paso 6: Pulsa el botón
Pulsa el botón en tu teléfono, tu tablet o en el cliente web. El mensaje aparece en el canal de Discord, con las variables rellenadas. Si no aparece, la acción muestra el motivo, por ejemplo que Discord rechazó el token del webhook.
Acciones1
Ponlas en un botón o ejecútalas desde un flujo.
- Enviar mensaje por webhook de Discord
- Envía un mensaje con embeds opcionales mediante un webhook de Discord guardado o personalizado, editado con una vista previa en directo.
Preguntas frecuentes
¿Cómo menciono a un usuario o a un rol?
Una mención necesita el ID de Discord. En Discord, activa el Modo desarrollador en los ajustes avanzados, haz clic derecho en el usuario o el rol y elige Copiar ID. En la pestaña Menciones, elige si se notifica a nadie, a todos los mencionados o solo a los ID que indiques.
¿Qué diferencia hay con la integración Discord?
La integración Discord tiene una acción más antigua, Ejecutar webhook, con un solo embed y sin vista previa. Sigue funcionando. Webhooks de Discord añade varios embeds, control de menciones, un perfil por mensaje y la vista previa en directo.
¿Dónde se guarda la URL del webhook?
Macro Deck la guarda cifrada en el ordenador que ejecuta Macro Deck. No se vuelve a mostrar, nunca se escribe en el registro y nunca forma parte de la vista previa. Para cambiarla, vuelve a introducirla. Solo se aceptan direcciones de webhooks de Discord en discord.com, discordapp.com, ptb.discord.com y canary.discord.com.
¿Por qué una variable no se rellena en mi mensaje de prueba?
Enviar mensaje de prueba envía las variables tal como están escritas. Solo se rellenan cuando la acción se ejecuta desde un botón, una automatización o un script.
¿Por qué falla la acción?
La acción muestra el motivo, por ejemplo que el mensaje está vacío o es demasiado largo, que el webhook ya no existe en Discord, que Discord rechazó el token del webhook o que Discord está limitando la frecuencia del webhook. Si se rechazó el token, vuelve a copiar la URL del webhook e introdúcela en la configuración.
¿Puedo editar el mensaje en la app Companion?
La app Companion y las aplicaciones de escritorio más antiguas muestran los ajustes simples de la acción, con el mensaje como claves y valores como content y embeds.0.title, y no guardan los cambios hechos en el editor visual. Edita los mensajes enriquecidos en la aplicación de escritorio actual.
