# No instante em que uma tarefa cron falha.

> Receba uma notificação push quando uma tarefa cron ou tarefa agendada falhar. Adicione uma linha ao seu crontab ou systemd timer e os alertas de falha chegam ao seu celular em menos de um segundo.

<!-- source: https://pocketalert.app/pt/use-cases/cron-job-alerts -->

Última atualização: 2026-10-17

O Pocket Alert envia uma notificação push ao seu celular no momento em que uma tarefa cron falha. Encadeie uma linha em qualquer comando agendado com && ou || — dispare em caso de falha, de sucesso ou nos dois, e o push chega assim que a tarefa encerra, com a saída de erro incluída.

## Três passos para alertas de falha no cron

1. **Pegue sua URL ou CLI** — Copie a URL de webhook de entrada do seu aplicativo ou instale a CLI do Pocket Alert.
2. **Adicione uma linha** — Encadeie uma chamada curl ou pocketalert send na sua linha do cron, com || para falhas ou && para sucesso.
3. **Receba o alerta** — Execute a tarefa. Se ela falhar, seu celular vibra com o título e a saída de erro que você definiu.

## Nunca mais perca uma tarefa que falhou

Uma importação que falhou deve chegar até você na hora, horas antes de você abrir os logs.

- **Uma linha no crontab** — Encadeie um push em qualquer linha do cron com && ou ||. É uma única chamada curl, sem daemon para monitorar.
- **Alerta só em caso de falha** — Com ||, o alerta dispara apenas quando o comando encerra com código diferente de zero.
- **Inclua o erro** — Envie o stderr ou o código de saída para a mensagem, para que o push chegue com o erro já anexado.
- **Qualquer agendador** — crontab, timers do systemd, o agendador do Laravel, Sidekiq e CronJobs do K8s funcionam, porque todos executam comandos.
- **Heartbeat em caso de sucesso** — Envie um heartbeat após uma execução bem-sucedida. Quando ele deixar de chegar, você saberá que a tarefa morreu em silêncio e poderá investigar.
- **Instantâneo ao terminar** — O push chega no momento em que a tarefa encerra, horas antes de alguém acompanhar os logs.

## Conecte um alerta à sua tarefa cron

### Instale e autentique a CLI

```
sudo mv pocketalert /usr/local/bin/ && chmod +x /usr/local/bin/pocketalert
pocketalert auth YOUR_API_KEY
```

### Alerte somente quando a tarefa falhar

Encadeie o alerta com `||` para que ele dispare apenas com código de saída diferente de zero:

```
0 3 * * * /usr/local/bin/mybackup.sh || pocketalert send \
  -t "Cron failed: mybackup" -m "Exited non-zero at $(date)"
```

### Inclua a saída de erro

```
0 3 * * * /usr/local/bin/mybackup.sh 2>/tmp/cron.err || pocketalert send \
  -t "Cron failed: mybackup" -m "$(tail -n 3 /tmp/cron.err)"
```

### Heartbeat em caso de sucesso

Adicione um ping com `&&` após uma execução limpa. Quando ele deixar de chegar, a tarefa morreu em silêncio:

```
0 3 * * * /usr/local/bin/mybackup.sh && pocketalert send "Cron OK: mybackup" "Finished cleanly"
```

### Sem CLI? Chame a API com curl

```
0 3 * * * /usr/local/bin/mybackup.sh || curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Cron failed: mybackup","message":"Exited non-zero","level":"high"}'
```

A [documentação](https://info.pocketalert.app/getting-started.html) cobre a segmentação e os canais por aplicativo.

## Perguntas frequentes

### Como recebo alertas de tarefas cron?

Encadeie uma notificação ao seu comando cron no shell. `&&` dispara após uma execução bem-sucedida, `||` dispara após uma falha, e o Pocket Alert envia a notificação push quando a tarefa encerra.

### Posso receber alerta só em caso de falha?

Use `||` para que o alerta dispare apenas quando o comando encerrar com código diferente de zero: `mybackup.sh || curl ...`. Tarefas quebradas chegam até você, e o resto fica em silêncio.

### Posso incluir a saída de erro?

Sim. Capture o código de saída ou a saída e insira no corpo da mensagem. A CLI do Pocket Alert envia o stderr diretamente para a notificação.

### Funciona fora do crontab?

Qualquer agendador funciona: crontab, timers do systemd, o agendador do Laravel, cron do Rails ou Sidekiq, Agendador de Tarefas do Windows, CronJobs do Kubernetes. Se ele executa um comando, você pode encadear um alerta nele.

### Consigo detectar uma tarefa que nunca rodou?

Envie um ping de conclusão com `&&` após cada execução bem-sucedida. Quando o ping deixar de chegar, você saberá que a tarefa parou de rodar, sem precisar de ferramentas extras.

### Uma tarefa noturna que falhou pode me acordar, e os pings de sucesso ficam em silêncio?

Adicione level=critical ao alerta de falha e ele atravessa o modo Não perturbe no Android e o Foco no iPhone. Para pings de heartbeat, use level=silent: eles aparecem no histórico sem som, então o registro existe, mas o celular continua quieto.
