Probador de Webhooks de Discord

Prueba tu webhook de Discord en segundos. Pega la URL, valídala y envía un mensaje de prueba para asegurarte de que funciona.

¿Qué es un webhook de Discord?

Un webhook de Discord es una URL única que te permite enviar mensajes a un canal concreto de Discord sin necesidad de un bot. Los webhooks se usan habitualmente para notificaciones de GitHub, alertas de monitorización de servidores, actualizaciones de pipelines CI/CD e integraciones propias. Cada webhook tiene su propio nombre y avatar, y está vinculado a un canal concreto.

Cómo crear un webhook de Discord

1. Abre tu servidor de Discord y ve a Ajustes del servidor
2. Entra en Integraciones > Webhooks
3. Haz clic en Nuevo webhook
4. Ponle un nombre y elige el canal de destino
5. Haz clic en Copiar URL del webhook
6. Pega la URL en el probador de arriba para comprobar que funciona

Cómo funciona este probador

Pega tu URL de webhook y haz clic en Comprobar. La herramienta valida la URL contra la API de Discord y muestra el nombre, el avatar y el canal vinculado del webhook. Si es válida, puedes escribir un mensaje personalizado y enviarlo por el webhook para confirmar que funciona. Tu URL de webhook pasa por nuestro servidor por seguridad (los navegadores no pueden llamar a la API de Discord directamente por CORS), pero nunca se almacena ni se registra.

Códigos de error habituales de los webhooks de Discord

Cuando una petición de webhook falla, Discord devuelve un estado HTTP con un cuerpo JSON que contiene un code numérico y un message. Estos son los que te vas a encontrar de verdad:

• 400 Bad Request - Cuerpo JSON mal formado, el embed supera los 6.000 caracteres en total, o la longitud de un campo excede su límite. Valida tu payload en local antes de enviarla.
• 401 Unauthorized - El token del webhook es incorrecto o se ha regenerado. Regenerar un webhook en los ajustes del servidor invalida la URL antigua de inmediato.
• 404 Not Found - El webhook se eliminó, el canal se eliminó, o la URL tiene una errata. Vuelve a copiar la URL desde Ajustes del servidor > Integraciones.
• 429 Too Many Requests - Has alcanzado un límite de peticiones. Discord devuelve un campo retry_after (en segundos) que te indica cuándo reintentar. Respétalo.
• Code 50027 (Invalid Webhook Token) - La misma causa que el 401; se devuelve cuando el segmento del token de la URL está dañado o truncado.
• Code 50006 (Cannot send empty message) - Tu payload no tiene content, ni embeds, ni files. Al menos uno es obligatorio.
• Code 50035 (Invalid Form Body) - Causa más común: embed.color enviado como cadena hexadecimal en lugar de como entero decimal. Convierte #9B59B6 en 10181046 antes de enviarlo.

Límites de peticiones de los webhooks de Discord

Discord aplica límites de peticiones por webhook y por canal, y el tamaño exacto de cada bucket se determina en el servidor y se expone en las cabeceras de respuesta, no como una cifra fija. Toda respuesta correcta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset-After: léelas para planificar tu siguiente petición y no fijes una tasa en el código. El cuerpo de una respuesta 429 también incluye un valor retry_after (en segundos). Para integraciones de gran volumen (pipelines de compilación, agregación de logs), agrupa varios eventos en un solo mensaje: una llamada de webhook admite hasta 10 embeds con hasta 6.000 caracteres combinados por embed, que suele bastar para consolidar una ráfaga de eventos en una sola petición.

Buenas prácticas de seguridad para webhooks

Una URL de webhook es una credencial de portador. Cualquiera que tenga la URL completa puede publicar en tu canal como el bot del webhook, sin más autenticación. Trátala como una contraseña:

• No subas nunca URL de webhook a un repositorio Git público. El escaneo de secretos de GitHub detecta y revoca automáticamente los webhooks de Discord filtrados, pero solo después de que ya se hayan expuesto.
• Guarda las URL de webhook en variables de entorno o en un gestor de secretos, no en el código fuente ni en archivos de configuración bajo control de versiones.
• Si un webhook queda expuesto, elimínalo de inmediato en Ajustes del servidor > Integraciones > Webhooks. Al recrearlo se genera un token nuevo; la URL antigua deja de funcionar.
• Para uso en el cliente (una aplicación de navegador que publica en Discord), redirige la llamada por tu propio backend para que la URL nunca llegue al navegador del usuario. Una URL filtrada desde una aplicación de navegador es un imán para el vandalismo.
• Los webhooks de Discord ignoran las menciones @everyone y @here salvo que allowed_mentions las permita explícitamente. Pon "parse": [] para desactivar todos los pings de mención si no los necesitas.

Prueba manual de un webhook con curl

Si prefieres probar desde la terminal, la payload mínima es un único campo content. Un POST correcto devuelve HTTP 204 con el cuerpo vacío, o HTTP 200 con el JSON del mensaje creado si añades ?wait=true a la URL. Usa ?wait=true cuando necesites recuperar el ID del mensaje (por ejemplo, para editarlo o borrarlo después con el endpoint /webhooks/<id>/<token>/messages/<message_id>).

Más herramientas gratuitas para Discord

• Snowflake Checker - Consulta la antigüedad de cualquier cuenta de Discord
• Colored Text Generator - Crea mensajes con color usando códigos ANSI
• Message Length Counter - Comprueba si tu mensaje cabe en los límites de Discord
• Color Role Previewer - Previsualiza colores de rol en todos los temas de Discord

Con la tecnología de Pigona - Traducción gratuita para Discord