# No instante em que um deploy termina.

> Receba uma notificação push quando um deploy der certo ou falhar. Adicione um passo ao GitHub Actions, GitLab CI ou Jenkins e o resultado chega ao seu celular em segundos.

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

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

Adicione um passo de notificação ao GitHub Actions, GitLab CI ou Jenkins, ou aponte um webhook de deploy da Vercel ou da Netlify para o Pocket Alert. O resultado do deploy chega ao seu celular em até um segundo após o fim do job, com o commit, a branch e o ambiente anexados.

## Três passos para alertas de deploy

1. **Obtenha a chave ou a URL do webhook** — Crie uma chave de API para uma chamada com a CLI ou com curl, ou um webhook, e copie a URL de recebimento.
2. **Adicione um passo ou webhook** — Adicione um passo de notificação ao seu pipeline, ou cole a URL de recebimento nas notificações de deploy da Vercel ou da Netlify.
3. **Publique com tranquilidade** — Publique uma release e seu celular vibra com o resultado, o commit e o ambiente.

## Cada release no seu celular

Quando uma release falha em silêncio, você fica sabendo em segundos, muito antes de um usuário reclamar do site quebrado.

- **Funciona em qualquer pipeline** — GitHub Actions, GitLab CI, Jenkins e CircleCI precisam, cada um, de um único passo no fim do pipeline.
- **Sucesso ou falha** — Envie em caso de sucesso, de falha ou nos dois. Execute o passo de notificação com if: failure() para receber apenas avisos de releases quebradas.
- **Contexto do deploy** — Coloque o commit, a branch, o ambiente e a URL da execução na mensagem para saber exatamente o que foi publicado.
- **Canais por ambiente** — Um aplicativo separado por ambiente mantém os deploys de produção, staging e preview em canais próprios.
- **Instantâneo ao terminar** — A notificação chega assim que o job termina, para você poder fechar a aba do pipeline.
- **Zero configuração** — Uma chamada da CLI ou um curl no seu job. Não há bot do Slack para instalar.

## Receba notificação em todo deploy

### 1. Pipeline de CI/CD (CLI ou curl)

Adicione um passo no fim do seu job do GitHub Actions, GitLab CI, Jenkins ou CircleCI. Com a CLI:

```
pocketalert send -t "Deploy succeeded" -m "prod @ v2.4.0"
```

Ou use curl direto na API de mensagens, assim não há nada para instalar no runner:

```
curl -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Deploy succeeded","message":"prod @ v2.4.0","level":"silent"}'
```

### 2. Vercel ou Netlify (webhook)

Crie um webhook para que a Vercel ou a Netlify possam enviar o próprio payload de deploy ao Pocket Alert. O campo `message` é um template GJSON que mapeia os campos deles para a notificação push:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Vercel deploy","message":"%type%: %payload.project.name% on %payload.deployment.target%","application_id":"qm47b9pzxzxg"}'
```

Você recebe uma URL de recebimento como `https://p4a.me/wh/1234abcd`. Cole-a nas configurações de webhook da Vercel (eventos como `deployment.succeeded`). Para a Netlify, adicione-a como webhook de saída de notificação de deploy e mapeie os campos, por exemplo `%name% is %state% on %branch%`.

A [documentação de configurações de webhook](https://info.pocketalert.app/api/webhooks/settings.html) explica a API de mensagens e o mapeamento de campos GJSON.

## Perguntas frequentes

### Como recebo notificações de deploy?

Adicione um passo de notificação no fim do seu pipeline no GitHub Actions, GitLab CI, Jenkins ou CircleCI. Execute a CLI do Pocket Alert ou uma chamada com curl, e o resultado do deploy chega como notificação push assim que o job termina.

### Posso receber alertas só de deploys com falha?

Sim. Use o status do job para enviar uma mensagem de sucesso ou de falha, e execute o passo de notificação apenas com if: failure() para que uma release quebrada seja o alerta que você recebe.

### Posso incluir o commit e o ambiente?

Coloque o commit, a branch, o ambiente e a URL do pipeline no corpo da mensagem. O alerta então mostra o que foi publicado e onde, e leva direto para a execução.

### Quais ferramentas de CI/CD são compatíveis?

Qualquer coisa que execute um comando funciona: GitHub Actions, GitLab CI, Jenkins, CircleCI, Bitbucket Pipelines ou um script de deploy simples. Para Vercel e Netlify, crie um webhook do Pocket Alert e cole a URL de recebimento nas configurações de notificação de deploy.

### Posso separar os alertas de produção e staging?

Crie um aplicativo separado para cada ambiente: produção, staging e preview. Os deploys de produção chegam então no próprio canal, e você diferencia as releases de relance.

### Um deploy de produção com falha pode furar o Não perturbe?

Sim. Envie os deploys com falha com level=critical: no Android eles são publicados em um canal dedicado que ignora o Não perturbe, e no iPhone aparecem como notificações urgentes que furam o Foco. Avisos rotineiros de sucesso podem ser enviados com level=silent, ficando no histórico sem vibrar.
