# Исключения попадали на ваш телефон.

> Получайте исключения из Sentry, Rollbar и Bugsnag в виде push-уведомлений. Направьте вебхук трекера ошибок в Pocket Alert и узнавайте о новых проблемах меньше чем за секунду.

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

Обновлено: 2026-08-11

Когда Sentry, Rollbar или Bugsnag фиксирует новое исключение, его заголовок и серьёзность появляются на вашем телефоне меньше чем за секунду. Узнайте об ошибке раньше, чем её заметят пользователи.

## Три шага до уведомлений об ошибках на телефоне

1. **Создайте вебхук** — Создайте вебхук Pocket Alert с шаблоном сообщения GJSON и скопируйте его URL для приёма.
2. **Подключите трекер** — Вставьте URL в Internal Integration Sentry (или вебхук Rollbar/Bugsnag) и привяжите его к правилу алертов.
3. **Сопоставьте и отправляйте** — GJSON переносит data.event.title, culprit, level и web_url в push-уведомление. Следующее исключение заставит ваш телефон завибрировать.

## От стека вызовов до экрана блокировки

Ваш трекер ошибок уже отправляет вебхук. Pocket Alert превращает его в push-уведомление, которое невозможно пропустить.

- **Работает с любым трекером** — Sentry, Rollbar, Bugsnag, Honeybadger и Airbrake отправляют исходящий вебхук при новой issue. Укажите в нём Pocket Alert, и настройка готова.
- **Сопоставление полей через GJSON** — Пути GJSON извлекают data.event.title, data.event.culprit и data.event.level прямо из payload и передают их в уведомление.
- **Уровень и правило в тексте** — Уровень ошибки и сработавшее правило выводятся прямо в push-уведомлении, поэтому фатальное исключение выглядит иначе, чем предупреждение.
- **Канал на каждое окружение** — У каждого приложения свой URL вебхука, поэтому prod, staging и отдельный сервис остаются в разных каналах.
- **Доставка меньше чем за секунду** — Исключение попадает на телефон меньше чем за секунду, задолго до отправки сводки по email.
- **Секретный URL вебхука** — URL вебхука — это секрет вашего приложения, передаваемый по HTTPS. Перевыпустите его, когда понадобится новый эндпоинт.

## Отправляйте уведомления об ошибках на телефон

### 1. Создайте вебхук Pocket Alert

На странице [Webhooks](https://pocketalert.app/ru/webhooks) создайте вебхук, шаблон GJSON `message` которого читает payload алерта Sentry (всё вложено в `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"}'
```

Вы получите входящий URL вида `https://p4a.me/wh/1234abcd`.

### 2. Укажите этот URL в Sentry

В разделе [Настройки → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/) укажите в поле Webhook URL ваш URL для приёма и включите Alert Rule Action. Затем создайте правило алертов для issue и добавьте интеграцию в качестве действия:

```
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]
```

Sentry отправляет POST-запрос с `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}`; пути GJSON выше переносят эти поля в push-уведомление.

### 3. Другие трекеры (Rollbar, Bugsnag)

Rollbar (Settings → Notifications → Webhook) и Bugsnag (Integrations → Generic webhook) отправляют более плоский payload. Подстройте шаблон под их поля, например `%data.item.title%` для Rollbar или `%error.exceptionClass%` для Bugsnag, и укажите тот же URL для приёма.

В [документации по настройкам вебхуков](https://info.pocketalert.app/api/webhooks/settings.html) описаны все пути GJSON и параметры вебхука.

## Частые вопросы

### Как получать уведомления об ошибках на телефон?

В Sentry создайте Internal Integration с Webhook URL, указывающим на URL приёма Pocket Alert, и включите Alert Rule Action, затем добавьте её в правило алертов для issue. Когда правило срабатывает, Sentry отправляет POST-запрос с issue, и push-уведомление приходит на телефон меньше чем за секунду.

### Как работает сопоставление полей?

Вебхуки алертов Sentry вкладывают данные в data.event. Pocket Alert читает их по путям GJSON: вы сопоставляете data.event.title с заголовком уведомления, а data.event.culprit или web_url с текстом, и push-уведомление точно показывает, какая issue сработала.

### Можно ли показать уровень ошибки и правило?

Payload содержит data.event.level (warning, error, fatal) и название правила в data.triggered_rule. Укажите оба значения в шаблоне сообщения GJSON, чтобы фатальное исключение выглядело иначе, чем предупреждение.

### Можно ли разделить prod и staging?

Создайте отдельное приложение для каждого окружения. Вебхуки для prod и staging попадут в разные каналы, и вы сможете отключить staging, не трогая prod.

### Нужно ли устанавливать агент?

Ничего. Pocket Alert просто принимает вебхук, который ваш трекер уже отправляет, поэтому не нужно устанавливать агент или SDK. Sentry, Rollbar, Bugsnag, Honeybadger и Airbrake поддерживают исходящие вебхуки.

### Может ли фатальное исключение в production пробиться через режим «Не беспокоить»?

Да. Добавьте "level":"critical" в сообщение, и на Android оно будет отправлено в отдельный канал уведомлений, который обходит режим «Не беспокоить». Доступ к «Не беспокоить» нужно выдать один раз. На iPhone уведомления с уровнем high и critical приходят как срочные и пробиваются через режимы Фокусирования. Каждое сообщение принимает уровень от silent до critical, поэтому предупреждение из staging может быть тихим, а фатальная ошибка из prod разбудит вас. На бесплатном тарифе critical доставляется как high: это по-прежнему мгновенно, но без обхода режима «Не беспокоить».
