Envie agora, entregue depois.
Defina um horário exato ou um atraso relativo em qualquer mensagem, com até 30 dias de antecedência, e cancele a qualquer momento antes do disparo. Sem tarefa cron, sem processo worker.
Duas formas de dizer quando
Todo lembrete que você já quis fazer a partir de um script precisava de um processo ativo até o momento chegar. Não precisa mais.
Horários absolutos
Informe um timestamp exato em RFC3339, tempo Unix ou uma data e hora simples, o que for mais fácil na sua linguagem.
Atrasos relativos
Ou informe um atraso relativo: 30m, 2h, ou apenas segundos. Útil quando o gatilho é "duas horas depois que este script começou".
Seu fuso horário, não UTC
Horários sem deslocamento são lidos no fuso horário da sua conta, então 09:00 significa nove da manhã onde você está.
Listar e cancelar
Liste tudo que está pendente e cancele qualquer item antes do envio. Uma disputa com o despachante se resolve de forma limpa, nunca pela metade.
Criptografado até a entrega
O conteúdo fica criptografado em repouso até ser entregue, anexos incluídos. Uma mensagem cancelada leva o arquivo junto.
Um agendamento é uma promessa
Prioridade e plano são definidos no momento do agendamento. Uma mensagem prometida como crítica chega como crítica, independentemente do que mudou depois.
Três passos, um campo extra
Adicione um campo
Pegue uma mensagem que você já envia e adicione send_at com um horário, ou delay com um deslocamento.
Guarde o tid
Você recebe de volta um tid e o horário de entrega definido no seu fuso horário e em UTC.
Cancele se necessário
Liste as mensagens pendentes a qualquer momento e cancele com um DELETE se os planos mudarem.
Como funciona o envio agendado
Adicione send_at ou delay a uma requisição comum de criação de mensagem. Em vez de enviar imediatamente, o Pocket Alert armazena um snapshot criptografado da mensagem e o entrega a um despachante interno, que a envia no momento certo como uma notificação push comum. A mensagem entregue então aparece no seu histórico como qualquer outra.
Você recebe de volta um 201 com "scheduled": true, o horário de entrega definido tanto no seu fuso horário quanto em UTC, e um tid. Guarde esse valor, pois é com ele que você cancela.
O que ele substitui
Lembretes de expiração de certificado, janelas de manutenção, um aviso duas horas depois do início de uma migração para verificar a contagem de linhas, um acompanhamento na manhã seguinte a um deploy. Tudo isso antes exigia uma entrada no cron ou um processo worker que precisava continuar ativo até o momento chegar. Agora é um campo extra em uma requisição que você já fazia.
Casos extremos, tratados
Um send_at no passado retorna 400, com sessenta segundos de tolerância para diferença de relógio. Dentro dessa janela, a mensagem é simplesmente enviada agora. Mensagens atrasadas após uma reinicialização são entregues com atraso, não descartadas. Os anexos são enviados no momento do agendamento e vinculados na entrega.
Dúvidas respondidas
Adicione send_at com um horário exato ou delay com um deslocamento relativo a qualquer mensagem. send_at aceita RFC3339, um timestamp Unix ou um YYYY-MM-DD HH:MM simples; delay aceita durações como 30m e 2h. Envie um ou outro, nunca os dois.
Trinta dias. Qualquer data além disso é rejeitada, e não ajustada silenciosamente.
O fuso horário da sua conta. Um send_at de 2026-08-15 09:00 significa nove da manhã onde você está, não em UTC. Adicione um deslocamento explicitamente se quiser evitar ambiguidade.
Liste as mensagens pendentes com GET /v1/messages/scheduled e cancele uma com DELETE /v1/messages/scheduled/{tid}. Se o envio já começou, você recebe um 409, em vez de uma mensagem cancelada pela metade. Cancelar também apaga qualquer anexo.
Ela é entregue com atraso, não descartada. Se o serviço reiniciar depois de um horário de envio, a mensagem sai no próximo ciclo. O conteúdo fica criptografado em repouso com a sua chave desde o momento em que você agenda.
O envio agendado é um recurso pago, e uma requisição do plano gratuito usando send_at ou delay retorna 403, em vez de ser enviada imediatamente em silêncio. Prioridade e plano são definidos no momento do agendamento, então uma mensagem agendada como crítica continua chegando como crítica.
Apague a tarefa cron. Mantenha o lembrete.
Um campo extra em uma mensagem que você já enviava, e a notificação aparece no momento certo, em vez de agora.