Envía ahora, entrégalo después.
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.
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.
Tres pasos, un campo extra
Añade un campo
Toma un mensaje que ya envías y añade send_at con una hora, o delay con un desfase.
Guarda el tid
Recibes un tid y la hora de entrega resuelta en tu zona horaria y en UTC.
Cancela si hace falta
Lista los mensajes pendientes en cualquier momento, y cancela con un DELETE si cambian los planes.
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 y respuestas
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.
Treinta días. Lo que esté más lejos se rechaza en lugar de ajustarse en silencio.
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.
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.
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 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.
Elimina la tarea cron. Conserva el recordatorio.
Un campo extra en un mensaje que ya enviabas, y el recordatorio aparece cuando importa, no ahora.