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

> Kirim push notification ke iPhone atau HP Android dari n8n. Satu node HTTP Request, sub-workflow "Send push" yang dipakai bersama, error workflow yang mengabari Anda saat ada yang gagal, dan tombol Setujui serta Tolak yang melanjutkan workflow yang sedang menunggu.

*30.10.2026*

<!-- source: https://pocketalert.app/id/blog/n8n-push-notifications -->

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](/get-app) Anda. [Daftar](/signup) gratis.
- Kunci API dari [Kunci API](/account/apikeys).

## 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:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Field</th><th>Nilai</th></tr></thead>
<tbody>
<tr><th>Method</th><td><code>POST</code></td></tr>
<tr><th>URL</th><td><code>https://api.pocketalert.app/v1/messages</code></td></tr>
<tr><th>Authentication</th><td><strong>Generic Credential Type</strong>, lalu <strong>Header Auth</strong>, lalu kredensial <code>Pocket Alert</code></td></tr>
<tr><th>Send Body</th><td>On</td></tr>
<tr><th>Body Content Type</th><td><code>JSON</code></td></tr>
<tr><th>Specify Body</th><td><strong>Using JSON</strong></td></tr>
</tbody>
</table>
</div>

Body membutuhkan `title` dan `message`. `level` dan `actions` bersifat opsional. Cara yang paling mudah ditulis adalah JSON biasa dengan ekspresi di dalam string:

```json
{
  "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:

```js
{{ 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:

```http
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](https://info.pocketalert.app/features/priority-levels.html).

## 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**):

```json
{
  "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:

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Input</th><th>Ekspresi</th></tr></thead>
<tbody>
<tr><th>title</th><td><code>Failed: {{ $json.workflow.name }}</code></td></tr>
<tr><th>message</th><td><code>{{ ($json.execution?.lastNodeExecuted ?? 'Trigger') + ': ' + ($json.execution ?? $json.trigger).error.message }}</code></td></tr>
<tr><th>level</th><td><code>high</code></td></tr>
<tr><th>url</th><td><code>{{ $json.execution?.url ?? '' }}</code></td></tr>
</tbody>
</table>
</div>

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):

```json
{
  "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](/use-cases/form-submission-alerts).

### 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](/use-cases/automation-alerts).

## 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](/features/action-buttons) 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:

```js
{{ 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](/blog/human-in-the-loop-notifications).

## Atau POST ke webhook Pocket Alert

Jika Anda tidak ingin menyimpan kunci API di n8n, buat webhook di [Webhooks](/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](https://info.pocketalert.app/features/daily-limits.html).
- **`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](/blog/make-com-integration) 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](/signup), impor workflow Send push, dan arahkan error workflow Anda ke sana. Eksekusi gagal berikutnya akan muncul di HP Anda, bukan hanya di daftar eksekusi.
