n8n push notification: kirim notifikasi ke HP dari workflow apa pun

n8n bagus untuk menjalankan tugas saat Anda sedang pergi, tetapi kurang baik dalam memberi tahu Anda tentang hasilnya. Sebuah formulir masuk, feed mendapat postingan baru, sinkronisasi gagal pukul 3 pagi, dan satu-satunya catatannya adalah satu baris di daftar eksekusi yang baru Anda buka minggu depan.
Panduan ini menghubungkan n8n ke HP Anda. Anda akan memanggil API Pocket Alert dari node HTTP Request, membungkus pemanggilan itu dalam satu sub-workflow yang bisa dipakai ulang, menambahkan error workflow yang mengabari Anda saat workflow mana pun gagal, dan diakhiri dengan tombol Setujui serta Tolak yang melanjutkan workflow dari layar kunci.
Semua yang ada di bawah ini diuji pada n8n 2.45.7 (image Docker n8nio/n8n), dengan node HTTP Request diarahkan ke penangkap permintaan lokal sehingga setiap permintaan bisa dicocokkan dengan referensi API.
Yang Anda butuhkan
- Instance n8n: self-hosted atau n8n Cloud.
- Akun Pocket Alert dan aplikasinya di iPhone atau Android Anda. Daftar gratis.
- Kunci API dari Kunci API.
Langkah 1: kredensial Header Auth
Pocket Alert membaca kunci API dari header bernama Token. Di n8n, buat kredensial bertipe Header Auth:
- Name:
Token - Value: kunci API Anda
Beri nama kredensial Pocket Alert. Menyimpan kunci sebagai kredensial membuatnya tidak masuk ke JSON workflow, sehingga Anda bisa mengekspor dan membagikan workflow tanpa membocorkan kunci.
Langkah 2: node HTTP Request
Tambahkan node HTTP Request dan atur seperti ini:
| Field | Nilai |
|---|---|
| Method | POST |
| URL | https://api.pocketalert.app/v1/messages |
| Authentication | Generic Credential Type, lalu Header Auth, lalu kredensial Pocket Alert |
| Send Body | On |
| Body Content Type | JSON |
| Specify Body | Using JSON |
Body membutuhkan title dan message. level dan actions bersifat opsional. Cara yang paling mudah ditulis adalah JSON biasa dengan ekspresi di dalam string:
{
"title": "New signup",
"message": "{{ $json.name }} on {{ $json.plan }}",
"level": "high"
}
Cara ini berhasil sampai sebuah nilai berisi tanda kutip ganda atau pindah baris. Jika name berisi Ana "AJ" Silva, n8n menghentikan node dengan pesan "The value in the JSON Body field is not valid JSON", karena tanda kutip itu menutup string lebih awal. Pesan formulir dan judul RSS mengalami hal ini lebih cepat dari perkiraan.
Solusinya adalah membiarkan JavaScript yang membangun JSON. Letakkan seluruh body dalam satu ekspresi:
{{ JSON.stringify({
title: 'New signup',
message: $json.name + ' on ' + $json.plan,
level: 'high'
}) }}
Atau, jika Anda lebih suka mempertahankan tata letak JSON, bungkus setiap nilai dinamis dengan JSON.stringify() dan hapus tanda kutip di sekitarnya: "message": {{ JSON.stringify($json.name + ' on ' + $json.plan) }}. Keduanya menghasilkan JSON yang valid dengan tanda kutip yang di-escape saat diuji. Berikut yang dikirim n8n:
POST /v1/messages
Content-Type: application/json
Token: <your API key>
User-Agent: n8n
{"title":"New signup","message":"Ana \"AJ\" Silva on Pro","level":"high"}
level menerima silent, low, default, high atau critical. high menembus Fokus di iPhone. critical tetap berbunyi meski tombol senyap dan Jangan Ganggu aktif. Ini fitur berbayar; di paket gratis, nilainya menjadi high. Selengkapnya di tingkat prioritas.
Langkah 3: satu sub-workflow "Send push" untuk semuanya
Menyalin node itu ke setiap workflow berarti mengubah sepuluh workflow saat Anda mengganti kunci, logika level, atau tombolnya. Simpan saja dalam satu sub-workflow dan panggil dari tempat lain.
Salin JSON ini dan tempelkan ke kanvas n8n yang kosong (atau simpan sebagai file dan gunakan Import from File):
{
"name": "Send push",
"nodes": [
{
"parameters": {
"workflowInputs": {
"values": [
{ "name": "title" },
{ "name": "message" },
{ "name": "level" },
{ "name": "url" }
]
}
},
"name": "When called",
"type": "n8n-nodes-base.executeWorkflowTrigger",
"typeVersion": 1.1,
"position": [0, 0]
},
{
"parameters": {
"method": "POST",
"url": "https://api.pocketalert.app/v1/messages",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "={{ JSON.stringify({\n title: $json.title,\n message: $json.message,\n level: $json.level || 'default',\n actions: $json.url ? [{ type: 'view', label: 'Open', value: $json.url }] : []\n}) }}",
"options": {}
},
"name": "Pocket Alert",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.2,
"position": [220, 0]
}
],
"connections": {
"When called": { "main": [[{ "node": "Pocket Alert", "type": "main", "index": 0 }]] }
},
"settings": { "executionOrder": "v1" }
}
Setelah diimpor, buka node Pocket Alert dan pilih kredensial Anda. Sub-workflow ini menerima empat input: title, message, level opsional yang kembali ke default, dan url opsional. Jika url diisi, push akan mendapat tombol Open yang membukanya. Array actions yang kosong tetap diterima dan artinya tidak ada tombol.
Publikasikan. Di n8n 2.x, eksekusi produksi memanggil versi sub-workflow yang sudah dipublikasikan. Selama Send push belum dipublikasikan, setiap pemanggilan terjadwal atau yang dipicu webhook gagal dengan pesan "Workflow is not active and cannot be executed", meskipun tes manual dari editor berhasil, karena eksekusi manual memakai draf. Hal yang sama berlaku setelah perubahan: perubahan pada Send push baru sampai ke produksi setelah Anda mempublikasikannya lagi.
Untuk memanggilnya dari workflow lain, tambahkan node Execute Sub-workflow, pilih Send push dari daftar, lalu isi keempat field dengan ekspresi, misalnya New order #{{ $json.id }} untuk judul.
Dapatkan push saat workflow mana pun gagal
n8n menjalankan error workflow terpisah ketika sebuah eksekusi produksi gagal. Buat workflow bernama Error alert dengan node Error Trigger, diikuti node Execute Sub-workflow yang memanggil Send push dengan field berikut:
| Input | Ekspresi |
|---|---|
| title | Failed: {{ $json.workflow.name }} |
| message | {{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }} |
| level | high |
| url | {{ $json.execution?.url ?? '' }} |
Publikasikan Error alert juga; di 2.x, error workflow yang belum dipublikasikan dilewati dengan pesan "not active" yang sama di log. Lalu buka setiap workflow yang penting bagi Anda, masuk ke Workflow settings, dan atur Error workflow ke Error alert.
Untuk memeriksa jalurnya, sebuah workflow bernama "Sync orders" sengaja dibuat gagal: node HTTP Request-nya menerima 503. Error Trigger menerima data berikut (dipangkas):
{
"execution": {
"id": "5",
"url": "http://localhost:5678/workflow/WPErAWNJyV6MWO11/executions/5",
"error": {
"message": "Service unavailable - try again later or consider setting this node to retry automatically (in the node settings)",
"description": "down",
"httpCode": "503"
},
"lastNodeExecuted": "Fetch orders",
"mode": "webhook"
},
"workflow": { "id": "WPErAWNJyV6MWO11", "name": "Sync orders" }
}
HP menerima "Failed: Sync orders" dengan "Fetch orders: Service unavailable..." dan tombol Open yang mengarah ke eksekusi tersebut. Ada dua detail yang penting:
- Tautan eksekusi memakai URL publik Anda. n8n membentuk
execution.urldariN8N_EDITOR_BASE_URL, dengan cadangan URL webhook. Dalam tes, hasilnyalocalhost, yang tidak berguna di HP. Pada instance self-hosted, aturN8N_EDITOR_BASE_URLke alamat tempat Anda membuka n8n. - Trigger yang gagal tampak berbeda. Ketika trigger itu sendiri gagal, misalnya feed RSS yang mengembalikan HTML, tidak ada eksekusi. Payload memiliki
trigger.erroralih-alihexecution, dan tidak ada URL. Operator?.dan??pada ekspresi di atas menangani kasus ini; saat diuji, hasilnya "Failed: Changelog to phone" dengan "Trigger: Non-whitespace before first tag..." dan tanpa tombol.
Tiga workflow yang benar-benar sering dibuat
Ketiganya berakhir di node Execute Sub-workflow yang sama yang memanggil Send push. Ketiganya dijalankan melalui penangkap dan menghasilkan permintaan yang valid.
Pengiriman formulir baru
Sebuah n8n Form Trigger dengan tiga field berlabel Name, Email dan Message. Output formulir menggunakan label sebagai kunci, sehingga inputnya adalah:
- title:
Contact form: {{ $json.Name }} - message:
{{ $json.Email }}dan{{ $json.Message }}di baris berikutnya - level:
default
Biarkan url kosong di sini. Tombol view membutuhkan URL http(s), sehingga tautan mailto: akan membuat permintaan ditolak dengan 400. Hal yang sama juga bisa dilakukan dengan node Webhook di belakang formulir situs Anda sendiri: field-field-nya kemudian berada di bawah $json.body. Ide lainnya ada di notifikasi pengiriman formulir.
Postingan baru di feed RSS
Sebuah RSS Feed Trigger yang memeriksa changelog atau blog setiap 10 menit:
- title:
New post: {{ $json.title }} - message:
{{ $json.contentSnippet }} - level:
low - url:
{{ $json.link }}
contentSnippet adalah deskripsi tanpa HTML, sehingga <p>You can now work <b>offline</b>.</p> diterima sebagai teks biasa. Trigger hanya mengeluarkan item yang lebih baru dari item terakhir yang dilihatnya, jadi saat diaktifkan, Anda tidak akan dibanjiri arsip. Tombol Open mengarah ke postingan tersebut.
Pemeriksaan terjadwal
Schedule Trigger setiap 5 menit, lalu node HTTP Request yang melakukan GET ke situs Anda dengan dua opsi diaktifkan di bawah Response: Include Response Headers and Status dan Never Error. Tanpa Never Error, 503 akan menghentikan node dan tidak sampai ke langkah berikutnya. Lalu node If dengan {{ $json.statusCode }} tidak sama dengan 200, dan pada cabang true:
- title:
Site check failed: {{ $json.statusCode }} - level:
high - url: halaman yang sedang Anda periksa
Never Error hanya mencakup kode status yang buruk, bukan situs yang sama sekali tidak merespons. Kegagalan DNS atau timeout tetap membuat node gagal, dan kemudian error workflow yang mengirim push. Perlu diingat bahwa pemeriksaan seperti ini akan mengabari Anda di setiap eksekusi selama situs mati: dua belas push per jam pada interval 5 menit. Pola lainnya ada di notifikasi otomasi.
Setujui atau tolak dari layar kunci
Ada workflow yang seharusnya tidak selesai tanpa keterlibatan orang: pengembalian dana di atas batas, postingan yang akan dipublikasikan, agen AI yang akan menyentuh produksi. Pocket Alert http tombol aksi mengirim permintaan langsung dari HP, dan node Wait di n8n bisa menjeda hingga permintaan datang. Gabungkan keduanya:
- Sebuah trigger dengan permintaan, di sini node Webhook yang menerima
{"order":"A-1042","amount":129}. - Node HTTP Request yang mengirim push dengan dua tombol.
- Node Wait: Resume diatur ke On Webhook Call, HTTP Method
POST, Limit Wait Time diaktifkan, 2 jam. - Node If:
{{ $json.body.decision }}sama denganapprove.
Body node HTTP Request:
{{ JSON.stringify({
title: 'Refund $' + $json.body.amount + '?',
message: 'Order ' + $json.body.order + ' is asking for a refund.',
level: 'high',
actions: ['approve', 'decline'].map(decision => ({
type: 'http',
label: decision === 'approve' ? 'Approve' : 'Decline',
value: JSON.stringify({
url: $execution.resumeUrl,
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ decision })
})
}))
}) }}
http dari tombol value adalah string JSON itu sendiri, itulah sebabnya ada JSON.stringify di dalam JSON.stringify. $execution.resumeUrl adalah alamat yang didengarkan node Wait untuk eksekusi tunggal ini.
Dalam pengujian, POST ke URL tombol Setujui beserta body-nya mengembalikan 200, workflow dilanjutkan, dan $json.body.decision bernilai approve, sehingga node If mengambil cabang true. Tolak masuk ke cabang false. Detail yang butuh beberapa kali percobaan:
- Kirim keputusan di body, bukan di URL. Pada n8n 2.45.7, URL resume sudah berakhir dengan
?signature=.... Menambahkan?decision=approvemerusak signature dan n8n menjawab401. Body JSON menghindari manipulasi string. - Ketukan kedua ditolak. Setelah eksekusi dilanjutkan, ketukan lain mendapat
409"has finished already", dan aplikasi menampilkan notifikasi permintaan gagal dengan tombol Retry. Ketukan pertamalah yang berlaku. - Tanpa jawaban berarti tidak. Saat batas 2 jam habis, node Wait melanjutkan tanpa
decision, sehingga node If masuk ke cabang false. Jadikan cabang itu sebagai pilihan yang aman. - HP harus bisa menjangkau n8n. Permintaan dikirim dari HP, bukan dari Pocket Alert.
$execution.resumeUrldibentuk dari URL webhook Anda (WEBHOOK_URL, yang di n8n 2.45 diminta untuk diganti namanya menjadiN8N_WEBHOOK_URL). Di n8n Cloud atau di balik domain publik, ini langsung berfungsi. Di server rumahan, ini berfungsi selama HP berada di jaringan yang sama, atau lewat VPN seperti Tailscale. - Tombol adalah fitur berbayar. Di paket gratis, push tetap diterima tetapi tanpa tombol. Tombol notifikasi sistem membutuhkan aplikasi Pocket Alert 2.0.1 atau yang lebih baru.
Pola yang sama untuk agen AI ada di notifikasi human-in-the-loop.
Atau POST ke webhook Pocket Alert
Jika Anda tidak ingin menyimpan kunci API di n8n, buat webhook di Webhooks pada konsol dan minta node HTTP Request mengirim JSON dengan POST ke URL https://p4a.me/wh/... tanpa autentikasi. Sebuah template pada webhook mengubah payload menjadi pesan. Konsekuensinya: judulnya selalu Webhook <name>, dan teksnya berasal dari template, bukan dari workflow. Riwayat webhook mencatat setiap permintaan yang diterimanya, yang berguna saat men-debug.
Batasan dan pemecahan masalah
- Kuota harian. Paket gratis mengizinkan 50 pesan per hari, direset pukul 00:00 UTC. Loop dengan 200 item akan mengirim 200 push. Setelah batas tercapai, API menjawab
429; jangan biarkan n8n mencobanya lagi, jawabannya tidak akan berubah sampai reset. Lihat batas harian. 401berarti kuncinya salah, atau nama header di kredensial bukanToken.400berarti body tidak memilikititleataumessage(ekspresi yang menghasilkan nilai kosong dihitung sebagai tidak ada), memiliki level yang tidak dikenal, atau memiliki tombol yang tidak valid: lebih dari 3, URLviewyang bukanhttp(s), atau nilaihttpyang bukan string JSON denganurl.- "not valid JSON" di n8n berarti sebuah nilai merusak body JSON. Beralihlah ke
JSON.stringifyseperti pada Langkah 2. - Tidak ada yang terkirim saat gagal. Periksa apakah Error alert dan Send push keduanya sudah dipublikasikan dan workflow yang gagal sudah memiliki Error alert di pengaturannya. Tes manual dari editor tidak memicu error workflow.
FAQ
Apakah ada node Pocket Alert untuk n8n?
Belum saat ini. Node HTTP Request mencakup seluruh API, dan sub-workflow Send push memberi Anda blok seperti node yang cukup Anda atur sekali. Ada juga aplikasi Make resmi jika Anda menggunakan Make.
Apakah ini berfungsi di n8n Cloud?
Ya. Semua yang ada di sini menggunakan node bawaan. Di Cloud, URL eksekusi dan resume sudah publik, sehingga Anda terhindar dari konfigurasi URL yang dibutuhkan instance self-hosted.
Bisakah saya mengirim ke satu HP saja?
Tambahkan device_id dengan ID perangkat ke body. Tanpa itu, push dikirim ke semua perangkat Anda. application_id mengelompokkan pesan di bawah sebuah aplikasi, sehingga notifikasi n8n mendapat saluran sendiri di aplikasi.
Buat akun gratis, impor workflow Send push, dan arahkan error workflow Anda ke sana. Eksekusi gagal berikutnya akan muncul di HP Anda, bukan hanya di daftar eksekusi.