# Envie agora, entregue depois.

> Agende notificações push com o Pocket Alert. Defina um horário exato ou um atraso de até 30 dias, liste as mensagens pendentes e cancele antes do envio. Sem precisar de tarefa cron.

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

Última atualização: 2026-08-11

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.

Documentação: https://info.pocketalert.app/features/scheduled-delivery.html

## 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.

## 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.

## 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.

## Perguntas frequentes

### Como agendar uma notificação push?

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.

### Com quanta antecedência posso agendar?

Trinta dias. Qualquer data além disso é rejeitada, e não ajustada silenciosamente.

### Qual fuso horário é usado?

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.

### Posso cancelar uma mensagem agendada?

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.

### E se o horário de envio passar durante uma indisponibilidade?

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 agendamento está disponível no plano gratuito?

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.
