# Buat workflow yang selesai getarkan ponsel Anda.

> Terima hasil GitHub Actions sebagai push notification. Tambahkan satu langkah Pocket Alert ke workflow Anda dan ketahui build yang gagal atau deploy yang selesai langsung di HP, dalam kurang dari satu detik.

<!-- source: https://pocketalert.app/id/use-cases/github-actions-alerts -->

Terakhir diperbarui: 2026-08-11

Pocket Alert mengirimkan hasil GitHub Actions ke ponsel Anda sebagai notifikasi push. Tambahkan satu langkah curl ke workflow, dan saat build, deploy, atau rilis selesai, hasilnya sampai ke iPhone atau Android Anda dalam waktu kurang dari satu detik, tanpa perlu memantau tab Actions.

## Tiga langkah untuk notifikasi GitHub Actions di ponsel Anda

1. **Buat aplikasi** — Tambahkan aplikasi di Pocket Alert dan simpan kunci API Anda sebagai secret repo POCKETALERT_API_KEY.
2. **Pasang langkahnya** — Tambahkan langkah notify yang menjalankan curl ke API pesan, menggunakan if: failure() dan if: success() untuk memilih hasil.
3. **Petakan dan kirim** — Masukkan repo, sha, dan workflow ke dalam pesan. Run berikutnya akan menggetarkan ponsel Anda.

## Dari run workflow ke layar kunci

Workflow Anda sudah tahu kapan sebuah job selesai. Pocket Alert mengubah momen itu menjadi push yang tidak akan terlewat.

- **Satu langkah di workflow Anda** — Satu panggilan curl ke API pesan mengubah langkah workflow apa pun menjadi push. Tanpa pengaturan runner, tanpa layanan tambahan.
- **Kunci sebagai secret repo** — Baca kunci API Anda dari ${{ secrets.POCKETALERT_API_KEY }} agar tidak muncul di log dan bisa diganti dari dasbor.
- **Notifikasi sesuai hasil yang Anda pilih** — Gabungkan if: failure() dan if: success() untuk mengirim build yang gagal dan deploy yang berhasil sebagai pesan terpisah yang jelas labelnya.
- **Satu saluran per repo** — Setiap aplikasi memiliki ID sendiri, sehingga run per repo dan per lingkungan tetap berada di saluran terpisah.
- **Pengiriman di bawah satu detik** — Langkah ini aktif begitu job berakhir, sehingga hasilnya sampai ke ponsel Anda dalam waktu kurang dari satu detik.
- **Konteks run lengkap** — Masukkan github.repository, github.sha, dan github.workflow ke dalam pesan agar Anda tahu persis run mana yang dimaksud.

## Kirim notifikasi GitHub Actions ke ponsel Anda

### 1. Buat aplikasi dan simpan kunci API Anda

Tambahkan aplikasi di Pocket Alert lalu salin kunci API Anda. Simpan sebagai secret repositori bernama `POCKETALERT_API_KEY` di Settings → Secrets and variables → Actions.

### 2. Tambahkan langkah notify yang memanggil API pesan

```
- name: Notify on failure
  if: failure()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Build failed","message":"${{ github.workflow }} on ${{ github.ref_name }} (${{ github.sha }})","level":"high"}'

- name: Notify on success
  if: success()
  run: |
    curl -X POST "https://api.pocketalert.app/v1/messages" \
      -H "Token: ${{ secrets.POCKETALERT_API_KEY }}" \
      -H "Content-Type: application/json" \
      -d '{"title":"Deploy succeeded","message":"${{ github.repository }}@${{ github.sha }}"}'
```

### 3. Arahkan ke aplikasi tertentu

Tambahkan `application_id` ke body untuk mengirim push ke satu aplikasi (temukan TID di dasbor):

```
-d '{"title":"Release shipped","message":"${{ github.repository }} ${{ github.ref_name }}","application_id":"qm47b9pzxzxg"}'
```

The [dokumentasi memulai](https://info.pocketalert.app/getting-started.html) menjelaskan setiap field yang diterima API pesan.

## FAQ

### Bagaimana cara mendapatkan notifikasi GitHub Actions di ponsel saya?

Tambahkan langkah yang menjalankan curl ke https://api.pocketalert.app/v1/messages dengan kunci API Anda di header Token. Letakkan di akhir job agar deploy yang selesai atau build yang gagal langsung dikirim ke ponsel Anda.

### Bagaimana cara menjaga kerahasiaan kunci?

Simpan kunci API Anda sebagai secret repositori dan baca dengan ${{ secrets.POCKETALERT_API_KEY }}, lalu kirim di header Token. Kunci tidak akan pernah muncul di log, dan Anda bisa mengganti kuncinya dari dasbor Pocket Alert.

### Bisakah saya hanya diberi notifikasi saat gagal?

Gunakan if: failure() dan if: success() pada dua langkah terpisah. Build yang gagal memicu satu pesan, deploy yang berhasil memicu pesan lain, sehingga Anda bisa menghubungkan hanya hasil yang Anda pedulikan.

### Bisakah saya memisahkan notifikasi per repo?

Berikan setiap repo atau lingkungan aplikasinya sendiri. Workflow frontend, backend, dan rilis masuk ke saluran terpisah yang bisa Anda bisukan secara independen.

### Bisakah saya menyertakan commit dan workflow?

Sertakan konteks run seperti ${{ github.repository }}, ${{ github.sha }}, dan ${{ github.workflow }} di isi pesan agar notifikasi memberi tahu Anda run mana yang selesai.

### Endpoint mana yang dipanggil langkah ini?

Langkah ini memanggil https://api.pocketalert.app/v1/messages dengan header Token dan body JSON berisi title dan message. Tambahkan application_id untuk mengarahkan push ke aplikasi tertentu.

### Bisakah build yang gagal lebih mencolok daripada yang berhasil?

Tambahkan "level":"high" ke body langkah kegagalan, dan push akan menembus Fokus di iPhone serta berdering menonjol di Android; "level":"critical" lebih jauh lagi dengan melewati Jangan Ganggu sepenuhnya. Notifikasi deploy yang berhasil bisa dikirim dengan "level":"silent" sehingga masuk ke riwayat tanpa getaran.
