Envio agendado

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.

Até 30 dias de antecedênciaCancele a qualquer momentoSeu fuso horárioAtualizado em
O que você recebe

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.

Primeiros passos

Três passos, um campo extra

1

Adicione um campo

Pegue uma mensagem que você já envia e adicione send_at com um horário, ou delay com um deslocamento.

2

Guarde o tid

Você recebe de volta um tid e o horário de entrega definido no seu fuso horário e em UTC.

3

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.

FAQ

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.