# Seu celular, a um curl de distância.

> Envie uma notificação push para o seu celular com um único comando curl. Faça POST para a API do Pocket Alert de qualquer terminal, script bash ou tarefa cron — sem SDK, com plano gratuito.

<!-- source: https://pocketalert.app/pt/use-cases/curl-push-notifications -->

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

Envie uma notificação push para o seu celular com um único comando curl: faça um POST de um title e de uma message para a API do Pocket Alert com a sua chave, e ela chega no seu iPhone ou Android em menos de um segundo. Funciona a partir de qualquer shell, script ou máquina que tenha curl.

## Três passos do shell até o bolso

1. **Obtenha uma chave de API** — Crie sua conta grátis, gere uma chave na página de chaves de API e exporte-a como variável de ambiente.
2. **Faça o curl na API** — Envie title e message por POST para /v1/messages com o cabeçalho Token. Form-data ou JSON.
3. **O celular vibra** — O push chega em menos de um segundo. Encadeie com && ou || para ser alertado em caso de sucesso ou falha.

## O caminho do terminal até o celular

Você já vive no terminal. O Pocket Alert deixa o seu celular a um curl de distância — sem SDK, sem daemon, sem servidor de notificações para manter.

- **Uma linha, sem SDK** — Envie title e message por POST com um cabeçalho de chave de API. Sem SDK, sem OAuth, sem dependências além do próprio curl.
- **Feito para scripts de shell** — Encadeie com && e || para enviar em caso de sucesso, falha ou ambos. Seu crontab e seus scripts de CI já sabem como fazer isso.
- **JSON ou campos de formulário** — JSON ou form-data — a API detecta o tipo de conteúdo, então a versão rápida no terminal e a versão em script funcionam igualmente.
- **Prioridade por mensagem** — Adicione level=critical para furar o modo silencioso em incidentes reais, ou level=silent para um registro discreto que não vibra.
- **Histórico incluído** — Cada push cai no seu histórico com estatísticas de entrega, então uma mensagem de script disparada e esquecida nunca se perde de fato.
- **Funciona em qualquer máquina** — A mesma requisição funciona em um Raspberry Pi, um servidor de build, uma VPS ou no WSL — onde o curl rodar, o seu celular está acessível.

## Envie um push do seu terminal

### 1. A linha única

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Deploy finished' -F 'message=v2.4.1 is live on production'
```

Crie uma chave na página de [chaves de API](https://pocketalert.app/pt/account/apikeys). JSON também funciona, se você preferir:

```
curl -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"Deploy finished","message":"v2.4.1 is live on production"}'
```

### 2. Encadeie em qualquer coisa

Seja notificado quando uma tarefa lenta terminar — ou somente quando ela falhar:

```
# push when the build succeeds
make release && curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' -F 'title=Build OK' -F 'message=make release finished'

# push only on failure, and make it loud
./migrate.sh || curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
  -H 'Token: YOUR_API_KEY' \
  -F 'title=Migration FAILED' -F 'message=migrate.sh exited non-zero' -F 'level=critical'
```

### 3. Encapsule em uma função

Coloque isto no seu `.bashrc` / `.zshrc` e nunca mais digite a URL:

```
notify() {
  curl -s -X POST 'https://api.pocketalert.app/v1/messages' \
    -H "Token: $POCKETALERT_KEY" \
    --form-string "title=$1" --form-string "message=$2" --form-string "level=${3:-default}" > /dev/null
}

# usage
long_task; notify "long_task done" "exit code $?"
notify "Disk warning" "/dev/sda1 at 91%" high
```

Prefere um binário de verdade? A [CLI do Pocket Alert](https://pocketalert.app/pt/tools/cli) encapsula a mesma API. E como é HTTP puro, a mesma chamada funciona em Python, Go, PowerShell ou em uma [tarefa cron](https://pocketalert.app/pt/use-cases/cron-job-alerts).

## Perguntas frequentes

### Qual é o comando curl mínimo para enviar um push?

curl -X POST 'https://api.pocketalert.app/v1/messages' -H 'Token: YOUR_API_KEY' -F 'title=Done' -F 'message=Build finished'. É só isso — sem SDK, sem biblioteca cliente, sem fluxo OAuth. Qualquer máquina com curl consegue enviar.

### A API aceita JSON ou campos de formulário?

Os dois. O endpoint aceita application/json e form-data (pares -d chave=valor), e detecta qual você enviou. O form-data é mais curto de digitar no terminal; o JSON é mais fácil de montar programaticamente.

### Como ser notificado quando um comando de longa duração termina?

Encadeie o comando com &&: make build && curl … dispara somente em caso de sucesso. Use || para alertas de falha, ou ; para notificar em qualquer cenário. Para tarefas longas, capture o código de saída e coloque-o na mensagem, para que o push informe o que aconteceu.

### Posso definir a prioridade pela linha de comando?

Adicione -F 'level=critical' e o push ignora o Não perturbe no Android e atravessa o Foco no iPhone. Use level=silent para avisos que você quer registrados sem som. São cinco níveis: silent, low, default, high, critical.

### De onde vem a chave de API?

Crie uma na página de chaves de API depois de criar sua conta. Coloque-a em uma variável de ambiente ou no seu gerenciador de segredos, em vez de deixá-la fixa nos scripts. O plano gratuito inclui 50 mensagens por dia — o suficiente para um dia movimentado de scripts.
