Cara Mengatasi Error Umum Saat Menghubungkan n8n ke WordPress

Semua sudah mengikuti panduan dengan benar — lalu node n8n berubah merah dan muncul pesan error yang tidak bisa dibaca. Tenang: error saat menghubungkan n8n ke WordPress itu normal, dan hampir seluruhnya bermula dari enam penyebab yang sama. Artikel ini adalah kamus solusinya, disusun dari error yang paling sering muncul.

Simpan artikel ini sebagai referensi. Setiap error dibahas dengan format yang sama: pesan yang muncul, arti sesungguhnya, penyebab, dan langkah perbaikan berurutan. Dengan pola itu, debugging tidak lagi menebak-nebak — tapi menelusuri secara sistematis sampai ketemu.

Cara Membaca Error dengan Benar Sebelum Memperbaiki

Sebelum masuk daftar error, satu skill yang mengubah cara Anda debugging: membaca pesan errornya sampai tuntas. Klik node yang merah, buka panel output, dan perhatikan tiga informasi ini:

• Kode status HTTP (401, 403, 404, 500) — angka ini menunjuk lapisan masalahnya: autentikasi, izin, alamat, atau server.
• Field “code” dari WordPress (misalnya rest_not_logged_in) — kode resmi WordPress yang bisa langsung dicari.
• Field “message” — kalimat manusia yang menjelaskan apa yang ditolak.

Dengan tiga informasi itu, hampir semua error n8n–WordPress bisa dipetakan ke solusi dalam hitungan menit. Kebalikannya, menebak tanpa membaca error adalah cara tercepat buang waktu satu sore.

Alat bantu kedua: jalankan node yang gagal satu per satu (Execute step) alih-alih seluruh workflow. Titik persis di mana data berhenti mengalir adalah lokasi masalahnya.

Error 401: rest_not_logged_in atau invalid_credentials

Gejala: WordPress menolak koneksi dengan pesan “You are not currently logged in” atau kredensial invalid, padahal username-password terasa benar.

Penyebab paling umum: memakai password login biasa untuk API. WordPress memang tidak menerima password akun lewat REST API — itu desain keamanan, bukan bug. Penyebab kedua: Application Password tersalin tidak utuh (terpotong di tengah, atau spasi pemisahnya dihapus/diubah).

Solusi berurutan:

1. Buat Application Password baru: Users → Profile → Application Passwords → Add New.
2. Salin utuh apa adanya termasuk spasi pemisah — jangan diketik manual, jangan diubah.
3. Pastikan username yang diisi di n8n adalah username akun, bukan email (beberapa instalasi menerima keduanya, banyak yang tidak).
4. Di n8n, buat credential baru dengan data tersebut dan test connection.

Bila masih 401 setelah itu, periksa apakah ada plugin security yang memblokir Application Authentication, atau apakah situs memakai dua faktor yang memengaruhi kredensial.

Error 403: rest_cannot_publish atau rest_forbidden

Gejala: koneksi berhasil diuji, tapi saat create post muncul “Sorry, you are not allowed to do that”.

Artinya: autentikasi sukses — user dikenali — tapi user itu tidak punya izin untuk aksi yang diminta. Klasiknya: kredensial dibuat dari akun kontributor (boleh draft, tidak boleh publish) atau subscriber (ditolak semua).

Solusi: gunakan akun administrator atau editor untuk kredensial n8n. Alternatif aman bila tidak ingin memberi akses admin: buat akun khusus ber-role editor hanya untuk otomasi. Bila aksi yang ditolak adalah edit post milik user lain, upgrade role atau buat workflow memakai user pemilik konten tersebut.

Error 404: wp-json Tidak Ditemukan

Gejala: “No route was found matching the URL” atau halaman 404 ketika n8n memanggil /wp-json/.

Artinya: endpoint REST API tidak terjangkau. WordPress modern selalu punya REST API bawaan — jadi bila 404, ada yang memblokirnya.

Penyebab & solusi:

• URL salah: periksa Base URL di credential — harus lengkap dengan https dan tanpa garis miring dobel. Coba buka https://websiteanda.com/wp-json/wp/v2/posts?per_page=1 di browser; bila keluar JSON, REST API sehat dan masalahnya di kredensial n8n.
• Plugin security memblokir: plugin firewall/security kadang mematikan atau melindungi REST API. Whitelist path /wp-json/ atau aktifkan opsi “REST API available to logged-in users”.
• Pretty permalink mati: REST API butuh permalink non-plain. Set Settings → Permalinks ke format apa pun selain Plain.
• Prefix custom: beberapa situs mengganti prefix wp-json; sesuaikan Base URL n8n dengan prefix yang benar.

Error 413 / 429: Payload Terlalu Besar atau Dibatasi

Gejala: upload gambar featured gagal dengan 413 (request entity too large) atau 429 (too many requests) saat workflow berjalan massal.

Solusi 413: kompres gambar sebelum upload (turunkan dimensi/kualitas), atau naikkan batas upload di server (upload_max_filesize, client_max_body_size bila pakai Nginx). Gambar featured sebenarnya tidak perlu lebih dari 200–500 KB.

Solusi 429: beri jeda antar item — di n8n gunakan node Wait antar batch, atau aktifkan Retry On Fail dengan interval di node yang kena limit. Untuk publish massal artikel, kecepatan satu artikel per menit sudah sangat cepat dan aman.

Error Timeout dan Koneksi Terputus

Gejala: workflow berhenti di tengah dengan “Connection timed out” atau “socket hang up”, biasanya saat upload besar atau server sedang lambat.

Solusi: aktifkan retry (Settings → Retry On Fail, 2–3 kali) pada node yang berkomunikasi jauh — upload media dan create post. Bila server WordPress memang sering lambat, jalankan workflow di jam sepi dan pecah batch besar menjadi kelompok kecil. Timeout yang sehat lebih baik daripada upload yang setengah jalan.

Error Konten: Karakter Aneh, HTML Rusak, atau Post Kosong

Gejala: post terbit tapi isinya kosong, karakter aneh muncul (’, Â), atau tampilan berantakan.

Penyebab & solusi:

• Post kosong: field content tidak tersambung — cek ekspresi di node, pastikan mengarah ke field output node AI (misalnya {{ $json.output }} atau nama field yang benar). Buka panel output node sebelumnya untuk melihat nama field persisnya.
• Karakter aneh: masalah encoding. Pastikan seluruh rantai memakai UTF-8; hindari menyalin teks lewat aplikasi yang mengubah encoding.
• HTML rusak/terpotong: output AI terpotong karena limit token. Naikkan max token pada node model, atau pecah penulisan artikel menjadi dua panggilan AI.
• Markdown bocor: bila output AI masih berformat markdown (##, **), minta AI menghasilkan HTML murni di prompt, atau tambahkan node Code untuk konversi.

Semua masalah konten bermuara ke satu kebiasaan: selalu inspeksi output node sebelumnya sebelum menyalahkan node yang gagal. Data yang salah bentuk adalah penyebab nomor satu error “misterius”.

Checklist Anti-Gagal Sebelum Workflow Aktif

Sebagai penutup, daftar periksa singkat sebelum toggle Active dinyalakan:

• Test connection di credential WordPress hijau.
• Workflow dijalankan manual satu kali penuh tanpa error.
• Artikel hasil uji dibuka di browser — judul, isi, gambar featured, dan kategori lengkap.
• Status awal diset draft selama beberapa hari pertama, baru dilepas ke publish.
• Retry On Fail aktif di node upload dan publish.
• Notifikasi error diset (Error Workflow) agar kegagalan mengabarkan, bukan diam-diam.

Enam centang ini menutup hampir semua celah yang biasanya menjadi sumber error di produksi.

Error Umum n8n–WordPress: Kesimpulan

Error saat menghubungkan n8n ke WordPress bukan tanda gagal — melainkan bagian normal dari membangun sistem. Dengan membaca kode status, menelusuri node satu per satu, dan memakai kamus solusi di atas, hampir semua masalah selesai dalam hitungan menit.

Dan bila Anda ingin lompati fase trial-and-error ini sepenuhnya: ebook tutorial n8n auto-artikel SEO ke WordPress + template siap import sudah mengantisipasi jebakan-jebakan di atas — setting yang benar sejak awal, sehingga error umum tidak sempat muncul.

Sistem yang sehat dibangun dari pemahaman error, bukan dari ketiadaan error. Selamat debugging — sekarang Anda punya kamusnya.