Belajar n8n - Integrasi Native Nodes & Popular APIs

#Pendahuluan

Di episode 7 kalian sudah menjadikan workflow tahan banting: error workflow untuk penanganan terpusat, retry untuk error transien, continue on fail untuk toleransi batch, dan fallback path plus alerting supaya kegagalan selalu terlihat. Sekarang saatnya workflow kalian berinteraksi dengan layanan yang benar-benar dipakai di produksi.

Episode ini membahas Integrasi Native Nodes & Popular APIs. Kita mulai dari konsep kredensial terpusat yang menjadi tulang punggung semua integrasi, lalu praktik menggunakan node native untuk email, Slack, Google Workspace, GitHub, dan database. Kita tutup dengan cara mengelola versi dan update node supaya integrasi tidak rusak oleh perubahan upstream.

#Kredensial Terpusat: Sekali Simpan, Dipakai di Mana-Mana

n8n menyimpan kredensial secara terpusat di instance, terpisah dari workflow. Kalian membuat satu profil kredensial — misalnya profil Slack bernama slack-tim-billing — lalu profil itu bisa dipakai di banyak node dan banyak workflow. Perubahan di profil langsung berlaku di semua pemakaiannya.

Cara kerjanya: buka Settings > Credentials, pilih tipe kredensial (OAuth2 untuk Google Workspace, API Key untuk Slack, dsb), isi formulirnya, lalu simpan. Saat menyambungkan node, kalian cukup memilih profil yang sudah ada dari dropdown — tidak perlu mengisi rahasia berkali-kali.

n8n mendukung dua gaya autentikasi utama: API Key/Basic Auth untuk layanan yang memberi token statis, dan OAuth2 untuk layanan seperti Google dan Slack yang membutuhkan token refresher. Node yang memakai OAuth2 otomatis menangani refresh token — kalian cukup melakukan satu kali authorize.

#Integrasi Email

Node email di n8n terbagi dua keluarga: node Send Email generik lewat protokol SMTP, dan node native per provider seperti Gmail dan SendGrid.

Untuk SMTP generik, profil kredensial butuh host, port, dan kredensial akun. Contoh untuk self-hosted mail server:

host: smtp.example.com
port: 587
secure: false
user: no-reply@example.com
password: rahasia-jangan-commit

Dengan node Send Email, kalian bisa mengambil alamat penerima dari item, misalnya $json.email dari data customer, lalu mengirim email personal. Untuk Gmail, gunakan node native dengan kredensial OAuth2 — kalian bahkan bisa membaca, memfilter, dan membalas email, bukan hanya mengirim. Pola klasiknya: trigger email baru → parse isinya → buat task atau balas otomatis.

Satu saran untuk email yang masuk ke inbox orang sungguhan: gunakan template yang konsisten dan selalu sertakan konteks — nama penerima, nomor referensi, dan aksi yang diharapkan. Email hasil automasi yang terasa manusiawi jauh lebih kecil kemungkinannya dilaporkan sebagai spam, dan ini hal yang sering diremehkan saat membangun otomasi komunikasi.

#Integrasi Slack

Slack adalah kanal notifikasi paling populer di kalangan tim. Node native Slack mendukung kirim pesan ke channel atau user, membuat thread, upload file, hingga membuat channel baru.

Node IF (gagal) -> Slack node
  channel: #ops
  text: "Workflow sinkronisasi gagal di batch 3"

Profil kredensial Slack biasanya bertipe OAuth2 atau App Access Token. Kombinasi yang paling berguna: hubungkan Slack ke error workflow dari episode 7, sehingga setiap kegagalan otomatis masuk ke channel tim — lengkap dengan nama workflow dan link execution. Inilah bentuk alerting actionable yang sudah kita janjikan sebelumnya.

#Google Workspace & GitHub

Node Google Workspace sebenarnya adalah keluarga besar: Gmail, Google Drive, Google Sheets, Google Calendar, Google Docs, dan Google Cloud Storage. Semuanya memakai profil OAuth2 yang sama — sekali authorize, semua node Google bisa memakainya.

Membaca baris dari Google Sheets via node native

// Node: Google Sheets -> Read rows
// Output per item mewakili satu baris spreadsheet
// Contoh item: { "nama": "Budi", "email": "budi@example.com", "orders": 12 }

Sementara itu node GitHub memungkinkan automasi seputar repository: membuat issue, mengomentari PR, menutup issue lama, hingga memicu workflow bila ada rilis baru. Contoh nyata: poll issues dengan label bug yang sudah tidak aktif 30 hari, lalu auto-close dan komentari alasannya. Dengan kredensial terpusat, satu profil GitHub bisa dipakai semua workflow otomasi repo.

Yang perlu diperhatikan: tiap integrasi punya kebiasaan tersendiri dalam urusan rate limit. Google dan GitHub sangat ketat soal batas request per menit, sementara Slack lebih longgar. Bila workflow kalian memanggil node yang sama berulang kali dalam satu eksekusi — misalnya membaca banyak file di Drive — sisipkan node Wait atau Delay untuk jeda ringan antar panggilan, supaya integrasi tidak terkena rate limit di tengah proses. Node ini menerima nilai jeda lewat parameter waitTime yang bisa diisi ekspresi seperti $json.batchDelay.

#Database Nodes

Database sering menjadi ujung sink data. n8n menyediakan node native untuk banyak engine: PostgreSQL, MySQL, MongoDB, Redis, SQLite, dan lainnya. Tiap node punya operasi umum seperti insert, update, delete, dan execute query.

SELECT id, name, email
FROM customers
WHERE is_premium = true
  AND signup_date >= '2026-01-01';

Hasil query otomatis menjadi item yang bisa diproses node berikutnya — inilah cara men-seed workflow dengan data database. Profil kredensial database menyimpan host, port, database, user, dan password dalam satu tempat, sehingga berpindah dari lingkungan development ke produksi cukup dengan mengganti profil. Kita akan menggali database lebih dalam di episode 10.

Penting untuk diingat: tulis query dengan parameterized query, bukan menempelkan nilai langsung ke string SQL. Bila nilai berasal dari payload webhook atau isi email, string SQL yang dirangkai secara manual berisiko terkena SQL injection. n8n menyediakan placeholder untuk parameter sehingga nilainya di-bind secara aman — biasakan pola ini sejak awal.

#Mengelola Versi & Update Node

Integrasi tidak statis — API upstream berubah, node diperbaiki, dan n8n sendiri terus dirilis. Karena itu ada beberapa disiplin yang perlu kalian pegang:

• Update n8n secara rutin — setiap rilis membawa perbaikan node dan keamanan. Lakukan di lingkungan staging dulu, uji workflow, baru naik ke produksi.
• Community nodes — node dari komunitas diinstall via npm. Sebelum install, periksa jumlah download dan kepemilikan; node yang kurang terawat adalah risiko keamanan.
• Versioning node — beberapa node mendukung beberapa versi API provider; set versi secara eksplisit bila tersedia agar upgrade n8n tidak mengubah perilaku node secara diam-diam.
• Re-test setelah upgrade — jalankan eksekusi uji pada workflow kritis pasca-update, karena perubahan minor bisa mengubah format output.

n8n --version
npm update -g n8n@latest

Dengan manajemen versi yang disiplin, integrasi kalian tidak mudah patah oleh perubahan di luar kendali.

#Penutup

Episode 8 menghubungkan workflow kalian ke layanan nyata: kredensial terpusat yang sekali simpan dan dipakai ulang di banyak node, integrasi native untuk email, Slack, Google Workspace, GitHub, dan database, serta disiplin versi dan update supaya integrasi tetap sehat. Kalian kini bisa membangun workflow yang benar-benar bekerja dengan alat yang tim pakai sehari-hari.

Inti yang harus dibawa pulang:

• Kredensial terpusat — simpan sekali, pakai di banyak node, cabut akses tanpa menyentuh workflow.
• Pilih node native sesuai provider: Gmail dan SendGrid untuk email, Slack untuk notifikasi tim.
• Google Workspace berbagi satu profil OAuth2 untuk semua layanan Google.
• Database nodes mengubah hasil query menjadi item yang bisa diproses langsung.
• Disiplin update — upgrade di staging, uji ulang, dan perhatikan versi node.

Di episode 9 berikutnya kita balik arah: alih-alih memanggil API pihak lain, kalian akan belajar webhooks & API automation — membangun webhook-driven workflow yang menerima event eksternal dan bahkan mengekspos API dari workflow n8n sendiri. Sampai jumpa!