n8n

Начало работы

Pachcaвитрина · verified Pachca Triggerвитрина · verified n8n-nodes-pachcanpm · v2.0.6

Где запустить n8n

Если n8n уже работает, переходите сразу к разделу Установка расширения.

n8n можно использовать в двух режимах — выбирайте по контексту команды.

n8n Cloud (рекомендуется)

Облачная версия n8n Cloud — самый быстрый старт: не нужны сервер, обновления и публичный домен для вебхуков. Verified-ноды Пачки доступны в поиске по умолчанию.

Self-hosted

Запустите n8n на собственном сервере или локально. Два варианта: npx — для быстрой локальной пробы, Docker — для постоянной работы и продакшена.

С помощью команды (требуется Node.js 22+):

npx n8n

С помощью Docker:

docker volume create n8n_data docker run -it --rm \  --name n8n \  -p 5678:5678 \  -e GENERIC_TIMEZONE="Europe/Moscow" \  -e TZ="Europe/Moscow" \  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \  -e N8N_RUNNERS_ENABLED=true \  -v n8n_data:/home/node/.n8n \  docker.n8n.io/n8nio/n8n

Подробные инструкции — в официальной документации n8n и на GitHub.

После запуска откройте http://localhost:5678 и настройте аккаунт владельца (Owner Account), указав почту, имя и пароль.

Настройка Owner Account

После входа вы увидите главный экран n8n с пустым списком workflow.

Главная страница n8n

Установка расширения

Расширение Пачки публикуется как verified community node и устанавливается прямо из редактора n8n — без npm и Docker. Путь одинаковый для n8n Cloud и self-hosted.

Откройте Nodes panel

Войдите в n8n, создайте или откройте любой workflow и нажмите + в правом верхнем углу — справа откроется Nodes panel.

Найдите Pachca в поиске

Введите «Pachca» в поиск. В результатах появится нода Pachca с галочкой verified by n8n — это партнёрский статус. Нода Pachca Trigger найдётся таким же поиском, если открыть Nodes panel в начале workflow (выбор триггера).

Поиск Pachca в Nodes panel — verified-бейдж рядом с названием

Установите ноду

Нажмите на ноду — откроется страница Node details с описанием, списком operations и кнопкой Install. Через несколько секунд нода появится в обычном поиске узлов и будет доступна всем участникам instance.

Node details: verified by n8n, статус Installed, 67 actions

Установить verified-ноду может только instance owner или admin. Если у вас другая роль — попросите администратора.

Альтернативный путь — Settings → Community Nodes: введите n8n-nodes-pachca и нажмите Install. Подходит, если хочется зайти из настроек, а не из редактора. Итог тот же — нода доступна в Nodes panel.

Запасной путь: установка из npm для air-gapped self-hosted

Если основной путь через редактор недоступен — закрытый контур, кастомный Docker-образ, машина без доступа к интерфейсу n8n — поставьте пакет вручную:

cd ~/.n8n/nodesnpm install n8n-nodes-pachca

Или скачайте архив .tgz из GitHub Releases и распакуйте в ~/.n8n/nodes/. После этого перезапустите n8n.

Если расширение не видно в поиске

n8n Cloud: verified-ноды включены по умолчанию. Если в поиске их нет, instance owner мог отключить их в Cloud Admin Panel — попросите включить.
Self-hosted: убедитесь, что переменная N8N_COMMUNITY_PACKAGES_ENABLED=true (это значение по умолчанию для актуальных версий n8n).
Старая версия n8n (< 1.0): community-ноды не поддерживаются — обновите n8n.

Подробнее — в официальных доках n8n про verified-ноды.

Настройка Credentials

Создание Credentials

Credentials — данные для авторизации. Перейдите в Credentials и нажмите Add Credential.

Список Credentials

Найдите Pachca API в списке и заполните поля:

Поиск Pachca API в списке Credentials

Поле	Обязательное	Описание
Base URL	нет	Базовый URL API. По умолчанию `https://api.pachca.com/api/shared/v1`. Менять только для on-premise
Access Token	да	Токен доступа к API
Signing Secret	нет	Секрет для верификации входящих webhook-запросов (HMAC-SHA256)
Webhook Allowed IPs	нет	Список IP-адресов через запятую, с которых разрешены входящие вебхуки. Пачка отправляет с `37.200.70.177`. Пустое поле — разрешить все

Форма Pachca API Credentials

Где получить токен

В Пачке доступны два типа токенов:

Персональный токен — доступен в разделе Автоматизации > Интеграции > API
Токен бота — доступен в настройках бота на вкладке API

Доступные операции зависят от скоупов токена, а не от его типа. Подробнее — в разделе Авторизация.

После заполнения полей нажмите Test — n8n проверит подключение вызовом GETИнформация о токене. При успехе вы увидите подтверждение.

Connection tested successfully

Если тест не проходит — проверьте правильность токена и доступность API. Подробнее — в разделе Устранение ошибок.

Первый workflow

Создание workflow

Workflow — визуальный редактор, в котором выстраиваются цепочки триггеров и действий. Создайте новый workflow и добавьте триггер Manual Trigger для ручного запуска.

Нажмите + на выходе триггера и найдите Pachca в списке узлов.