Publicar en un canal de Discord
Los embeds de Discord convierten una notificación plana en una tarjeta con título, color, campos y miniatura, pero conectar eso de forma confiable desde un backend suele implicar mantener un bot que no querías alojar. Este endpoint publica el embed por ti y lo rastrea como cualquier otra tarea.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Para comunidades y equipos que operan en Discord, no solo gamers
Discord dejó de ser solo una app de chat para gamers hace años; muchos proyectos de código abierto, equipos de SaaS pequeños y comunidades en línea llevan hoy todo su feed operativo por ahí. notify.discord es para el momento en que un proyecto necesita publicar una nota de versión, un estado de compilación o una alerta comunitaria en un canal sin levantar un proceso de bot permanente solo para hacer una llamada HTTP.
Qué se publica realmente
POST /notify/discord acepta una URL de webhook destino, un mensaje de texto plano y un objeto de embed opcional — título, descripción, color, campos y una miniatura o imagen — que sigue la misma estructura de embeds de Discord, así que todo lo que ya sabe sobre formatear embeds aplica directamente. Nosotros nos encargamos de la entrega, los reintentos ante límites de tasa o fallas transitorias, y le reportamos si la publicación llegó.
Los embeds existen porque el texto plano no escala
Discord introdujo los embeds precisamente porque los mensajes de bot en texto plano se volvieron ilegibles cuando los servidores empezaron a usar bots para anuncios de versión, registros de moderación y actualizaciones de estado, todos en el mismo canal; una barra de color y campos estructurados permiten distinguir de un vistazo qué tipo de mensaje se está viendo antes de leer una sola palabra. Nosotros nos apoyamos en esa misma estructura en vez de inventar nuestra propia capa de formato.
Encaja sin ruido en la automatización que ya tiene
Como la llamada es asíncrona, un pipeline de integración continua, un script de monitoreo o un manejador de formularios puede disparar POST /notify/discord y continuar de inmediato, mientras la publicación ocurre de forma independiente. Combina de forma natural con el enrutamiento de alertas cuando Discord es uno de varios canales a los que un evento podría necesitar llegar, o con el endpoint de resumen diario cuando prefiere un consolidado en vez de un embed por evento.
Cómo sabe que funcionó
El estado de entrega, incluyendo las respuestas de límite de tasa de Discord si el webhook destino está siendo restringido, vuelve mediante un webhook firmado o un enlace firmado válido por 24 horas. Un embed mal formado o una URL de webhook inválida devuelve un error claro en vez de fallar en silencio, así que depurar una integración rota no significa quedarse mirando un canal vacío sin saber qué pasó.
Qué puede hacer con ella
Anuncios de versión y changelog
El pipeline de integración continua de un proyecto de código abierto publica un embed con el número de versión y los cambios destacados en el canal #releases de la comunidad en cada etiqueta nueva.
Alertas de moderación comunitaria
Un sistema de moderación automatizado publica un embed con el mensaje marcado, el autor y el motivo en un canal privado de registro de moderación para revisión rápida.
Estado de servidor de juego y bots
Un servidor de juego autoalojado publica embeds con el número de jugadores y el tiempo de actividad en un canal de estado según un horario, sin necesidad de un proceso de bot.
Notificaciones de tickets de soporte
Una integración de mesa de ayuda publica embeds de tickets nuevos con color según prioridad en un canal interno de soporte en el momento en que se crea el ticket.
Preguntas frecuentes
¿Cómo publico un embed con formato en Discord usando esta api de notificaciones a Discord?
Envía un objeto de embed con título, descripción, color y campos en el cuerpo de POST /notify/discord, siguiendo la misma estructura de embeds de Discord, y se entrega al canal detrás de su webhook.
¿Necesito alojar un bot de Discord para usar esto?
No, la entrega es mediante webhook, no una conexión de bot, así que no hay ningún proceso permanente que alojar ni aplicación de Discord que registrar.
¿notify.discord es gratis?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Cuánto cuesta cada notificación a Discord?
Son 0.002 dólares por cada solicitud POST /notify/discord, y una entrega fallida, tras tres reintentos automáticos, nunca se cobra.
¿Qué pasa si Discord limita la tasa del webhook?
Las respuestas de límite de tasa se manejan con reintento y espera automáticos, y si finalmente la entrega sigue fallando recibe el error específico en vez de una pérdida silenciosa.
¿Puedo enviar texto plano y un embed en un mismo mensaje?
Sí, la solicitud acepta un mensaje de texto plano junto al objeto de embed, tal como Discord renderiza los mensajes combinados.
¿Puedo usar esto para publicar en varios servidores de Discord?
Sí, cada llamada apunta a una URL de webhook específica, así que distintas llamadas pueden dirigirse a distintos servidores o canales de forma independiente.
¿Se conserva el contenido del embed después de publicado?
No, los payloads de mensajes y embeds se eliminan tras el período de retención indicado y nunca se usan para entrenar modelos.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/notify/discord \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/discord", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/notify/discord",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/notify/discord", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/notify/discord", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "notify.discord",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |