Kembali ke Blog

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

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

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:

FieldNilai
MethodPOST
URLhttps://api.pocketalert.app/v1/messages
AuthenticationGeneric Credential Type, lalu Header Auth, lalu kredensial Pocket Alert
Send BodyOn
Body Content TypeJSON
Specify BodyUsing 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:

InputEkspresi
titleFailed: {{ $json.workflow.name }}
message{{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }}
levelhigh
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.url dari N8N_EDITOR_BASE_URL, dengan cadangan URL webhook. Dalam tes, hasilnya localhost, yang tidak berguna di HP. Pada instance self-hosted, atur N8N_EDITOR_BASE_URL ke 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.error alih-alih execution, 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:

  1. Sebuah trigger dengan permintaan, di sini node Webhook yang menerima {"order":"A-1042","amount":129}.
  2. Node HTTP Request yang mengirim push dengan dua tombol.
  3. Node Wait: Resume diatur ke On Webhook Call, HTTP Method POST, Limit Wait Time diaktifkan, 2 jam.
  4. Node If: {{ $json.body.decision }} sama dengan approve.

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=approve merusak signature dan n8n menjawab 401. 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.resumeUrl dibentuk dari URL webhook Anda (WEBHOOK_URL, yang di n8n 2.45 diminta untuk diganti namanya menjadi N8N_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.
  • 401 berarti kuncinya salah, atau nama header di kredensial bukan Token.
  • 400 berarti body tidak memiliki title atau message (ekspresi yang menghasilkan nilai kosong dihitung sebagai tidak ada), memiliki level yang tidak dikenal, atau memiliki tombol yang tidak valid: lebih dari 3, URL view yang bukan http(s), atau nilai http yang bukan string JSON dengan url.
  • "not valid JSON" di n8n berarti sebuah nilai merusak body JSON. Beralihlah ke JSON.stringify seperti 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.

Bagikan artikel ini