n8n — это платформа для автоматизации рабочих процессов с открытым исходным кодом. Ее можно либо разместить на собственном сервере, либо использовать веб-версию. Платформа позволяет создавать различные интеграции с сервисами без знаний программирования и написания кода, используя вместо этого визуальный редактор с узлами (nodes).
В настоящее время в n8n встроено более 400 готовых узлов для популярных зарубежных и российских сервисов. Существуют узлы двух типов:
Узел триггера — это то, что запускает ваш рабочий процесс. То есть некое событие, например, сообщение от бота, нажатие кнопки, обновление статуса проекта и др.
Узел действия — это то, что будет происходит после триггера. То есть сама логика вашего рабочего процесса, например, отправка сообщения в чат, создание задачи в другом приложении, добавление записи в БД и так далее.
n8n автоматически запускает каждое действие по триггеру, соблюдая указанный вами порядок.
Шаг 1. Установка n8n
Расширение Пачки доступно пока только в Beta. Это значит, что его нет в веб-версии n8n и для пользования нужно предварительно развернуть на собственном сервере коробочную версию n8n. Это можно сделать двумя способами:
Подробные инструкции есть в официальной документации n8n и на GitHub. Для корректной работы и безопасной передачи данных советуем проконсультироваться с вашими IT-специалистами.
Далее нужно настроить аккаунт владельца (Owner Account), указав почту, имя и пароль. Готово!
Шаг 2. Настройка расширения Пачки для n8n
Следующий шаг — установка расширения Пачки. Оно есть как на GitHub, так и на npmjs, поэтому вы сами можете легко ознакомиться с исходным кодом.
Есть 3 способа установки:
Первый: Зайти в Settings → Community nodes и нативно добавить n8n-nodes-pachca (рекомендуем)
Второй: Использовать команду npm i n8n-nodes-pachca в нужной директории
Нажмите Add Credential, найдите Pachca API в списке и заполните поля:
Base URL: https://api.pachca.com/api/shared/v1
Access Token: Ваш токен доступа к API Pachca. Токен должен иметь необходимые права доступа для операций, которые вы планируете выполнять. В пачке есть три вида токенов:
токен Владельца / Администратора → доступен в разделе «Автоматизации»(
токен Бота → доступен в настройках бота
Для удобства можно переименовать созданный Credential. Таких Credentials вы можете сделать неограниченное количество для совершения разных операций.
Шаг 4. Создание Workflow
Workflow — это ваш рабочий стол, тот самый визуальный редактор с узлами (nodes). Тут вы выстраиваете цепочки триггеров и действий для различных сценариев.
В библиотеке Pachca (Beta) находятся все наши методы API. Разберем принципы работы n8n на примере сообщения от лица бота. Триггер — нажатие кнопки Execute Workflow (но может быть и любое другое событие, например, получение вебхука), а действие — Send a message в Пачке, где следующие параметры:
Credential = то, от чье-го лица будет отправлено сообщение (создали ранее)
Entity ID = это ID чата
Content = содержание сообщения
Главное, не забудьте добавить бота в чат Пачки :)
С помощью n8n можно реализовать в Пачке те же самые автоматизации, но в гораздо более лёгкой форме — достаточно заполнить значениями уже готовые блоки и выстроить нужную логику. Визуальный интерфейс позволяет видеть весь процесс целиком и мгновенно тестировать изменения. В платформу встроено более 400 готовых узлов для популярных сервисов, а дополнительные Community nodes можно установить прямо из интерфейса (если они опубликованы на npmjs.com, как Битрикс24). При необходимости можно отправлять HTTP request, например, для работы с любым открытым API, задавать условия if, добавлять кастомный JavaScript или Python код и многое другое.