Начало работы
Где запустить 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 или новее):
С помощью Docker:
Подробные инструкции — в официальной документации 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 и список операций
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 — поставьте пакет вручную:
Или скачайте архив 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
Первый 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.