Node n8n

Paket Business

Node CRM n8n untuk kontak, kesepakatan, dan percakapan

Pasang n8n-nodes-pinlyx dari panel Community Nodes, tempelkan kunci API, lalu kiriman formulir menjadi kontak, kesepakatan yang dimenangkan menjadi faktur, dan percakapan yang belum dibalas menjadi pesan di kanal mana pun yang dipantau tim Anda. Delapan operasi pada tiga resource, tanpa dependensi runtime, berlisensi MIT.

Paket gratis selamanya · Tanpa kartu kredit · Batalkan kapan saja

Terakhir diperbarui:

3
Resource
Contact, Deal, Conversation
8
Operasi
Lima untuk kontak, dua untuk kesepakatan, satu untuk percakapan
0
Dependensi runtime
Setiap panggilan memakai helper HTTP bawaan n8n
MIT
Lisensi
Kode sumber di GitHub, dirilis ke npm

Definisi

Community node n8n adalah paket yang dirilis ke npm dan dipasang oleh instance n8n saat berjalan, sehingga muncul blok baru di kanvas. Ini bukan fork dari n8n, dan bukan penerima webhook yang harus Anda hosting dan jaga tetap hidup sendiri.

n8n-nodes-pinlyx adalah node milik Pinlyx. Node ini melakukan autentikasi dengan kunci API yang Anda buat di panel, lalu memberi alur kerja delapan operasi atas kontak, kesepakatan, dan percakapan, dengan paginasi kursor yang sudah ditangani untuk Anda.

Dirilis ke npm sebagai n8n-nodes-pinlyx, kode sumber di GitHub dengan lisensi MIT. Diuji pada n8n 1.60 ke atas dengan Node.js 20.15 ke atas. npm · GitHub

Node ini berbicara dengan REST API publik yang sama seperti yang dipakai skrip, jadi apa pun yang dilakukannya bisa diulang dengan curl, dan apa pun yang tidak bisa dilakukannya cukup ditangani dengan satu node HTTP Request.

Apa yang dibawa node ini ke alur kerja

Tiga resource, dipilih karena memang itulah yang benar-benar dibutuhkan sebuah otomasi. Semua aturan di sini ditegakkan oleh API, bukan oleh node.

Kontak, lima operasi

Buat, ambil, daftar, perbarui, dan arsipkan. Daftar bisa difilter berdasarkan pencarian, platform, email, external ID, dan Updated Since, yaitu filter yang dipakai sinkronisasi inkremental.

Kesepakatan, dua operasi

Buat kesepakatan dengan judul, nilai, mata uang, tahap, probabilitas, perkiraan tanggal penutupan, dan catatan. Daftar dengan filter tahap, kontak, dan pencarian judul.

Percakapan, hanya baca

Thread yang baru bergerak di semua kanal yang terhubung, terbaru di atas. Setiap baris memuat id kontak, kanal, penanda belum dibaca, dan cuplikan singkat pesan terakhir.

External ID mencegah duplikat

Tulis pengenal Anda sendiri pada kontak, dan saat dijalankan ulang permintaan ditolak dengan HTTP 409 yang menyebut data yang sudah ada, alih-alih diam-diam membuat salinan kedua untuk orang yang sama.

Paginasi kursor bawaan

Aktifkan Return All dan node akan menelusuri setiap halaman untuk Anda. Biarkan mati dan tetapkan batas. Satu halaman memuat paling banyak 100 baris untuk kontak dan kesepakatan, 50 untuk percakapan, jadi daftar besar tetap butuh banyak permintaan bagaimanapun cara Anda memintanya.

Kunci bercakupan, diperiksa di server

Kredensial menyimpan satu kunci API. Setiap operasi menyatakan cakupan yang dibutuhkannya, jadi kunci tanpa contacts:write akan gagal saat membuat kontak dengan 403, bukan tampak berhasil padahal tidak mengubah apa pun.

Memasang node

Node ini dirilis ke npm sebagai n8n-nodes-pinlyx dan dipasang seperti community node lainnya: dari dalam n8n, bukan dengan menyalin file ke server.

  1. Buka Settings, lalu Community Nodes. Anda memerlukan akun pemilik instance untuk ini. Akun anggota tidak bisa memasang paket.
  2. Tekan Install dan masukkan n8n-nodes-pinlyx. Setujui pemberitahuan community node lalu pasang. n8n mengambil paketnya, dan node muncul di pencarian kanvas dalam beberapa detik.
  3. Tambahkan node Pinlyx ke alur kerja. Node ini meminta kredensial sebelum Anda bisa memilih resource, jadi itulah yang perlu dibuat berikutnya.

Atau, di instance self-hosted, lewat baris perintah:

npm install n8n-nodes-pinlyx
# then restart n8n

Satu catatan yang perlu Anda ketahui sebelum membuat rencana: n8n Cloud hanya menyediakan community node yang sudah ditinjau dan diverifikasi oleh n8n sendiri, dan paket ini belum melewati tinjauan tersebut. Instance self-hosted bisa memasang paket apa pun yang sudah dirilis. Di Cloud, operasi yang sama bisa dijangkau lewat node HTTP Request ke REST API. Itu jawaban jujurnya, bukan detail yang ingin kami sembunyikan.

Paket ini tidak mendeklarasikan dependensi runtime. Setiap permintaan lewat helper HTTP bawaan n8n, dan itulah yang membuat kredensial bisa menyisipkan header Authorization sekaligus menjaga ukuran pemasangan tetap kecil.

Membuat kredensial

Node ini melakukan autentikasi dengan kunci API Pinlyx: satu kunci, satu header, tanpa bolak-balik OAuth.

  1. Buka Pengaturan, lalu Developer, di panel Pinlyx. Buat kunci dan beri nama sesuai alur kerja yang akan memakainya, agar Anda tahu apa yang berhenti bekerja saat kunci itu dicabut.
  2. Berikan hanya cakupan yang dibutuhkan alur kerja itu. Penulis kontak butuh contacts:read dan contacts:write. Laporan kesepakatan butuh deals:read. Percakapan dibaca dengan contacts:read.
  3. Salin token sekali saja. Kunci live diawali csk_live_ dan kunci uji diawali csk_test_. Token lengkap hanya ditampilkan saat dibuat dan tidak pernah lagi; setelah itu panel hanya menampilkan awalannya.
  4. Tambahkan kredensial Pinlyx API di n8n lalu tempelkan tokennya. Biarkan Base URL di https://api.pinlyx.com kecuali Anda mengarah ke deployment staging, lalu jalankan uji kredensial.

Uji kredensial menjalankan panggilan terautentikasi paling ringan yang ada:

curl https://api.pinlyx.com/v1/me \
  -H "Authorization: Bearer csk_live_YOUR_KEY"

Kunci API termasuk dalam paket Business. Di paket Free dan Pro tidak ada kunci yang bisa dibuat, jadi kredensial tidak punya apa pun untuk disimpan. Hanya itu prasyarat yang perlu dicek sebelum Anda memasang apa pun.

Jatah bawaannya 60 permintaan per menit per kunci. Setiap respons membawa X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset, dan melewati batas akan menghasilkan HTTP 429 dengan Retry-After dalam detik. Karena batasnya per kunci, bukan per ruang kerja, alur kerja yang terjebak dalam loop hanya memperlambat dirinya sendiri, tanpa menghabiskan jatah integrasi Anda yang lain.

Delapan operasi pada tiga resource

Ini seluruh kemampuannya, bukan sekadar sorotan.

Setiap operasi dipetakan ke tepat satu endpoint di API publik v1, jadi tidak ada yang berperilaku berbeda dari permintaan yang Anda tulis sendiri.

  • Contact, Create. Butuh minimal salah satu dari nama, username, telepon, email, atau external ID. Additional Fields memuat email, telepon, username, platform, catatan, dan external ID Anda sendiri.
  • Contact, Get. Satu kontak berdasarkan id numeriknya.
  • Contact, Get Many. Filter untuk pencarian sebagian teks, platform, email, external ID, dan Updated Since.
  • Contact, Update. Pembaruan sebagian: kolom yang tidak Anda tambahkan ke koleksi dibiarkan apa adanya, tidak dikosongkan.
  • Contact, Delete. Mengarsipkan, bukan menghapus permanen. Riwayat pesan dan kesepakatan yang tertaut tetap ada, sama seperti yang dilakukan panel dengan aksi yang sama.
  • Deal, Create. Judul wajib diisi. Nilai, mata uang, tahap, probabilitas, perkiraan tanggal penutupan, catatan, dan id kontak bersifat opsional.
  • Deal, Get Many. Filter untuk tahap, kontak, dan pencarian judul. Di sini tahap menerima won dan lost, karena membaca kesepakatan yang sudah ditutup boleh saja meskipun menulisnya tidak.
  • Conversation, Get Many. Percakapan yang baru aktif di semua kanal yang terhubung, terbaru di atas, masing-masing dengan cuplikan pesan terakhir.

Kolom platform pada kontak menerima Telegram, WhatsApp, Instagram, LinkedIn, X, dan Email. Kolom ini mencatat kanal tempat seseorang datang, yang nantinya dipakai CRM untuk mengelompokkan percakapannya.

Apa pun yang tidak ada di daftar itu juga tidak ada di node. Mengirim pesan, memberi tag, penilaian prospek, tugas, faktur, dan kampanye semuanya tersedia di REST API. Hanya saja tidak termasuk delapan operasi ini.

Alur kerja pertama: kiriman formulir menjadi kontak

Alasan paling umum orang memakai node ini. Prospek mengisi formulir, dan datanya sudah ada di CRM sebelum siapa pun membuka tab.

  1. Picu dari formulir. Form Trigger n8n, node Webhook di balik formulir Anda sendiri, atau node Typeform maupun Google Forms. Apa pun yang menyerahkan objek JSON ke node berikutnya sudah cukup.
  2. Petakan kolomnya ke Contact, Create. Nama dari kolom nama, lalu Additional Fields untuk email, telepon, dan catatan. Setel Platform ke Email jika prospek datang tanpa akun perpesanan.
  3. Isi External ID dengan id kiriman. Kolom inilah yang membuat alur kerja aman dijalankan ulang. Pembuatan kedua dengan external ID yang sama ditolak dengan HTTP 409, dan isi error menyebut kontak yang sudah ada, jadi pemutaran ulang memberi Anda peringatan duplikat, bukan orang duplikat.
  4. Aktifkan Continue On Fail begitu pemutaran ulang sudah jadi hal biasa. Saat aktif, 409 datang sebagai item berisi pesan error dan sisa batch tetap berjalan. Saat mati, eksekusi berhenti. Itu yang Anda mau pada percobaan pertama, tapi bukan yang Anda mau pada jam tiga pagi.

Jika Anda butuh perilaku upsert sungguhan alih-alih 409, REST API punya endpoint batch yang mencocokkan berdasarkan external ID, email, telepon, atau username, dan menerima hingga 200 baris per permintaan. Node ini tidak menyediakannya. Arahkan node HTTP Request ke POST /v1/contacts/batch dan Anda mendapat perilaku yang sama dengan satu panggilan, bukan dua ratus.

Alur kerja kedua: kesepakatan yang dimenangkan menjadi faktur

Baca dulu sebelum membangunnya, karena rancangan yang paling jelas justru salah.

Kesepakatan sama sekali tidak bisa dipindahkan ke won lewat API. Memenangkan kesepakatan akan mencatat entri pemasukan di buku besar CRM, jadi perpindahan itu sengaja disisakan untuk panel, tempat ada manusia yang melihatnya. Node ini mengikuti aturan itu: Deal, Create menolak tahap won dan lost, dan tidak ada operasi update. Anda membaca kesepakatan yang menang, bukan menulisnya.

  1. Cek kesepakatan yang menang secara terjadwal. Schedule Trigger setiap lima belas menit ke Pinlyx, Deal, Get Many, dengan filter Stage diatur ke Won.
  2. Ambil hanya yang belum pernah Anda proses. Kesepakatan dikembalikan dengan id terbaru lebih dulu. Simpan id tertinggi yang sudah Anda proses di static data alur kerja dan buang semua yang sama atau di bawahnya, atau tulis id kesepakatan ke referensi faktur dan biarkan aplikasi akuntansi menolak duplikatnya.
  3. Buat fakturnya. Masukkan judul, nilai, dan mata uang ke node penagihan yang sudah Anda pakai. Kesepakatan membawa id kontak, jadi Contact, Get di depannya memberi Anda alamat email tujuan.

Jika lima belas menit terlalu lambat, jangan perpendek intervalnya. Berlanggananlah: Pinlyx mengirim webhook keluar saat deal.won, ditandatangani dengan HMAC-SHA256 di header X-Webhook-Signature dan membawa nama event di X-Webhook-Event. Arahkan ke node Webhook n8n, dan faktur terkirim beberapa detik setelah seseorang menutup kesepakatan, tanpa menghabiskan jatah polling sama sekali. Hal yang sama berlaku untuk contact.created, contact.updated, dan message.received.

Alur kerja ketiga: membaca percakapan dan meneruskannya

Conversation, Get Many mengembalikan thread yang baru bergerak di semua kanal yang terhubung: Telegram, WhatsApp, Instagram, X, email, dan live chat situs web dalam satu daftar. Setiap baris memuat id kontak, kanal, status belum dibaca, dan hingga 160 karakter dari pesan terakhir.

  1. Tarik daftar terbaru secara terjadwal. Batas 50 sudah mencakup sebagian besar kotak masuk. Saring ke baris yang belum dibaca dengan node IF sebelum Anda menghabiskan apa pun untuknya.
  2. Klasifikasikan cuplikannya. Kirim teks cuplikan ke node model mana pun yang Anda pakai dan minta satu label: pertanyaan harga, masalah dukungan, spam, atau tidak perlu ditindaklanjuti.
  3. Bertindak sesuai label. Kirim pertanyaan harga ke kanal yang dipantau tim penjualan, buka tiket untuk masalah dukungan, dan tulis kembali klasifikasinya dengan Contact, Update agar tercatat di data kontak, tidak hanya di obrolan.

Ada dua batasan yang perlu diketahui sebelum membangun ini. Cuplikan hanyalah cuplikan: node tidak bisa menelusuri seluruh thread pesan, jadi pengklasifikasi hanya melihat pesan terakhir. Dan node tidak bisa memberi tag pada kontak atau mengirim balasan. Keduanya ada di REST API dan server MCP, tetapi tidak termasuk delapan operasi ini.

Paginasi, batas, dan seperti apa error itu

Tiga perilaku yang menentukan apakah alur kerja bertahan di minggu pertamanya yang sesungguhnya.

  • Paginasi berbasis kursor. Respons daftar memuat baris-baris data plus kursor ke halaman berikutnya. Return All menelusuri kursor itu sampai halaman habis; batas menghentikannya lebih awal. Satu halaman dibatasi di server pada 100 baris untuk kontak dan kesepakatan serta 50 untuk percakapan, jadi Return All atas 4.000 kontak berarti 40 permintaan, bukan satu.
  • Batas laju berlaku per kunci. Enam puluh permintaan per menit secara bawaan. Jika melewati batas, Anda mendapat HTTP 429 dengan Retry-After dalam detik, dan tiga header X-RateLimit di setiap respons menunjukkan seberapa dekat Anda dengan batas sebelum itu terjadi.
  • Error selalu menyertakan alasan. 401 berarti kunci salah atau sudah dicabut. 403 berarti kunci valid tetapi tidak punya cakupan yang dinyatakan operasi. 404 berarti id itu bukan milik ruang kerja ini, dan jawabannya sengaja dibuat sama dengan id yang tidak ada. 409 berarti bentrokan external ID, dan error menyebut data yang sudah memegang id tersebut.

Respons daftar dari API yang menjadi dasar node ini:

{
  "items": [ { "Id": 812, "Name": "Sarah Lin", "Platform": "email" } ],
  "nextCursor": 764,
  "hasMore": true
}

Sinkronisasi inkremental berjalan dengan Updated Since. Simpan waktu eksekusi terakhir yang berhasil, kirimkan pada eksekusi berikutnya, dan Anda hanya menarik segelintir kontak yang berubah, bukan semuanya. Itulah bedanya sinkronisasi malam yang selesai dengan yang menghabiskan seluruh jatahnya untuk baris yang tidak disentuh siapa pun.

Batasan jujur

Yang tidak dilakukan node ini

Enam hal yang lebih baik Anda baca di sini daripada baru ketahuan di tengah membangun alur kerja di sekitarnya.

Tidak bisa mengirim pesan

REST API bisa mengantrekan pesan Telegram atau DM X, begitu juga server MCP. Operasi itu tidak ada di node ini. Jika alur kerja harus menjangkau pelanggan, pakai node HTTP Request atau salah satu node kanal bawaan n8n.

Tidak bisa menandai kesepakatan sebagai menang

Memenangkan kesepakatan mencatat entri pemasukan di buku besar, jadi perpindahan itu hanya bisa dilakukan di panel. Node ini membuat dan mendaftar kesepakatan. Node ini tidak menutupnya, dan Create langsung menolak tahap won dan lost.

Tidak ada node pemicu

Ini node aksi. Untuk memulai alur kerja dari kejadian di CRM, daftarkan webhook keluar dan terima dengan node Webhook milik n8n. Polling dengan Schedule Trigger juga bisa, tetapi memakan jatah batas laju yang tidak dipakai webhook.

Tidak memberi tag, skor, atau penugasan

Tag, skor prospek, penugasan pemilik, tugas, dan perpindahan pipeline semuanya ada di REST API. Tidak satu pun termasuk delapan operasi ini. Contact, Update hanya menulis kolom biasa, tidak lebih.

Tidak menyentuh uang

Tidak ada faktur, entri buku besar, pembayaran, atau pengembalian dana. Tidak ada apa pun di node ini yang memindahkan uang ke arah mana pun, batas yang sama dengan yang ditetapkan server MCP.

Membutuhkan paket Business

Kunci API adalah fitur paket Business. Di paket Free dan Pro tidak ada kunci untuk ditempelkan ke kredensial, jadi node tidak punya apa pun untuk autentikasi, sebenar apa pun cara memasangnya.

Node, webhook, atau server MCP

Tiga cara menghubungkan CRM yang sama, masing-masing tepat untuk pekerjaan yang berbeda. Sebagian besar tim akhirnya menjalankan dua di antaranya.

Node n8n

Pekerjaan pasti yang berjalan terjadwal atau dari pemicu

Anda tahu persis apa yang harus terjadi dan kapan. Formulir masuk, kontak dibuat. Kesepakatan ditutup, faktur terkirim. Logikanya ada di kanvas yang bisa dibaca seluruh tim, dan eksekusi yang gagal terlihat di daftar eksekusi beserta payload penyebabnya.

Paling cocok saat aturannya tetap dan volumenya stabil.

Webhook keluar

Bereaksi tepat saat sesuatu terjadi

Daftarkan endpoint di CRM, dan CRM akan mengirim data kepada Anda saat contact.created, contact.updated, message.received, deal.won, dan event lainnya. Ditandatangani dengan HMAC-SHA256, dicoba ulang dengan backoff, dan bisa diputar ulang dari log pengiriman. Pasangkan dengan node Webhook n8n dan Anda mendapat push, bukan polling.

Paling cocok saat kecepatan lebih penting daripada kesederhanaan.

Server MCP

Pertimbangan, bukan sekadar sambungan

Asisten AI mengambil keputusan saat dipanggil dengan thread yang sebenarnya di depannya, bukan mengikuti aturan yang ditulis berminggu-minggu sebelumnya. Tool, resource, dan prompt lewat satu endpoint terautentikasi, dengan setiap panggilan dibatasi cakupan pada kunci.

Paling cocok saat jawabannya bergantung pada membaca situasi.

Pertanyaan umum integrasi n8n

Pertanyaan yang muncul di jam pertama, dijawab sesuai perilaku sebenarnya.

Ini community node n8n yang dirilis ke npm sebagai n8n-nodes-pinlyx. Setelah dipasang di instance n8n, node ini menambahkan blok Pinlyx ke kanvas alur kerja dengan delapan operasi: membuat, mengambil, mendaftar, memperbarui, dan mengarsipkan kontak; membuat dan mendaftar kesepakatan; serta mendaftar percakapan terbaru. Node ini melakukan autentikasi dengan kunci API Pinlyx bercakupan dan tidak punya dependensi runtime.
Di n8n self-hosted, buka Settings, lalu Community Nodes, tekan Install, dan masukkan n8n-nodes-pinlyx. Anda memerlukan akun pemilik instance. Anda juga bisa menjalankan npm install n8n-nodes-pinlyx di direktori data n8n lalu memulai ulang prosesnya, cara yang dipakai jika penginstal community node dimatikan di instance Anda.
n8n Cloud hanya menyediakan community node yang sudah ditinjau dan diverifikasi oleh n8n, dan paket ini belum melewati tinjauan tersebut. Di Cloud, operasi yang sama tersedia lewat node HTTP Request yang diarahkan ke REST API Pinlyx dengan kunci bearer yang sama. Konfigurasinya lebih banyak, tetapi perilakunya persis sama.
Business. Kunci API adalah fitur paket Business, jadi ruang kerja Free dan Pro tidak bisa membuat kunci yang dibutuhkan kredensial. Selebihnya gratis: paketnya berlisensi MIT dan tidak ada biaya untuk memasang atau menjalankannya.
Tidak dengan sendirinya. Ini node aksi, bukan node pemicu. Untuk memulai alur kerja dari event CRM, daftarkan webhook keluar di panel dan terima dengan node Webhook milik n8n. Webhook dikirim antara lain saat contact.created, contact.updated, message.received, dan deal.won, ditandatangani dengan HMAC-SHA256 di header X-Webhook-Signature, dan dicoba ulang dengan backoff.
Isi External ID pada Contact, Create dengan pengenal stabil milik Anda untuk orang tersebut, misalnya id kiriman formulir atau id pelanggan di toko Anda. Pembuatan kedua dengan external ID yang sama ditolak dengan HTTP 409, dan isi error menyebut id kontak yang sudah ada. Aktifkan Continue On Fail agar pemutaran ulang melaporkan bentrokan itu alih-alih menghentikan eksekusi.
Tidak. Tidak ada operasi kirim jenis apa pun. Pengiriman tersedia di REST API dan server MCP di balik cakupan seperti telegram:send dan social:write, tetapi sengaja diletakkan di luar node ini. Alur kerja yang harus menjangkau seseorang membutuhkan node HTTP Request atau salah satu node kanal bawaan n8n.
Permintaan gagal dengan HTTP 403, bukan tampak berhasil. Setiap operasi menyatakan satu cakupan yang dibutuhkannya: contacts:read untuk pembacaan, contacts:write untuk create, update, dan delete, serta deals:read dan deals:write untuk operasi kesepakatan. Cakupan ditegakkan di server, jadi mempersempit kunci adalah pembatasan sungguhan, bukan sekadar petunjuk.
Gunakan filter Updated Since pada Contact, Get Many. Simpan waktu eksekusi terakhir Anda yang berhasil, kirimkan pada eksekusi berikutnya, dan API hanya mengembalikan kontak yang diubah pada atau setelah waktu itu. Dipadukan dengan Return All, inilah dasar sinkronisasi inkremental, dan cara ini menjaga tugas malam tetap di bawah batas laju per menit.
Ya, berlisensi MIT di GitHub pada Pinlyx/n8n-nodes-pinlyx. Node ini hanya satu file TypeScript ditambah definisi kredensial, jadi membacanya dari awal sampai akhir hanya butuh beberapa menit dan menunjukkan dengan tepat endpoint mana yang dipanggil setiap operasi.

Siap diluncurkan

Masukkan CRM Anda ke dalam alur kerja

Pasang node, buat kunci dengan dua cakupan, dan biarkan kiriman formulir pertama masuk sebagai kontak. Setelah itu, tinggal menyeret satu node lagi ke kanvas.

Paket gratis selamanya · Dirancang dengan memperhatikan GDPR · Tanpa kartu kredit