# Faça exceções chegarem ao seu celular.

> Receba exceções do Sentry, Rollbar e Bugsnag como notificações push. Aponte o webhook do seu rastreador de erros para o Pocket Alert e saiba de novos problemas em menos de um segundo.

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

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

Quando o Sentry, o Rollbar ou o Bugsnag captura uma nova exceção, o título e a gravidade chegam ao seu celular em menos de um segundo. Capture o erro antes que seus usuários o reportem.

## Três passos para receber alertas de erro no celular

1. **Crie um webhook** — Crie um webhook do Pocket Alert com um template de mensagem GJSON e copie a URL de recebimento.
2. **Conecte o rastreador** — Cole a URL em uma Internal Integration do Sentry (ou em um webhook do Rollbar/Bugsnag) e anexe-a a uma regra de alerta.
3. **Mapeie e envie** — O GJSON mapeia data.event.title, culprit, level e web_url para a sua notificação. A próxima exceção faz o seu celular vibrar.

## Do stack trace à tela de bloqueio

Seu rastreador de erros já envia um webhook. O Pocket Alert transforma isso em uma notificação push que você não consegue ignorar.

- **Funciona com qualquer rastreador** — Sentry, Rollbar, Bugsnag, Honeybadger e Airbrake disparam um webhook de saída para um novo issue. Aponte para o Pocket Alert e pronto.
- **Mapeie campos com GJSON** — Caminhos GJSON extraem data.event.title, data.event.culprit e data.event.level diretamente do payload para a sua notificação.
- **Nível e regra na notificação** — Mostre o nível do erro e a regra que disparou direto na notificação, para que uma exceção fatal seja exibida de forma diferente de um aviso.
- **Um canal por ambiente** — Cada aplicativo tem sua própria URL de webhook, então produção, staging e um serviço específico ficam em canais separados.
- **Entrega em menos de um segundo** — A exceção chega ao seu celular em menos de um segundo, bem antes do resumo por e-mail.
- **URL de webhook secreta** — A URL do webhook é o segredo do seu aplicativo, transmitida por HTTPS. Gere uma nova sempre que precisar de um endpoint novo.

## Envie alertas de erro para o seu celular

### 1. Crie um webhook do Pocket Alert

Na página [Webhooks](https://pocketalert.app/pt/webhooks), crie um webhook cujo template de `message` em GJSON leia o payload de alerta de issue do Sentry (tudo fica aninhado em `data.event`):

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Sentry","default_level":"critical","message":"[%data.event.level%] %data.event.title%\n%data.event.culprit%\n%data.event.web_url%","application_id":"qm47b9pzxzxg"}'
```

Você recebe uma URL de entrada como `https://p4a.me/wh/1234abcd`.

### 2. Aponte o Sentry para ela

Em [Settings → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/), defina a Webhook URL como a sua URL de recebimento e habilite a Alert Rule Action. Depois, crie uma regra de alerta de issue e adicione a integração como ação:

```
Webhook URL:  https://p4a.me/wh/1234abcd
Permissions:  Issue & Event (Read)
Action:       Alert Rule Action — enabled

Alerts → Create Alert → When a new issue is created
→ Then send a notification via [your integration]
```

O Sentry envia um POST com `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}`; os caminhos GJSON acima extraem esses campos para a notificação.

### 3. Outros rastreadores (Rollbar, Bugsnag)

O Rollbar (Settings → Notifications → Webhook) e o Bugsnag (Integrations → Generic webhook) enviam um payload mais simples. Ajuste o template para os campos deles, por exemplo `%data.item.title%` no Rollbar ou `%error.exceptionClass%` no Bugsnag, e cole a mesma URL de recebimento.

A [documentação de configurações de webhook](https://info.pocketalert.app/api/webhooks/settings.html) cobre todos os caminhos GJSON e opções de webhook.

## Perguntas frequentes

### Como receber alertas de erro no celular?

No Sentry, crie uma Internal Integration com a URL do webhook apontando para a URL de recebimento do Pocket Alert e com a Alert Rule Action habilitada. Depois, adicione-a a uma regra de alerta de issue. Quando a regra disparar, o Sentry faz um POST com o issue e a notificação chega ao seu celular em menos de um segundo.

### Como funciona o mapeamento de campos?

Os webhooks de alerta de issue do Sentry aninham os dados em data.event. O Pocket Alert lê esses dados com caminhos GJSON. Assim, você mapeia data.event.title para o título da notificação e data.event.culprit (ou web_url) para o corpo. A notificação mostra exatamente qual issue disparou.

### Dá para mostrar o nível do erro e a regra?

O payload traz data.event.level (warning, error, fatal) e o nome da regra em data.triggered_rule. Use os dois no seu template de mensagem GJSON para que uma exceção fatal seja exibida de forma diferente de um aviso.

### Dá para separar produção e staging?

Dê a cada ambiente o seu próprio aplicativo. Um webhook de produção e um de staging chegam em canais separados, e você pode silenciar o staging sem mexer na produção.

### Preciso instalar algum agente?

Nada. O Pocket Alert apenas recebe o webhook que o seu rastreador já envia, então não há agente nem SDK para instalar. Sentry, Rollbar, Bugsnag, Honeybadger e Airbrake suportam webhooks de saída.

### Uma exceção de produção pode furar o Não perturbe?

Sim. Adicione "level":"critical" à mensagem e, no Android, ela será enviada para um canal de notificação dedicado que ignora o Não perturbe. Você concede o acesso ao Não perturbe uma única vez. No iPhone, as notificações high e critical chegam como notificações urgentes no tempo, que atravessam os modos Foco. Toda mensagem aceita um nível de silent a critical, então um aviso de staging pode ficar silencioso enquanto um fatal de produção te acorda. No plano gratuito, critical é entregue como high: continua instantâneo, só que sem ignorar o Não perturbe.
