# Buat exception sampai di ponsel Anda.

> Terima exception dari Sentry, Rollbar, dan Bugsnag sebagai push notification. Arahkan webhook error tracker Anda ke Pocket Alert dan ketahui issue baru dalam waktu kurang dari satu detik.

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

Terakhir diperbarui: 2026-08-11

Saat Sentry, Rollbar, atau Bugsnag menangkap exception baru, judul dan tingkat keparahannya sampai ke ponsel Anda dalam waktu kurang dari satu detik. Tangkap error sebelum pengguna Anda melaporkannya.

## Tiga langkah untuk alert error di ponsel Anda

1. **Buat webhook** — Buat webhook Pocket Alert dengan template pesan GJSON dan salin URL penerimaannya.
2. **Hubungkan error tracker** — Tempelkan URL ke Internal Integration Sentry (atau webhook Rollbar/Bugsnag) dan lampirkan ke alert rule.
3. **Petakan dan kirim** — GJSON memetakan data.event.title, culprit, level, dan web_url ke dalam push Anda. Exception berikutnya akan membuat ponsel Anda bergetar.

## Dari stack trace ke layar kunci

Error tracker Anda sudah mengirim webhook. Pocket Alert mengubahnya menjadi push yang tidak akan terlewat.

- **Bekerja dengan semua error tracker** — Sentry, Rollbar, Bugsnag, Honeybadger, dan Airbrake semuanya memicu webhook keluar saat ada issue baru. Arahkan ke Pocket Alert dan selesai.
- **Petakan field dengan GJSON** — Path GJSON mengambil data.event.title, data.event.culprit, dan data.event.level langsung dari payload ke dalam notifikasi Anda.
- **Level dan rule sebaris** — Tampilkan level error dan rule yang terpicu langsung di push, sehingga exception fatal terbaca berbeda dari warning.
- **Satu channel per environment** — Setiap aplikasi punya URL webhook sendiri, sehingga prod, staging, dan layanan tertentu tetap berada di channel terpisah.
- **Pengiriman di bawah satu detik** — Exception sampai ke ponsel Anda dalam waktu kurang dari satu detik, jauh sebelum ringkasan email dikirim.
- **URL webhook sebagai secret** — URL webhook adalah secret aplikasi Anda melalui HTTPS. Rotasi URL ini kapan pun Anda memerlukan endpoint baru.

## Kirim alert error ke ponsel Anda

### 1. Buat webhook Pocket Alert

Di halaman [Webhooks](https://pocketalert.app/id/webhooks), buat webhook yang template `message` GJSON-nya membaca payload issue-alert Sentry (semuanya tersarang di dalam `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"}'
```

Anda akan mendapatkan URL masuk seperti `https://p4a.me/wh/1234abcd`.

### 2. Arahkan Sentry ke URL tersebut

Di [Pengaturan → Developer Settings → Internal Integration](https://docs.sentry.io/organization/integrations/integration-platform/webhooks/issue-alerts/), atur Webhook URL ke URL penerimaan Anda dan aktifkan Alert Rule Action. Lalu buat alert rule untuk issue dan tambahkan integrasi tersebut sebagai aksinya:

```
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 mengirim POST berupa `{"action":"triggered","data":{"event":{"title":...,"culprit":...,"level":...,"web_url":...}}}`; path GJSON di atas mengambil field tersebut ke dalam push.

### 3. Error tracker lain (Rollbar, Bugsnag)

Rollbar (Pengaturan → Notifications → Webhook) dan Bugsnag (Integrations → Generic webhook) mengirim payload yang lebih datar. Sesuaikan template dengan field mereka, misalnya `%data.item.title%` untuk Rollbar atau `%error.exceptionClass%` untuk Bugsnag, lalu tempelkan URL penerimaan yang sama.

[Dokumentasi pengaturan webhook](https://info.pocketalert.app/api/webhooks/settings.html) mencakup semua path GJSON dan opsi webhook.

## FAQ

### Bagaimana cara mendapatkan alert error di ponsel saya?

Di Sentry, buat Internal Integration dengan URL webhook yang diisi ke URL penerimaan Pocket Alert Anda dan aktifkan Alert Rule Action, lalu tambahkan ke alert rule untuk issue. Saat rule terpicu, Sentry mengirim POST berisi issue dan push sampai ke ponsel Anda dalam waktu kurang dari satu detik.

### Bagaimana cara kerja pemetaan field?

Webhook issue-alert Sentry menyimpan data di dalam data.event. Pocket Alert membacanya dengan path GJSON. Anda memetakan data.event.title ke judul notifikasi dan data.event.culprit, atau web_url, ke isi notifikasi, sehingga push memberi tahu Anda dengan tepat issue mana yang terpicu.

### Bisakah saya menampilkan level error dan rule-nya?

Payload berisi data.event.level (warning, error, fatal) dan nama rule di data.triggered_rule. Gunakan keduanya di template pesan GJSON Anda agar exception fatal tampil berbeda dari warning.

### Bisakah saya memisahkan prod dan staging?

Berikan setiap environment aplikasinya sendiri. Webhook prod dan webhook staging masuk ke channel terpisah, dan Anda bisa membisukan staging tanpa mengubah prod.

### Apakah saya perlu memasang agent?

Tidak perlu. Pocket Alert hanya menerima webhook yang sudah dikirim error tracker Anda, sehingga tidak ada agent atau SDK yang perlu dipasang. Sentry, Rollbar, Bugsnag, Honeybadger, dan Airbrake semuanya mendukung webhook keluar.

### Bisakah exception produksi menembus Jangan Ganggu?

Bisa. Tambahkan "level":"critical" ke pesan, dan di Android notifikasinya dikirim ke channel notifikasi khusus yang melewati Jangan Ganggu. Anda cukup memberi izin akses DND sekali. Di iPhone, notifikasi high dan critical dikirim sebagai time-sensitive notification yang tetap tembus mode Fokus. Setiap pesan menerima level dari silent sampai critical, sehingga warning di staging bisa tetap senyap sementara fatal di prod tetap membangunkan Anda. Di paket gratis, critical dikirim sebagai high: tetap instan, hanya tanpa override Jangan Ganggu.
