Контакты: пять операций
Создание, получение, список, обновление и архивирование. Список фильтруется по поиску, платформе, email, внешнему ID и полю Updated Since, на котором и строится инкрементальная синхронизация.
Нода для n8n
Тариф BusinessУстановите n8n-nodes-pinlyx из панели Community Nodes, вставьте API-ключ, и дальше всё идёт само: заявка с формы становится контактом, выигранная сделка превращается в счёт, а диалог без ответа оказывается сообщением в том канале, за которым следит ваша команда. Восемь операций над тремя ресурсами, никаких зависимостей во время выполнения, лицензия MIT.
Тариф Free: бесплатно навсегда · Без банковской карты · Отмена в любой момент
Последнее обновление:
Определение
Нода сообщества 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 контакта, канал, отметка о непрочитанном и короткое превью последнего сообщения.
Запишите в контакт собственный идентификатор, и повторный запуск получит отказ HTTP 409 с указанием уже существующей записи, вместо того чтобы молча создать вторую копию того же человека.
Включите Return All, и нода сама пройдёт по всем страницам. Если не включать, задайте лимит. На странице не больше 100 строк для контактов и сделок и 50 для диалогов, так что большой список всегда означает много запросов, как его ни запрашивай.
В учётных данных хранится один API-ключ. Каждая операция объявляет нужное ей право, поэтому ключ без contacts:write получит на создании ответ 403, а не сделает вид, что всё сработало, ничего не изменив.
Нода опубликована на npm как n8n-nodes-pinlyx и ставится так же, как любая нода сообщества: прямо из n8n, без копирования файлов на сервер.
Или, если n8n развёрнут на своём сервере, из командной строки:
npm install n8n-nodes-pinlyx
# then restart n8nОдну оговорку стоит знать заранее, до того как вы на неё рассчитываете: в n8n Cloud доступны только ноды сообщества, которые команда n8n сама проверила и верифицировала, а этот пакет такую проверку ещё не проходил. На собственном сервере можно установить любой опубликованный пакет. В Cloud те же операции доступны через ноду HTTP Request и REST API. Это честный ответ, а не деталь, о которой нам хотелось бы промолчать.
У пакета нет зависимостей во время выполнения. Каждый запрос проходит через встроенный HTTP-хелпер n8n: благодаря ему учётные данные подставляют заголовок Authorization, а сам пакет остаётся лёгким.
Нода авторизуется по API-ключу Pinlyx: один ключ, один заголовок, никакого OAuth.
Проверка учётных данных делает самый дешёвый авторизованный запрос из возможных:
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, поэтому ничто здесь не ведёт себя иначе, чем запрос, написанный вручную.
Поле платформы у контакта принимает Telegram, WhatsApp, Instagram, LinkedIn, X и Email. Оно фиксирует канал, по которому человек пришёл, и по нему CRM потом группирует его диалоги.
Всего, чего нет в этом списке, нет и в ноде. Отправка сообщений, теги, скоринг лидов, задачи, счета и цепочки есть в REST API. Просто они не входят в эти восемь операций.
Самая частая причина взять эту ноду. Лид заполняет форму, и запись появляется в CRM раньше, чем кто-то успевает открыть вкладку.
Если нужен настоящий upsert, а не 409, в REST API есть пакетный эндпоинт: он сопоставляет записи по внешнему ID, email, телефону или username и принимает до 200 строк за запрос. В ноде его нет. Направьте ноду HTTP Request на POST /v1/contacts/batch, и вы получите то же поведение одним запросом вместо двухсот.
Прочитайте это до того, как начнёте собирать сценарий: очевидное решение здесь неверное.
Перевести сделку в статус «выиграна» через API нельзя вообще. Выигрыш сделки создаёт запись о доходе в учёте CRM, поэтому этот переход намеренно оставлен панели, где на него смотрит человек. Нода это отражает: Deal, Create отклоняет этапы won и lost, а операции обновления нет. Выигранные сделки вы читаете, но не записываете.
Если пятнадцать минут — это слишком долго, не сокращайте интервал опроса, а подпишитесь на событие. 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 символов последнего сообщения.
Два ограничения стоит знать заранее. Превью есть превью: нода не умеет листать всю переписку, поэтому классификатор видит только последнее сообщение. И нода не может поставить контакту тег или отправить ответ. Обе возможности есть в REST API и на MCP-сервере, но ни одна не входит в эти восемь операций.
Три особенности, от которых зависит, переживёт ли сценарий свою первую настоящую неделю.
Ответ со списком от 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-сервер проводит ту же границу.
API-ключи доступны на тарифе Business. На Free и Pro вставить в учётные данные нечего, поэтому ноде не с чем авторизоваться, как бы правильно она ни была установлена.
Три способа подключить одну и ту же CRM, и каждый хорош для своей задачи. Большинство команд в итоге используют два из них.
Предсказуемая работа по расписанию или по триггеру
Вы точно знаете, что и когда должно произойти. Пришла форма, создан контакт. Закрылась сделка, ушёл счёт. Логика лежит на холсте, который может прочитать вся команда, а неудачный запуск виден в списке выполнений вместе с данными, которые его вызвали.
Лучший выбор, когда правило неизменно, а объём стабилен.
Реакция в момент события
Зарегистрируйте эндпоинт в CRM, и она будет присылать вам события contact.created, contact.updated, message.received, deal.won и другие. С подписью HMAC-SHA256, повторами с нарастающей задержкой и возможностью переотправки из журнала доставки. Свяжите это с нодой Webhook в n8n, и вместо опроса получите push-уведомления.
Лучший выбор, когда скорость реакции важнее простоты.
Решения, а не трубопровод
ИИ-ассистент принимает решение в момент вызова, видя перед собой сам диалог, а не следуя правилу, написанному несколько недель назад. Инструменты, ресурсы и промпты через один авторизованный эндпоинт, и каждый вызов ограничен правами ключа.
Лучший выбор, когда ответ зависит от понимания ситуации.
Вопросы, которые возникают в первый же час, и ответы о том, как всё работает на самом деле.
Другие способы добраться до тех же данных и разделы CRM, в которые будет писать сценарий.
То, на чём работает нода: ключи с ограниченными правами, курсорная пагинация, идемпотентная запись, заголовки лимитов и исходящие вебхуки.
Та же CRM, но для ИИ-ассистента, а не сценария: инструменты, ресурсы и промпты через один авторизованный эндпоинт.
Пошагово для разработчиков: создание ключей, первый авторизованный запрос, проверка подписи вебхуков и повторы при превышении лимита.
Когда решение должен принимать ассистент в момент вызова, когда стоит писать код, а когда лучше всего подойдёт no-code триггер.
Gmail, Outlook, Calendly, Zoom, GitHub и исходящие вебхуки, которые связывают CRM с чем угодно ещё.
Что на самом деле хранится в карточке контакта: теги, пользовательские поля, скоринг лида, ответственный и полная история активности.
Воронка, в которую пишут операции со сделками, и почему переход в «выиграна» записывает выручку и остаётся в панели.
Сравнение тарифов, включая Business с API-ключами и вебхуками, и MCP-сервер, доступный на любом тарифе.
Готово к запуску
Установите ноду, создайте ключ с двумя правами, и пусть первая заявка с формы станет контактом. Всё остальное сводится к тому, чтобы перетащить на холст ещё одну ноду.