Webhook de Discord: crea uno y envía mensajes

Guía de webhooks de Discord

Webhook de Discord: crea uno, payload JSON, embeds | We.Inc

Crea un webhook de Discord, construye el payload JSON (content, username, avatar_url, embeds) con los límites de caracteres en vivo y copia código listo en curl, JavaScript y Python.

Un webhook de Discord es una URL secreta vinculada a un canal. Haz un POST con un cuerpo JSON que lleve content (hasta 2000 caracteres), embeds (hasta 10) o ambos, y el mensaje aparece en ese canal con el nombre del webhook. No hace falta bot ni inicio de sesión, y por eso también cualquiera que tenga la URL puede publicar.

Los campos de Execute Webhook que más vas a usar

Campo
Tipo
Notas

Texto del mensaje, hasta 2000 caracteres

Sustituye el nombre del webhook en este mensaje

Sustituye el avatar del webhook en este mensaje

Hasta 10 objetos embed enriquecidos

Limita qué @menciones notifican de verdad

thread_id (query)
Publica en un hilo del canal

wait (query)
true devuelve el mensaje creado en lugar de 204

Los webhooks son la forma más rápida de enviar alertas, envíos de formularios o avisos de despliegue a un canal de Discord. El generador de abajo escribe el JSON por ti, cuenta los caracteres frente a los límites de Discord mientras escribes y convierte el resultado en curl, JavaScript y Python que puedes pegar en un script o un servidor. No envía nada por sí mismo, así que tu URL de webhook nunca sale de tu máquina.

En los ajustes de tu servidor de Discord, crea un webhook para el canal en el que quieres publicar.
Elige el canal, pon un nombre y un avatar y copia la URL del webhook.
Rellena el generador de abajo y copia el código generado.
Ejecútalo desde un terminal o tu servidor con la URL en una variable de entorno.

Trata la URL como una contraseña. Guárdala en una variable de entorno y fuera del código front-end y de los repositorios públicos.
Si una URL se filtra, borra ese webhook en los ajustes de tu servidor y crea uno nuevo; la URL antigua deja de funcionar.
Pon allowed_mentions en { "parse": [] } cuando el contenido incluya datos introducidos por usuarios, para que nadie pueda disparar @everyone.
Añade ?wait=true cuando necesites recibir el id del mensaje, por ejemplo para editarlo o borrarlo después.
El color del embed es un entero decimal, así que el color hex 4F98FB se envía como 5216507.

Preguntas frecuentes

¿Cómo consigo la URL de un webhook de Discord?

Necesitas el permiso Gestionar webhooks en el servidor o el canal. En los ajustes de tu servidor de Discord, crea un webhook para el canal y copia su URL.

¿Por qué mi webhook devuelve 400 Bad Request?

Normalmente el cuerpo está vacío o no es válido. Debes enviar al menos uno de estos: content, embeds, components, un archivo o una encuesta, y content debe tener 2000 caracteres o menos. Envía también la cabecera Content-Type: application/json; si no, el cuerpo no se lee como JSON.

¿Puedo usar un webhook de Discord desde el navegador?

No lo hagas. Cualquier página que lo haga expone la URL a todos sus visitantes, que podrán publicar lo que quieran en tu canal. Envía desde un servidor, una función serverless o un script, y haz que tu página use eso en su lugar.

¿Cuáles son los límites de los embeds?

Discord documenta un título de hasta 256 caracteres, valores de campo de hasta 1024 caracteres y un total combinado de 6000 caracteres entre título, descripción, nombres y valores de campos, texto del pie y nombre del autor en todos los embeds de un mensaje.

¿Puede un webhook leer mensajes o responder a usuarios?

No. Un webhook solo puede publicar (y editar o borrar sus propios mensajes). Leer canales, reaccionar a comandos o responder a personas necesita una aplicación bot.

Qué contiene la URL

Una URL de webhook termina en dos partes: el id del webhook y su token. El token es la única credencial, por eso la documentación de Discord indica que ejecutar un webhook no necesita ninguna otra autenticación. Cualquiera con la URL completa tiene el mismo poder que tú.

Content, embeds o ambos

El content simple va bien para alertas cortas y admite el markdown de Discord. Los embeds te dan una barra lateral de color, un título con enlace, campos colocados en columnas y un pie, lo que se lee mejor con datos estructurados como un pedido o un informe de error.
Puedes enviar ambos en una sola petición. El content aparece encima de los embeds, y allowed_mentions decide si los nombres que incluye notifican de verdad a alguien.

Enviar en volumen

Cuando envías demasiado rápido, Discord responde con un estado 429 y un valor JSON retry_after en segundos. Respétalo y pon los mensajes en cola en lugar de reintentar en un bucle cerrado. Agrupar varios eventos en un mensaje con varios embeds también reduce el número de peticiones.

Peticiones listas para usar

curl: un mensaje simple

La URL se lee de una variable de entorno para que nunca acabe en el historial de tu shell ni en un commit.

Node.js: un embed con campos

Usa el fetch integrado de Node 18 y posteriores. wait=true hace que Discord devuelva el mensaje para que puedas registrar su id.

Python con requests

json= define la cabecera Content-Type por ti. Un estado 204 significa que el mensaje se publicó.

Generador de payload para webhooks de Discord

Escribe tu mensaje y tu embed, vigila el recuento de caracteres y copia el JSON o el código. Desde esta página no se envía nada.

Contenido del mensaje

Nombre de usuario personalizado

URL de avatar personalizada

Añadir un embed

Título del embed

Descripción del embed

Color del embed

Texto del pie

Bloquear todas las menciones (allowed_mentions parse: [])

Caracteres del embed: {n} / 6000

Por encima del límite: Discord lo rechazará.

Vacío: añade contenido o un embed.

Formato de salida

Vista previa aproximada

Webhook

Empieza gratis · Sin tarjeta de crédito