Agrupa avisos en un correo al día
Recibir cincuenta notificaciones al día enseña a ignorar las cincuenta. Esta API junta los eventos que le envía y despacha un único correo resumen en el horario que definas, para que la bandeja de entrada vuelva a ser señal y no ruido.
Pensada para equipos ahogados en correos por evento
Cualquier sistema que dispara una notificación por cada evento — un procesador de colas, un agente de monitoreo, un manejador de formularios, una flota de tareas programadas — termina inundando la bandeja de alguien. notify.digest existe para el momento en que un líder de equipo dice 'dejen de escribirme cada vez, avísenme una vez al día'. Usted sigue enviando eventos tal como ocurren; nosotros los retenemos y armamos el resumen.
Cómo funciona el agrupamiento
Cada llamada a POST /notify/digest agrega una entrada — título, cuerpo breve, severidad y marca de tiempo opcionales — a un grupo (bucket) que usted nombras. Cuando se cumple el horario de ese grupo (por hora, diario, o una ventana personalizada que configura por bucket), todo lo acumulado se convierte en un solo correo en HTML y texto plano, ordenado por hora de llegada, y se envía a los destinatarios registrados. Si no se acumuló nada, no se envía correo vacío; solo recibe correo cuando hay algo que leer.
Un regreso silencioso a cómo debía funcionar el correo
El correo resumen no es una idea nueva — las listas de correo y el software de boletines llevan décadas agrupando novedades — pero la mayoría de los sistemas de notificación de aplicaciones se saltan esa capa y disparan un mensaje por evento porque es lo más fácil de programar. Construimos este endpoint específicamente para que no tenga que escribir su propia capa de agrupamiento, tarea programada y plantillas solo para volver al criterio sensato de un correo al día.
Encaja en los flujos que ya operas
Como el endpoint es asíncrono, su fuente de eventos llama a POST /notify/digest y sigue de inmediato: el task_id vuelve en milisegundos y el envío real ocurre según el horario, desacoplado de lo que disparó el evento. Combínelo con un paso previo de enrutamiento de alertas para decidir qué merece un resumen y qué merece un aviso inmediato, o apunte decenas de servicios independientes al mismo bucket para obtener un solo reporte diario unificado de toda su operación.
Qué llega a su bandeja
El correo final lista cada entrada con su hora y marcador de severidad, ordenadas cronológicamente, con un asunto que resume la cantidad y la severidad más alta para que pueda priorizar desde la vista de la bandeja antes de abrirlo. La confirmación de envío llega igual que en cualquier otra tarea de la plataforma: mediante un webhook firmado, o un enlace firmado válido por 24 horas si prefiere consultarlo usted mismo.
Qué puede hacer con ella
Resumen nocturno de operaciones
Un agente de monitoreo publica cada evento de advertencia durante el día; en vez de cuarenta avisos, el canal de operaciones recibe un solo correo a las 7am con todo ordenado por severidad.
Resumen diario para administradores de SaaS
Los administradores de cuenta reciben un único correo diario con altas, cancelaciones y tickets de soporte en vez de un feed en tiempo real que nadie revisa.
Reporte de tareas programadas
Una flota de trabajos ETL publica su estado de éxito o falla; el líder del equipo revisa un solo correo matutino consolidado en lugar de cincuenta registros por separado.
Recuento de la cola de moderación
Los elementos marcados se acumulan durante el día y llegan en un solo resumen para que el responsable de moderación los revise en una sola sesión.
Preguntas frecuentes
¿Cómo decide esta api para enviar resumen diario por email cuándo despachar el correo?
Define un horario por bucket — por hora, diario o una ventana personalizada — y cada entrada publicada en ese intervalo se compila en un solo correo cuando se cierra la ventana.
¿Existe un plan gratuito para notify.digest?
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 enviar un resumen?
Son 0.002 dólares por cada solicitud POST /notify/digest que encola una entrada, más 0.004 dólares por cada correo resumen efectivamente enviado; nunca se cobra una ventana que no tuvo nada que enviar.
¿Puedo tener varios resúmenes con horarios distintos?
Sí, los buckets son independientes, así que puede correr un resumen por hora para eventos críticos de guardia y otro diario para actividad general al mismo tiempo.
¿Qué pasa si falla el envío de un resumen?
Una tarea fallida se reintenta automáticamente hasta tres veces; si sigue fallando recibe un error claro y nunca se le cobra por ese envío.
¿Cómo obtengo el resultado, por webhook o consultando?
Puede registrar un webhook firmado para que le avisen en el momento del envío, o consultar un enlace firmado que permanece válido durante 24 horas si prefiere revisarlo usted mismo.
¿Puedo incluir niveles de severidad o etiquetas en cada entrada?
Sí, cada entrada acepta severidad y una etiqueta libre opcionales para que el correo compilado agrupe y resalte lo más importante.
¿Se conservan mis datos después de enviado el resumen?
No, las entradas y el correo compilado 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/digest \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/notify/digest", {
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/digest",
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/digest", 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/digest", 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.digest",
"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. |