Для разработчиков

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

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

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

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

n8n Cloud

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

Self-hosted

Запустите n8n на собственном сервере или локально. Два варианта: npx — для быстрой локальной пробы, Docker — для постоянной работы и продакшена. Пачка отправляет вебхуки только на публичный адрес. Если n8n запущен на вашей машине, события доходят до него через туннель, как в разделе Локальная разработка, или через команду CLI pachca bots listen-events --forward-to, как в разделе Разработка без публичного адреса.

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

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 \  -v n8n_data:/home/node/.n8n \  n8nio/n8n

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

После запуска откройте http://localhost:5678 и заполните форму Set up owner account: почта, имя, фамилия и пароль владельца. Затем нажмите Next.

Настройка аккаунта владельца

После этого n8n может показать короткую анкету Customize n8n to you и затем откроет главную страницу. Пока workflow нет, на ней заголовок Let's build your first automation и карточки Build an agent и Build a workflow.

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

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

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

Откройте Nodes panel

Войдите в n8n, создайте или откройте любой workflow и нажмите + в правом верхнем углу канваса. Справа откроется Nodes panel. В пустом workflow она называется What triggers this workflow?, а если триггер уже есть, What happens next?.

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

Введите «Pachca» в поиск. Пока расширение не установлено, n8n показывает его в разделе More from the community внизу панели. Нода Pachca отмечена значком verified: это партнёрский статус verified by n8n.

Узел действий Pachca и триггер Pachca Trigger n8n объединяет в одну запись Pachca, поэтому под названием стоит описание триггера «Starts workflow when Pachca events occur». Из панели What happens next? запись открывает список действий узла (Actions), а из What triggers this workflow? открывает события триггера (Triggers).

Поиск Pachca в Nodes panel: значок verified рядом с названием

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

Нажмите на запись. Откроется панель Node details с описанием, списком действий и кнопкой Install node. Через несколько секунд в панели появится статус Installed, а нода станет доступна в поиске узлов всем участникам instance.

Node details: verified by n8n, статус Installed и список операций

Установить verified-ноду может только instance owner или admin. Если у вас другая роль — попросите администратора.
На self-hosted ноду можно поставить и из настроек: Settings > Community nodes > Install. Введите n8n-nodes-pachca в поле npm Package Name, отметьте I understand the risks of installing unverified code from a public source и нажмите Install. Итог тот же: нода появится в Nodes panel.

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

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

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

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

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

  • n8n Cloud: verified-ноды включены по умолчанию. Если в поиске их нет, instance owner мог выключить переключатель Verified community nodes в разделе Instance settings консоли n8n Cloud. Попросите его включить.
  • Self-hosted или старая версия n8n — что проверить, описано в разделе Расширение не появляется в Nodes panel.

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

Настройка Credentials

Создание Credentials

Credentials — данные для авторизации. Откройте Overview на боковой панели (значок домика), перейдите на вкладку Credentials и нажмите Create credential.

Вкладка Credentials

Откроется окно Add new credential. Введите «Pachca» в поле поиска, выберите Pachca API и нажмите Continue.

Выбор Pachca API в окне Add new credential

Заполните поля Pachca API:

ПолеОбязательноеОписание
Base URLнетБазовый URL API. Оставьте значение по умолчанию https://api.pachca.com/api/shared/v1.
Access TokenдаТокен бота или персональный токен
Webhook Signing SecretнетСекрет, которым Pachca Trigger проверяет подпись вебхуков (HMAC-SHA256). Скопируйте поле Signing secret с вкладки Исходящий вебхук в карточке бота. Для узла Pachca не нужен.
Webhook Allowed IPsнетАдреса через запятую, с которых Pachca Trigger принимает вебхуки. Адреса Пачки перечислены в разделе Безопасность и обработчик. Пустое поле — разрешить все.

Под этими полями n8n добавляет своё поле Allowed HTTP Request Domains: оно задаёт, к каким доменам узлы HTTP Request и GraphQL могут обращаться с этими учётными данными. Оставьте значение All.

Форма Pachca API Credentials

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

Для сценариев n8n подходит токен бота: сообщения уходят от имени бота, а Pachca Trigger получает события этого бота. Токен выпускается в карточке бота на вкладке API (Интеграции > Боты > Управление). По умолчанию любой сотрудник может создать бота и выпустить токен своему боту, а кому ещё открыта вкладка API, сказано в разделе Токены бота. Права для узлов Pachca и Pachca Trigger выберите по набору «Сценарий n8n» из раздела Наборы прав под типовые задачи.

Персональный токен (Интеграции > API) нужен для операций от имени сотрудника, например с черновиками или разделом «Важное». По умолчанию его создают только администраторы. Как выбрать токен под задачу — в разделе Какой токен выбрать, кому открыт выпуск токенов — в разделе Кто может создавать токены.

Набор операций зависит и от скоупов, и от типа токена: формы, разворачивание ссылок и история событий работают только с токеном бота, а черновики и «Важное» — только с персональным.

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

Connection tested successfully

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

Первый workflow

Создание workflow

Workflow — визуальный редактор, в котором выстраиваются цепочки триггеров и действий. Создайте новый workflow, нажмите Add first step и выберите Trigger manually. На канвасе появится триггер ручного запуска When clicking ‘Execute workflow’ (узел Manual Trigger).

Нажмите + на выходе триггера и в панели What happens next? найдите Pachca.

Поиск узла Pachca

Нажмите на запись Pachca и выберите действие Create a message. На канвасе появится цепочка из триггера и узла Pachca. n8n называет узел по действию, Create a message, а под названием показывает операцию create: message.

Узел Pachca на канвасе

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

После выбора действия n8n сразу открывает окно узла Create a message. Позже его можно открыть двойным кликом по узлу. Настройте:

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

Чат в поле Entity ID проще всего выбрать в режиме From list: начните вводить название, и n8n покажет подходящие чаты, доступные токену. В режиме By ID укажите число из ссылки на чат в веб-приложении Пачки. Как найти идентификаторы сотрудника, треда или сообщения — в разделе Где взять идентификаторы.

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

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

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

Workflow выполнен

Откройте узел Create a message: в панели Output будет ответ API с данными созданного сообщения. Переключатель Schema, Table и JSON меняет вид ответа.

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

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