# Envía ahora, entrégalo después.

> Programa notificaciones push con Pocket Alert. Elige una hora exacta o un retraso de hasta 30 días, consulta los mensajes pendientes y cancélalos antes del envío. Sin necesidad de tareas cron.

<!-- source: https://pocketalert.app/es/features/scheduled-delivery -->

Última actualización: 2026-08-11

Indica una hora exacta o un retraso relativo en cualquier mensaje, hasta 30 días de antelación, y cancélalo en cualquier momento antes de que se active. Sin tarea cron, sin proceso en segundo plano.

Documentación: https://info.pocketalert.app/features/scheduled-delivery.html

## Tres pasos, un campo extra

1. **Añade un campo** — Toma un mensaje que ya envías y añade send_at con una hora, o delay con un desfase.
2. **Guarda el tid** — Recibes un tid y la hora de entrega resuelta en tu zona horaria y en UTC.
3. **Cancela si hace falta** — Lista los mensajes pendientes en cualquier momento, y cancela con un DELETE si cambian los planes.

## Dos formas de indicar cuándo

Cada recordatorio que alguna vez quisiste desde un script necesitaba un proceso que siguiera vivo hasta el momento exacto. Ya no.

- **Horas absolutas** — Indica una marca de tiempo exacta en RFC3339, en Unix o una fecha y hora simples, lo que te resulte más cómodo.
- **Retrasos relativos** — O indica un retraso relativo: 30m, 2h o solo segundos. Útil cuando el disparador es «dos horas después de que empezó este script».
- **Tu zona horaria, no UTC** — Las horas sin desfase se interpretan en la zona horaria de tu cuenta, así que 09:00 significa las nueve donde estés.
- **Listar y cancelar** — Lista todo lo pendiente y cancela cualquiera antes de la entrega. Una colisión con el despachador se resuelve limpiamente, nunca a medias.
- **Cifrado hasta la entrega** — El contenido permanece cifrado en reposo hasta que se entrega, incluidos los adjuntos. Un mensaje cancelado se lleva su archivo con él.
- **Una programación es una promesa** — La prioridad y el plan se resuelven en el momento de programar. Un mensaje prometido como crítico llega como crítico, pase lo que pase después.

## Cómo funciona el envío programado

    
Añade `send_at` o `delay` a una petición normal de creación de mensaje. En lugar de enviarlo de inmediato, Pocket Alert guarda una copia cifrada del mensaje y se la pasa a un despachador interno, que lo entrega en el momento adecuado como una notificación push normal. El mensaje entregado aparece después en tu historial como cualquier otro.

    
Recibes un `201` con `"scheduled": true`, la hora de entrega resuelta tanto en tu zona horaria como en UTC, y un `tid`. Guárdalo, es con lo que cancelas.

    
## Qué reemplaza

    
Recordatorios de caducidad de certificados, ventanas de mantenimiento, un aviso dos horas después de que empiece una migración para revisar el número de filas, un seguimiento la mañana después de un despliegue. Todo eso antes requería una entrada cron o un proceso en segundo plano que debía sobrevivir hasta el momento exacto. Ahora es un campo extra en una petición que ya hacías.

    
## Casos límite, resueltos

    
Un `send_at` en el pasado devuelve `400`, con sesenta segundos de tolerancia por desfase del reloj. Dentro de esa ventana, el mensaje simplemente se envía ahora. Los mensajes atrasados tras un reinicio se entregan con retraso, no se descartan. Los adjuntos se suben al programar y se vinculan en la entrega.

## Preguntas frecuentes

### ¿Cómo programo una notificación push?

Añade `send_at` con una hora exacta o `delay` con un desfase relativo a cualquier mensaje. `send_at` acepta RFC3339, una marca de tiempo Unix o un `YYYY-MM-DD HH:MM` simple; `delay` acepta duraciones como `30m` y `2h`. Envía una de las dos, nunca ambas.

### ¿Con cuánta antelación puedo programar?

Treinta días. Lo que esté más lejos se rechaza en lugar de ajustarse en silencio.

### ¿Qué zona horaria se usa?

La zona horaria de tu cuenta. Un `send_at` de 2026-08-15 09:00 significa las nueve de la mañana donde estés, no en UTC. Añade un desfase explícitamente si quieres evitar ambigüedades.

### ¿Puedo cancelar un mensaje programado?

Lista los mensajes pendientes con `GET /v1/messages/scheduled` y cancela uno con `DELETE /v1/messages/scheduled/{tid}`. Si el envío ya ha empezado, recibes un `409` en lugar de un mensaje cancelado a medias. Al cancelar, también se elimina cualquier adjunto.

### ¿Qué pasa si la hora de entrega llega durante una caída?

Se entrega con retraso, no se descarta. Si el servicio se reinicia después de una hora de entrega, el mensaje sale en el siguiente ciclo. El contenido permanece cifrado en reposo con tu clave desde el momento en que lo programas.

### ¿El envío programado está disponible en el plan gratuito?

El envío programado es una función de pago. Una petición en el plan gratuito que use `send_at` o `delay` devuelve `403` en lugar de enviarse inmediatamente en silencio. La prioridad y el plan se resuelven al programar, así que un mensaje programado como crítico llega igualmente como crítico.
