Нода для n8n

Тариф Business

CRM-нода для n8n для контактов, сделок и диалогов

Установите n8n-nodes-pinlyx из панели Community Nodes, вставьте API-ключ, и дальше всё идёт само: заявка с формы становится контактом, выигранная сделка превращается в счёт, а диалог без ответа оказывается сообщением в том канале, за которым следит ваша команда. Восемь операций над тремя ресурсами, никаких зависимостей во время выполнения, лицензия MIT.

Тариф Free: бесплатно навсегда · Без банковской карты · Отмена в любой момент

Последнее обновление:

3
Ресурса
Контакт, сделка, диалог
8
Операций
Пять для контактов, две для сделок, одна для диалогов
0
Зависимостей
Все запросы идут через встроенный HTTP-хелпер n8n
MIT
Лицензия
Исходники на GitHub, пакет на npm

Определение

Нода сообщества n8n — это пакет на npm, который экземпляр n8n устанавливает на лету, добавляя на холст новый блок. Это не форк n8n и не приёмник вебхуков, который вам пришлось бы самим размещать и поддерживать в рабочем состоянии.

n8n-nodes-pinlyx — нода от Pinlyx. Она авторизуется по API-ключу, который вы создаёте в панели, и даёт сценарию восемь операций над контактами, сделками и диалогами, а курсорную пагинацию берёт на себя.

Пакет опубликован на npm как n8n-nodes-pinlyx, исходный код лежит на GitHub под лицензией MIT. Проверено на n8n 1.60 и новее с Node.js 20.15 и выше. npm · GitHub

Нода обращается к тому же открытому REST API, что и обычный скрипт, поэтому всё, что она делает, можно повторить через curl, а всё, чего она не умеет, решается одной нодой HTTP Request.

Что нода добавляет в сценарий

Три ресурса, и выбраны они потому, что именно к ним автоматизация обращается на практике. Все правила ниже проверяет API, а не нода.

Контакты: пять операций

Создание, получение, список, обновление и архивирование. Список фильтруется по поиску, платформе, email, внешнему ID и полю Updated Since, на котором и строится инкрементальная синхронизация.

Сделки: две операции

Создание сделки с названием, суммой, валютой, этапом, вероятностью, ожидаемой датой закрытия и заметками. Список с фильтрами по этапу, контакту и поиском по названию.

Диалоги: только чтение

Недавно обновлённые диалоги во всех подключённых каналах, сначала новые. В каждой строке ID контакта, канал, отметка о непрочитанном и короткое превью последнего сообщения.

Внешний ID защищает от дублей

Запишите в контакт собственный идентификатор, и повторный запуск получит отказ HTTP 409 с указанием уже существующей записи, вместо того чтобы молча создать вторую копию того же человека.

Курсорная пагинация из коробки

Включите Return All, и нода сама пройдёт по всем страницам. Если не включать, задайте лимит. На странице не больше 100 строк для контактов и сделок и 50 для диалогов, так что большой список всегда означает много запросов, как его ни запрашивай.

Права ключа проверяет сервер

В учётных данных хранится один API-ключ. Каждая операция объявляет нужное ей право, поэтому ключ без contacts:write получит на создании ответ 403, а не сделает вид, что всё сработало, ничего не изменив.

Установка ноды

Нода опубликована на npm как n8n-nodes-pinlyx и ставится так же, как любая нода сообщества: прямо из n8n, без копирования файлов на сервер.

  1. Откройте Settings, затем Community Nodes. Для этого нужна учётная запись владельца экземпляра. Обычный участник устанавливать пакеты не может.
  2. Нажмите Install и введите n8n-nodes-pinlyx. Подтвердите предупреждение о нодах сообщества и установите пакет. n8n скачает его, и через несколько секунд нода появится в поиске на холсте.
  3. Добавьте ноду Pinlyx в сценарий. Прежде чем дать выбрать ресурс, она попросит учётные данные, так что следующим шагом создаём их.

Или, если n8n развёрнут на своём сервере, из командной строки:

npm install n8n-nodes-pinlyx
# then restart n8n

Одну оговорку стоит знать заранее, до того как вы на неё рассчитываете: в n8n Cloud доступны только ноды сообщества, которые команда n8n сама проверила и верифицировала, а этот пакет такую проверку ещё не проходил. На собственном сервере можно установить любой опубликованный пакет. В Cloud те же операции доступны через ноду HTTP Request и REST API. Это честный ответ, а не деталь, о которой нам хотелось бы промолчать.

У пакета нет зависимостей во время выполнения. Каждый запрос проходит через встроенный HTTP-хелпер n8n: благодаря ему учётные данные подставляют заголовок Authorization, а сам пакет остаётся лёгким.

Создание учётных данных

Нода авторизуется по API-ключу Pinlyx: один ключ, один заголовок, никакого OAuth.

  1. Откройте в панели Pinlyx «Настройки», затем «Разработчикам». Создайте ключ и назовите его по сценарию, который будет им пользоваться: в день отзыва ключа вы будете точно знать, что перестанет работать.
  2. Выдайте только те права, которые нужны сценарию. Сценарию, который пишет контакты, нужны contacts:read и contacts:write. Отчёту по сделкам хватит deals:read. Диалоги читаются с правом contacts:read.
  3. Скопируйте токен сразу. Боевые ключи начинаются с csk_live_, тестовые с csk_test_. Полный токен показывается один раз при создании, дальше панель отображает только его префикс.
  4. Добавьте в n8n учётные данные Pinlyx API и вставьте ключ. Оставьте Base URL равным https://api.pinlyx.com, если только вы не подключаетесь к тестовому стенду, и запустите проверку учётных данных.

Проверка учётных данных делает самый дешёвый авторизованный запрос из возможных:

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

API-ключи входят в тариф Business. На Free и Pro создать ключ нельзя, и учётным данным просто нечего хранить. Это единственное условие, которое стоит проверить до любой установки.

По умолчанию лимит составляет 60 запросов в минуту на ключ. Каждый ответ содержит заголовки X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, а при превышении приходит HTTP 429 с Retry-After в секундах. Лимит считается на ключ, а не на рабочее пространство, поэтому зациклившийся сценарий тормозит только сам себя и не оставляет без запросов остальные интеграции.

Восемь операций над тремя ресурсами

Это весь набор, а не избранное.

Каждая операция соответствует ровно одному эндпоинту открытого API v1, поэтому ничто здесь не ведёт себя иначе, чем запрос, написанный вручную.

  • Contact, Create. Нужно хотя бы одно из полей: имя, username, телефон, email или внешний ID. В Additional Fields передаются email, телефон, username, платформа, заметки и ваш внешний ID.
  • Contact, Get. Один контакт по числовому ID.
  • Contact, Get Many. Фильтры: поиск по подстроке, платформа, email, внешний ID и Updated Since.
  • Contact, Update. Частичное обновление: поле, которое вы не добавили в коллекцию, остаётся как есть, а не стирается.
  • Contact, Delete. Архивирует, а не стирает. История сообщений и связанные сделки сохраняются, ровно как при том же действии в панели.
  • Deal, Create. Название обязательно. Сумма, валюта, этап, вероятность, ожидаемая дата закрытия, заметки и ID контакта необязательны.
  • Deal, Get Many. Фильтры по этапу, контакту и поиск по названию. Здесь этап принимает значения won и lost: читать закрытую сделку можно, хотя записывать её нельзя.
  • Conversation, Get Many. Недавно активные диалоги во всех подключённых каналах, сначала новые, у каждого превью последнего сообщения.

Поле платформы у контакта принимает Telegram, WhatsApp, Instagram, LinkedIn, X и Email. Оно фиксирует канал, по которому человек пришёл, и по нему CRM потом группирует его диалоги.

Всего, чего нет в этом списке, нет и в ноде. Отправка сообщений, теги, скоринг лидов, задачи, счета и цепочки есть в REST API. Просто они не входят в эти восемь операций.

Сценарий первый: заявка с формы становится контактом

Самая частая причина взять эту ноду. Лид заполняет форму, и запись появляется в CRM раньше, чем кто-то успевает открыть вкладку.

  1. Запуск по форме. Подойдёт n8n Form Trigger, нода Webhook за вашей собственной формой или нода Typeform либо Google Forms. Годится всё, что передаёт следующей ноде JSON-объект.
  2. Сопоставьте поля с Contact, Create. Имя берите из поля имени, а email, телефон и заметки передайте через Additional Fields. Если у лида нет аккаунта в мессенджере, укажите в Platform значение Email.
  3. Запишите в External ID идентификатор заявки. Именно это поле делает повторный запуск безопасным. Второе создание с тем же внешним ID получает отказ HTTP 409, а в теле ошибки указан уже существующий контакт, так что повтор даёт вам предупреждение о дубле, а не дубль человека.
  4. Включите Continue On Fail, когда повторы станут обычным делом. С этой настройкой ответ 409 приходит как элемент с текстом ошибки, а остальная пачка обрабатывается дальше. Без неё выполнение останавливается: на первом запуске это то, что нужно, а в три часа ночи совсем нет.

Если нужен настоящий upsert, а не 409, в REST API есть пакетный эндпоинт: он сопоставляет записи по внешнему ID, email, телефону или username и принимает до 200 строк за запрос. В ноде его нет. Направьте ноду HTTP Request на POST /v1/contacts/batch, и вы получите то же поведение одним запросом вместо двухсот.

Сценарий второй: выигранная сделка превращается в счёт

Прочитайте это до того, как начнёте собирать сценарий: очевидное решение здесь неверное.

Перевести сделку в статус «выиграна» через API нельзя вообще. Выигрыш сделки создаёт запись о доходе в учёте CRM, поэтому этот переход намеренно оставлен панели, где на него смотрит человек. Нода это отражает: Deal, Create отклоняет этапы won и lost, а операции обновления нет. Выигранные сделки вы читаете, но не записываете.

  1. Опрашивайте выигранные сделки по расписанию. Schedule Trigger раз в пятнадцать минут, за ним Pinlyx, Deal, Get Many с фильтром Stage, равным Won.
  2. Оставляйте только те, что ещё не обработаны. Сделки приходят по убыванию ID. Храните наибольший обработанный ID в static data сценария и отбрасывайте всё, что не больше него, либо пишите ID сделки в номер счёта, и пусть бухгалтерская система сама отклонит повтор.
  3. Создайте счёт. Передайте название, сумму и валюту в ту ноду биллинга, которой вы уже пользуетесь. В сделке есть ID контакта, так что Contact, Get перед этим шагом даст email, на который отправлять счёт.

Если пятнадцать минут — это слишком долго, не сокращайте интервал опроса, а подпишитесь на событие. Pinlyx отправляет исходящий вебхук deal.won с подписью HMAC-SHA256 в заголовке X-Webhook-Signature и названием события в X-Webhook-Event. Направьте его на ноду Webhook в n8n, и счёт уйдёт через несколько секунд после закрытия сделки, без единого запроса из лимита на опрос. То же касается contact.created, contact.updated и message.received.

Сценарий третий: читаем диалоги и распределяем их

Conversation, Get Many возвращает недавно обновлённые диалоги во всех подключённых каналах: Telegram, WhatsApp, Instagram, X, почта и живой чат на сайте в одном списке. В каждой строке ID контакта, канал, признак непрочитанного и до 160 символов последнего сообщения.

  1. Забирайте свежий список по расписанию. Лимита 50 хватает для большинства ящиков. Прежде чем тратить на строки ресурсы, оставьте нодой IF только непрочитанные.
  2. Классифицируйте превью. Пропустите текст превью через ноду той модели, которой вы пользуетесь, и попросите одну метку: вопрос о цене, обращение в поддержку, спам или ничего делать не нужно.
  3. Действуйте по метке. Вопросы о цене отправляйте в канал, который читает отдел продаж, по обращениям в поддержку открывайте тикет, а метку записывайте обратно через Contact, Update, чтобы она осталась в карточке контакта, а не только в чате.

Два ограничения стоит знать заранее. Превью есть превью: нода не умеет листать всю переписку, поэтому классификатор видит только последнее сообщение. И нода не может поставить контакту тег или отправить ответ. Обе возможности есть в REST API и на MCP-сервере, но ни одна не входит в эти восемь операций.

Пагинация, лимиты и как выглядит ошибка

Три особенности, от которых зависит, переживёт ли сценарий свою первую настоящую неделю.

  • Пагинация курсорная. Ответ со списком содержит строки и курсор на следующую страницу. Return All идёт по курсору, пока страницы не закончатся, лимит останавливает раньше. Сервер ограничивает страницу 100 строками для контактов и сделок и 50 для диалогов, так что Return All по 4000 контактов означает 40 запросов, а не один.
  • Лимит запросов считается на ключ. По умолчанию шестьдесят запросов в минуту. При превышении приходит HTTP 429 с Retry-After в секундах, а три заголовка X-RateLimit в каждом ответе заранее показывают, насколько близко вы к границе.
  • У ошибок есть причина. 401 значит, что ключ неверный или отозван. 403 значит, что ключ действителен, но у него нет права, которое объявляет операция. 404 значит, что ID не принадлежит этому рабочему пространству; это намеренно тот же ответ, что и для несуществующего ID. 409 означает конфликт внешнего ID, и в ответе указана запись, у которой этот ID уже есть.

Ответ со списком от API, на котором работает нода:

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

Инкрементальная синхронизация строится на Updated Since. Сохраните время последнего успешного запуска, передайте его в следующий, и вы получите несколько изменившихся контактов, а не все сразу. В этом и разница между ночной синхронизацией, которая успевает закончиться, и той, что тратит весь лимит на строки, к которым никто не прикасался.

Честные ограничения

Чего эта нода не умеет

Шесть вещей, о которых лучше прочитать здесь, чем обнаружить на полпути, собирая вокруг них сценарий.

Она не отправляет сообщения

REST API может поставить в очередь сообщение в Telegram или личное сообщение в X, MCP-сервер тоже. В этой ноде таких операций нет. Если сценарий должен связаться с клиентом, используйте ноду HTTP Request или одну из собственных нод каналов в n8n.

Она не отмечает сделку выигранной

Выигрыш сделки создаёт запись о доходе в учёте, поэтому этот переход доступен только в панели. Нода создаёт сделки и выводит их список. Закрывать их она не умеет, а Create прямо отклоняет этапы won и lost.

Ноды-триггера нет

Это нода действий. Чтобы запускать сценарий по событию в CRM, зарегистрируйте исходящий вебхук и принимайте его нодой Webhook в n8n. Опрос через Schedule Trigger тоже работает, но расходует лимит запросов, которого вебхук не тратит.

Она не ставит теги, скоринг и ответственных

Теги, скоринг лидов, назначение ответственного, задачи и перемещение по воронке есть в REST API. Ничего из этого нет среди восьми операций. Contact, Update записывает обычные поля, и только их.

Она не работает с деньгами

Никаких счетов, записей в учёте, платежей и возвратов. Ничто в этой ноде не двигает деньги ни в одну сторону, и MCP-сервер проводит ту же границу.

Нужен тариф Business

API-ключи доступны на тарифе Business. На Free и Pro вставить в учётные данные нечего, поэтому ноде не с чем авторизоваться, как бы правильно она ни была установлена.

Нода, вебхук или MCP-сервер

Три способа подключить одну и ту же CRM, и каждый хорош для своей задачи. Большинство команд в итоге используют два из них.

Нода для n8n

Предсказуемая работа по расписанию или по триггеру

Вы точно знаете, что и когда должно произойти. Пришла форма, создан контакт. Закрылась сделка, ушёл счёт. Логика лежит на холсте, который может прочитать вся команда, а неудачный запуск виден в списке выполнений вместе с данными, которые его вызвали.

Лучший выбор, когда правило неизменно, а объём стабилен.

Исходящие вебхуки

Реакция в момент события

Зарегистрируйте эндпоинт в CRM, и она будет присылать вам события contact.created, contact.updated, message.received, deal.won и другие. С подписью HMAC-SHA256, повторами с нарастающей задержкой и возможностью переотправки из журнала доставки. Свяжите это с нодой Webhook в n8n, и вместо опроса получите push-уведомления.

Лучший выбор, когда скорость реакции важнее простоты.

MCP-сервер

Решения, а не трубопровод

ИИ-ассистент принимает решение в момент вызова, видя перед собой сам диалог, а не следуя правилу, написанному несколько недель назад. Инструменты, ресурсы и промпты через один авторизованный эндпоинт, и каждый вызов ограничен правами ключа.

Лучший выбор, когда ответ зависит от понимания ситуации.

Частые вопросы об интеграции с n8n

Вопросы, которые возникают в первый же час, и ответы о том, как всё работает на самом деле.

Это нода сообщества n8n, опубликованная на npm как n8n-nodes-pinlyx. После установки в экземпляр n8n на холсте сценариев появляется блок Pinlyx с восемью операциями: создать, получить, вывести список, обновить и архивировать контакт; создать сделку и вывести список сделок; вывести недавние диалоги. Нода авторизуется по API-ключу Pinlyx с ограниченными правами и не имеет зависимостей во время выполнения.
В n8n на собственном сервере откройте Settings, затем Community Nodes, нажмите Install и введите n8n-nodes-pinlyx. Понадобится учётная запись владельца экземпляра. Можно также выполнить npm install n8n-nodes-pinlyx в каталоге данных n8n и перезапустить процесс: это вариант на случай, если установщик нод сообщества на вашем экземпляре отключён.
В n8n Cloud доступны только ноды сообщества, которые команда n8n проверила и верифицировала, а этот пакет такую проверку пока не проходил. В Cloud те же операции доступны через ноду HTTP Request, направленную на REST API Pinlyx с тем же ключом Bearer. Настройки больше, но поведение точно такое же.
Business. API-ключи доступны на тарифе Business, поэтому в рабочих пространствах на Free и Pro нельзя создать ключ для учётных данных. Всё остальное в ноде бесплатно: пакет распространяется под лицензией MIT, а за установку и использование ничего не берётся.
Сама по себе нет. Это нода действий, а не триггер. Чтобы запускать сценарий по событию в CRM, зарегистрируйте в панели исходящий вебхук и принимайте его нодой Webhook в n8n. Вебхуки срабатывают, среди прочего, на contact.created, contact.updated, message.received и deal.won, подписываются HMAC-SHA256 в заголовке X-Webhook-Signature и повторяются с нарастающей задержкой.
Укажите в External ID для Contact, Create свой постоянный идентификатор этого человека, например ID заявки с формы или ID клиента в вашем магазине. Второе создание с тем же внешним ID получит отказ HTTP 409, а в теле ошибки будет ID существующего контакта. Включите Continue On Fail, чтобы повтор сообщал о конфликте, а не останавливал выполнение.
Нет. Никаких операций отправки в ней нет. Отправка есть в REST API и на MCP-сервере за правами вроде telegram:send и social:write, но в эту ноду она намеренно не входит. Сценарию, который должен связаться с человеком, нужна нода HTTP Request или одна из собственных нод каналов в n8n.
Запрос завершится ошибкой HTTP 403, а не сделает вид, что всё прошло успешно. Каждая операция объявляет одно нужное ей право: contacts:read для чтения, contacts:write для создания, обновления и удаления, deals:read и deals:write для операций со сделками. Права проверяются на сервере, поэтому сужение ключа — это настоящее ограничение, а не подсказка.
Используйте фильтр Updated Since в Contact, Get Many. Сохраните время последнего успешного запуска, передайте его в следующий, и API вернёт только контакты, изменённые в этот момент или позже. Вместе с Return All на этом строится инкрементальная синхронизация, и ночная задача укладывается в поминутный лимит запросов.
Да, он лежит на GitHub в репозитории Pinlyx/n8n-nodes-pinlyx под лицензией MIT. Нода состоит из одного файла на TypeScript и описания учётных данных, так что прочитать её целиком можно за несколько минут и точно узнать, какой эндпоинт вызывает каждая операция.

Что почитать дальше

Другие способы добраться до тех же данных и разделы CRM, в которые будет писать сценарий.

Открытый REST API

То, на чём работает нода: ключи с ограниченными правами, курсорная пагинация, идемпотентная запись, заголовки лимитов и исходящие вебхуки.

MCP-сервер

Та же CRM, но для ИИ-ассистента, а не сценария: инструменты, ресурсы и промпты через один авторизованный эндпоинт.

Руководство по интеграции API и MCP

Пошагово для разработчиков: создание ключей, первый авторизованный запрос, проверка подписи вебхуков и повторы при превышении лимита.

MCP, REST API или сервисы автоматизации

Когда решение должен принимать ассистент в момент вызова, когда стоит писать код, а когда лучше всего подойдёт no-code триггер.

Интеграции

Gmail, Outlook, Calendly, Zoom, GitHub и исходящие вебхуки, которые связывают CRM с чем угодно ещё.

CRM для контактов

Что на самом деле хранится в карточке контакта: теги, пользовательские поля, скоринг лида, ответственный и полная история активности.

Сделки и задачи

Воронка, в которую пишут операции со сделками, и почему переход в «выиграна» записывает выручку и остаётся в панели.

Цены

Сравнение тарифов, включая Business с API-ключами и вебхуками, и MCP-сервер, доступный на любом тарифе.

Готово к запуску

Подключите CRM к своим сценариям

Установите ноду, создайте ключ с двумя правами, и пусть первая заявка с формы станет контактом. Всё остальное сводится к тому, чтобы перетащить на холст ещё одну ноду.

Тариф Free: бесплатно навсегда · С учётом требований GDPR · Без банковской карты