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.
Node n8n
Paket BusinessPasang 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:
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.
Tiga resource, dipilih karena memang itulah yang benar-benar dibutuhkan sebuah otomasi. Semua aturan di sini ditegakkan oleh API, bukan oleh node.
Buat, ambil, daftar, perbarui, dan arsipkan. Daftar bisa difilter berdasarkan pencarian, platform, email, external ID, dan Updated Since, yaitu filter yang dipakai sinkronisasi inkremental.
Buat kesepakatan dengan judul, nilai, mata uang, tahap, probabilitas, perkiraan tanggal penutupan, dan catatan. Daftar dengan filter tahap, kontak, dan pencarian judul.
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.
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.
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.
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.
Node ini dirilis ke npm sebagai n8n-nodes-pinlyx dan dipasang seperti community node lainnya: dari dalam n8n, bukan dengan menyalin file ke server.
Atau, di instance self-hosted, lewat baris perintah:
npm install n8n-nodes-pinlyx
# then restart n8nSatu 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.
Node ini melakukan autentikasi dengan kunci API Pinlyx: satu kunci, satu header, tanpa bolak-balik OAuth.
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.
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.
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.
Alasan paling umum orang memakai node ini. Prospek mengisi formulir, dan datanya sudah ada di CRM sebelum siapa pun membuka tab.
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.
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.
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.
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.
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.
Tiga perilaku yang menentukan apakah alur kerja bertahan di minggu pertamanya yang sesungguhnya.
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
Enam hal yang lebih baik Anda baca di sini daripada baru ketahuan di tengah membangun alur kerja di sekitarnya.
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.
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.
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.
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 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.
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.
Tiga cara menghubungkan CRM yang sama, masing-masing tepat untuk pekerjaan yang berbeda. Sebagian besar tim akhirnya menjalankan dua di antaranya.
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.
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.
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 yang muncul di jam pertama, dijawab sesuai perilaku sebenarnya.
Cara lain mengakses data yang sama, dan bagian CRM yang akan ditulisi oleh alur kerja Anda.
Lapisan di bawah node: kunci bercakupan, paginasi kursor, penulisan idempoten, header batas laju, dan webhook keluar.
CRM yang sama untuk asisten AI, bukan untuk alur kerja: tool, resource, dan prompt lewat satu endpoint terautentikasi.
Panduan untuk developer: membuat kunci, permintaan terautentikasi pertama, verifikasi tanda tangan webhook, dan backoff batas laju.
Kapan asisten sebaiknya memutuskan saat dipanggil, kapan menulis kode, dan kapan pemicu tanpa kode adalah jawaban yang tepat.
Gmail, Outlook, Calendly, Zoom, GitHub, dan webhook keluar yang menyambungkan CRM ke apa pun.
Apa saja isi data kontak sebenarnya: tag, kolom kustom, skor prospek, pemilik, dan linimasa aktivitas lengkap.
Pipeline yang ditulisi operasi Deal, termasuk alasan perpindahan ke won mencatat pendapatan dan tetap di panel.
Perbandingan paket, termasuk paket Business yang menyertakan kunci API dan webhook, serta server MCP yang tersedia di semua paket.
Siap diluncurkan
Pasang node, buat kunci dengan dua cakupan, dan biarkan kiriman formulir pertama masuk sebagai kontak. Setelah itu, tinggal menyeret satu node lagi ke kanvas.