Триггер
Узел Pachca Trigger запускает workflow при наступлении события в Пачке — новое сообщение, нажатие кнопки, отправка формы, изменение состава команды и др.
Поддерживаемые события
Сообщения и чаты
| Событие | Значение | Описание |
|---|---|---|
| Новое сообщение | new_message | Создание сообщения в чате |
| Сообщение изменено | message_updated | Редактирование существующего сообщения |
| Сообщение удалено | message_deleted | Удаление сообщения |
| Новая реакция | new_reaction | Добавление реакции к сообщению |
| Реакция удалена | reaction_deleted | Удаление реакции с сообщения |
| Участник добавлен | chat_member_added | Добавление участника в чат |
| Участник удалён | chat_member_removed | Удаление участника из чата |
Интерактивные элементы
| Событие | Значение | Описание |
|---|---|---|
| Нажатие кнопки | button_pressed | Клик по Data-кнопке в сообщении |
| Отправка формы | form_submitted | Отправка модальной формы |
| Ссылка отправлена | link_shared | Бот может развернуть превью ссылки |
Сотрудники
| Событие | Значение | Описание |
|---|---|---|
| Приглашение сотрудника | company_member_invite | Отправлено приглашение новому сотруднику |
| Подтверждение регистрации | company_member_confirm | Сотрудник подтвердил регистрацию |
| Активация сотрудника | company_member_activate | Сотрудник активирован |
| Обновление сотрудника | company_member_update | Изменение данных сотрудника |
| Приостановка сотрудника | company_member_suspend | Сотрудник приостановлен |
| Удаление сотрудника | company_member_delete | Сотрудник удалён |
Wildcard
| Событие | Значение | Описание |
|---|---|---|
| Все события | * | Получать все типы событий |
16 типов событий в Pachca Trigger
Как работают вебхуки в Пачке
Бот в Пачке имеет один слот для исходящего webhook URL. Это значит:
- На одного бота можно зарегистрировать только один URL
- Новая запись полностью перезаписывает предыдущую
- Для тестов и продакшена рекомендуется использовать разных ботов — иначе тестовый запуск перезатрёт продовый URL
Pachca Trigger поддерживает два режима настройки: автоматический (узел сам регистрирует URL в Пачке при активации workflow) и ручной (вы копируете URL и вставляете его в настройки бота сами).
Добавьте узел Pachca Trigger в workflow — найдите его через поиск в панели узлов.
Поиск Pachca Trigger
Как регистрируется вебхук
В узле Pachca Trigger параметр Webhook Setup определяет, кто прописывает Webhook URL в настройках бота — вы или сам узел:
| Режим | Что делает узел | Когда использовать |
|---|---|---|
| Ручной (по умолчанию) | Не трогает настройки бота. Вы сами копируете Production URL из панели узла и вставляете его в настройки бота в Пачке. | Работает с любым токеном, включая токены ботов. Не может случайно перезатереть webhook-слот. |
| Автоматический | При активации workflow регистрирует Production URL в настройках бота, при деактивации — очищает. С токеном бота — саморегистрация через PUTСаморегистрация вебхука бота, без Bot ID. С персональным токеном — через PUTРедактирование бота: нужны скоуп bots:write, доступ редактора к боту и Bot ID. | Когда хотите, чтобы n8n сам управлял webhook-слотом бота. |
Webhook URL, при деактивации — очистит. Если слот занят чем-то ещё, используйте ручной режим или отдельного бота для n8n.Ручной режим
Настройка Pachca Trigger
Режим по умолчанию. Узел не обращается к PUTРедактирование бота — вы копируете Webhook URL из n8n и вставляете его в настройки бота в Пачке самостоятельно. При деактивации workflow узел тоже ничего не делает со слотом.
Добавьте Pachca Trigger
Создайте новый workflow, добавьте узел Pachca Trigger и выберите нужный тип события. Параметр Webhook Setup оставьте в значении Manual (это значение по умолчанию).
Скопируйте Production URL
В верхней части панели узла n8n показывает два URL:
- Test URL (
/webhook-test/...) — временный URL, активен только во время ручного теста через кнопку Listen for test event - Production URL (
/webhook/...) — постоянный URL, работает, пока workflow активен
Для настройки в Пачке нужен Production URL. Нажмите иконку копирования рядом с ним.
Test URL и Production URL в верхней части панели узла
Вставьте URL в настройки бота в Пачке
Откройте настройки вашего бота в Пачке, перейдите на вкладку Исходящий Webhook и вставьте скопированный Production URL в поле Webhook URL. Подробнее — в разделе Настройка и типы событий.
Вернитесь в n8n и активируйте
Нажмите Activate в n8n. С этого момента бот отправляет события в ваш workflow.
Автоматический режим
bots:write, доступ редактора к боту и Bot ID).Автоматический режим: переключатель Webhook Setup и поле Bot ID (нужно только для персонального токена)
Узел определяет тип токена методом GETСвой профиль. Токен бота регистрирует свой вебхук сам — методом PUTСаморегистрация вебхука бота, Bot ID не нужен. Персональный токен прописывает вебхук выбранному боту методом PUTРедактирование бота — Bot ID обязателен, потому что персональный токен не привязан к конкретному боту.
Вставьте токен в Credentials
Откройте Pachca API Credentials и в поле Access Token вставьте токен. Подойдёт токен бота (из настроек бота → вкладка API) — тогда бот зарегистрирует вебхук сам. Или персональный токен (из Автоматизации → Интеграции → API) со скоупом bots:write и доступом редактора к целевому боту.
Переключите Webhook Setup на Automatic
В узле Pachca Trigger выберите нужный тип события, затем установите Webhook Setup = Automatic.
Укажите Bot ID — только для персонального токена
Для персонального токена заполните появившееся поле Bot ID — ID бота, которому нужно прописать Webhook URL (его видно в адресе страницы настроек бота в Пачке). Для токена бота это поле не нужно: бот регистрирует себя сам.
Активируйте workflow
Нажмите Activate в правом верхнем углу. Узел сам зарегистрирует Production URL в настройках бота. С этого момента бот отправляет события в ваш workflow.
При деактивации workflow узел автоматически очищает Webhook URL в настройках бота — бот перестаёт отправлять события.
bot_self:webhook:write (настройки бота → вкладка API). Для персонального токена нужен скоуп bots:write и доступ редактора к указанному боту — проверьте доступы или вернитесь в Manual.Альтернатива: установка URL через узел Pachca Bot Update
Если вы хотите обновить Webhook URL программно прямо из workflow (например, в рамках деплой-пайплайна, или когда требуется переключать слот между разными n8n-серверами), используйте обычный узел Pachca с операцией Bot → Update. Этот путь работает в обеих версиях ноды, не требует активации trigger-workflow и ведёт себя одинаково с логикой v1.
- Добавьте в workflow узел Pachca
- Выберите Resource = Bot, Operation = Update a bot
- Заполните Bot ID и Webhook URL
- Запустите узел вручную или по расписанию
Тот же механизм даёт способ очистить слот: передайте в Webhook URL пустую строку.
Тестирование
У бота в Пачке только один слот для webhook URL, поэтому тестовый запуск триггера требует осторожности — неправильный тест перезатирает продовый URL и ломает живой workflow. В автоматическом режиме Pachca Trigger блокирует Listen for Test Event, если workflow уже активен, — это защищает от самого частого сценария. В ручном режиме узел не управляет слотом, и ответственность за подмену URL полностью на вас. Полная инструкция с тремя способами тестирования и диаграммой — в отдельном разделе Тестирование.
Безопасность
Проверка подписи
Для защиты от поддельных запросов добавьте Signing Secret бота в Credentials. Trigger автоматически проверяет HMAC-SHA256 подпись каждого входящего запроса через заголовок pachca-signature и отклоняет невалидные.
Подробнее о механизме подписи — в разделе Безопасность и обработчик.
Ограничение по IP
Укажите Webhook Allowed IPs в Credentials — через запятую список IP-адресов, с которых принимаются вебхуки. Пачка отправляет вебхуки с IP 37.200.70.177.
Если поле пустое — проверка IP отключена и запросы принимаются с любого адреса.
x-forwarded-for может быть подменён, если n8n не стоит за доверенным reverse proxy. Используйте вместе с Signing Secret.Защита от повторов
Trigger автоматически отклоняет события старше 5 минут (по полю webhook_timestamp в теле запроса). Это защищает от replay-атак — повторной отправки перехваченного запроса.
Фильтрация событий
Выберите конкретный тип события для фильтрации — workflow будет запускаться только при совпадении. Можно выбрать только один тип события на один узел Trigger.
*) и фильтруйте в последующих узлах (например, через IF или Switch), если нужна сложная логика маршрутизации по типу события или обработка нескольких типов в одном workflow.Готовые сценарии с Pachca Trigger — в разделе Примеры workflow.