Buat workflow yang selesai getarkan ponsel Anda.
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.
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.
Tiga langkah untuk notifikasi GitHub Actions di ponsel Anda
Buat aplikasi
Tambahkan aplikasi di Pocket Alert dan simpan kunci API Anda sebagai secret repo POCKETALERT_API_KEY.
Pasang langkahnya
Tambahkan langkah notify yang menjalankan curl ke API pesan, menggunakan if: failure() dan if: success() untuk memilih hasil.
Petakan dan kirim
Masukkan repo, sha, dan workflow ke dalam pesan. Run berikutnya akan menggetarkan ponsel Anda.
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 menjelaskan setiap field yang diterima API pesan.
Pertanyaan yang sering diajukan
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.
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.
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.
Berikan setiap repo atau lingkungan aplikasinya sendiri. Workflow frontend, backend, dan rilis masuk ke saluran terpisah yang bisa Anda bisukan secara independen.
Sertakan konteks run seperti ${{ github.repository }}, ${{ github.sha }}, dan ${{ github.workflow }} di isi pesan agar notifikasi memberi tahu Anda run mana yang selesai.
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.
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.
Pastikan deploy berhasil tanpa harus memantau setiap run.
Buat aplikasi, ambil kunci API Anda, lalu tambahkan langkah Pocket Alert ke workflow Anda.