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

Установка

Установка n8n

Два способа установки:

С помощью команды (требуется 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

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

Расширение доступно на npm и GitHub.

Три способа установки:

  1. Зайти в Settings > Community nodes и добавить n8n-nodes-pachca (рекомендуется)
  2. Выполнить команду npm i n8n-nodes-pachca в директории n8n
  3. Следовать README-инструкции на GitHub

Настройка 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
Bot IDнетID бота — нужен для авторегистрации вебхука в Pachca Trigger. Автоопределяется из токена бота
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 в списке узлов.

Поиск узла Pachca

После добавления узла на канвасе появится цепочка: Manual Trigger → Pachca.

Pachca на канвасе

Настройка и запуск

Дважды кликните на узел Pachca и настройте:

  • Credential: выберите созданный Pachca API
  • Resource: Message
  • Operation: Create
  • Entity ID: ID чата (число)
  • Content: текст сообщения

Настройка Message → Create

Перед отправкой сообщения добавьте бота в чат.

Закройте панель настроек и нажмите Execute Workflow. При успехе узлы подсветятся зелёным и покажут количество обработанных элементов.

Workflow выполнен

Откройте узел Pachca, чтобы увидеть ответ API с данными созданного сообщения.

Ответ API в панели Output

Больше примеров — в разделе Примеры workflow.