Lewati ke konten utama
Versi: 1.2

Integrasi n8n / Zapier / Make

Agent CLI hidup di terminal dan repo. Dunia nyata hidup di form, email, chat, dan webhook. Workflow automation platform (n8n, Zapier, Make) adalah lem di antaranya: mereka jago menerima event dari mana saja dan meneruskan ke mana saja, tapi tidak bisa berpikir — sedangkan agent jago berpikir tapi butuh dipicu. Gabungan keduanya:

[Event: form/email/chat/alert]
        │
        ▼
[n8n: terima webhook, rapikan payload, filter]
        │
        ▼
[Agent runner: kerjakan task di repo]
        │
        ▼
[n8n: kirim hasil ke Telegram/Slack, update tracker]

Kenapa n8n untuk solo engineer: self-hosted (data tetap di servermu), punya node Telegram/Slack/GitHub bawaan, dan gratis untuk skala pribadi. Zapier/Make lebih mudah tapi berbayar per-task dan data lewat cloud mereka — perhatikan ini kalau payload berisi data sensitif.

Resep: bug report dari form → agent triage → draft fix​

Skenario nyata: kamu punya Google Form / Typeform untuk bug report user. Targetnya: tiap laporan masuk otomatis di-triage agent, dan yang valid langsung dapat draft fix sebagai PR.

Siapkan endpoint agent di runner-mu

Di self-hosted runner, buat skrip HTTP kecil yang menerima POST dan menjalankan agent non-interaktif:

agent-webhook.sh (dipanggil oleh server HTTP mini, mis. via systemd + socat/caddy)
#!/usr/bin/env bash
set -euo pipefail
REPORT="$1"   # isi bug report (JSON dari n8n)

cd /srv/repo
claude -p "Bug report baru masuk:
$REPORT

Tugas:
1. Tentukan apakah ini bug valid, duplikat, atau bukan bug. 
2. Kalau valid: buat GitHub issue berlabel severity, lalu kerjakan
   draft fix di branch baru dan buka DRAFT PR yang me-link issue itu.
3. Kalau duplikat/bukan bug: cukup buat issue berlabel 'triage:rejected'
   dengan alasannya.
Balas dengan ringkasan 3 kalimat." --allowedTools "Bash,Edit,Write"

(Tab tool lain: ganti baris claude -p ... dengan opencode run "..." atau omp -p "..." — polanya identik.)

Checkpoint: menjalankan skrip manual dengan contoh report menghasilkan issue (dan PR bila valid) di repo.

Buat workflow n8n

Node yang dibutuhkan:

  1. Webhook — menerima submit form (atau node Typeform/Google Sheets trigger).
  2. IF — buang spam/kosong sebelum menyentuh agent (setiap eksekusi agent ada biayanya).
  3. Execute Command / HTTP Request — panggil endpoint agent runner dengan payload report.
  4. Telegram — kirim ringkasan balasan agent ke chat-mu, lengkap dengan link issue/PR.

Checkpoint: submit form percobaan → dalam beberapa menit kamu menerima pesan Telegram berisi ringkasan + link issue.

Pasang guardrail alur
  • Rate limit di n8n (mis. maksimal 10 eksekusi agent/jam) — form publik bisa dibanjiri.
  • Antrian, bukan paralel: set workflow agar eksekusi agent berjalan satu per satu; dua agent menulis di repo yang sama tanpa koordinasi = konflik (lihat Multi-Agent).
  • Secret di credential store n8n, bukan di node parameter.

Checkpoint: mengirim 20 submit beruntun tidak menghasilkan 20 proses agent paralel dan tagihan mengejutkan.

:::warning Webhook publik = permukaan serangan Endpoint yang memicu agent adalah remote code execution terselubung. Wajib: URL webhook rahasia + verifikasi signature/token di n8n, dan agent yang dipicu dari luar hanya boleh bekerja di branch + draft PR, tidak pernah punya jalur langsung ke production. :::

Variasi yang sama polanya​

  • Alert monitoring → agent investigasi: Grafana/Sentry webhook → n8n → agent membaca log dan menulis analisis awal ke channel on-call (lanjutan dari monitoring playbook).
  • Email klien → draft jawaban teknis: node IMAP → agent membaca konteks repo → draft balasan ke kamu untuk approve.
  • Voice note Telegram → task: n8n transkripsi → agent kerjakan → hasil kembali ke chat. Di titik ini kamu benar-benar "manajer yang berjalan-jalan".

Kalau kamu memakai Claude Code Routines, sebagian pola ini bisa hidup tanpa n8n — routine punya trigger webhook sendiri (lihat Cron & Routines). n8n tetap unggul saat butuh transformasi payload, banyak tujuan output, atau integrasi non-GitHub.

Diperbaharui pada