Триггер
Узел Pachca Trigger запускает workflow, когда в Пачке что-то происходит: приходит новое сообщение, сотрудник нажимает кнопку или отправляет форму, меняется состав чата, начинается видеозвонок.
Поддерживаемые события
В поле Event узла выбирается одно из 19 событий или All Events. Пачка присылает боту только те события, которые отмечены на вкладке Исходящий вебхук в его карточке, поэтому для каждого события ниже указан пункт, который нужно отметить. Отмечать пункты нужно в обоих режимах регистрации: узел прописывает боту только адрес вебхука и список событий не меняет.
Сообщения и чаты
| Событие в узле | Значение | Пункт на вкладке «Исходящий вебхук» | Когда приходит |
|---|---|---|---|
| New Message | new_message | Новые сообщения | В чате или треде появилось сообщение |
| Message Updated | message_updated | Редактирование и удаление сообщений | Сообщение отредактировали |
| Message Deleted | message_deleted | Редактирование и удаление сообщений | Сообщение удалили |
| New Reaction | new_reaction | Добавление и удаление реакций | На сообщение поставили реакцию |
| Reaction Deleted | reaction_deleted | Добавление и удаление реакций | Реакцию сняли |
| Chat Member Added | chat_member_added | Изменение состава участников чатов | В чат добавили участника |
| Chat Member Removed | chat_member_removed | Изменение состава участников чатов | Участника удалили из чата |
Кнопки, формы и ссылки
| Событие в узле | Значение | Пункт на вкладке «Исходящий вебхук» | Когда приходит |
|---|---|---|---|
| Button Pressed | button_pressed | Нажатие кнопок | Сотрудник нажал Data-кнопку в сообщении бота |
| Form Submitted | form_submitted | Нажатие кнопок | Сотрудник отправил форму, которую открыл бот |
| Link Shared | link_shared | Отправка ссылок в сообщении (unfurl) | В сообщении появилась ссылка на один из доменов бота |
Отдельного пункта для форм нет: отправка формы приходит вместе с нажатиями кнопок. Пункт для ссылок и домены включает только администратор или владелец пространства, и у бота с этим пунктом адрес вебхука тоже меняют только они. Как настроить для такого бота Pachca Trigger — в разделе Разворачивание ссылок.
Сотрудники
| Событие в узле | Значение | Пункт на вкладке «Исходящий вебхук» | Когда приходит |
|---|---|---|---|
| User Invited | company_member_invite | Изменение участников пространства | Сотруднику отправили приглашение |
| User Confirmed | company_member_confirm | Изменение участников пространства | Сотрудник принял приглашение |
| User Activated | company_member_activate | Изменение участников пространства | Сотрудника снова активировали |
| User Updated | company_member_update | Изменение участников пространства | Изменились данные сотрудника |
| User Suspended | company_member_suspend | Изменение участников пространства | Сотрудника приостановили |
| User Deleted | company_member_delete | Изменение участников пространства | Сотрудника удалили |
Видеозвонки
| Событие в узле | Значение | Пункт на вкладке «Исходящий вебхук» | Когда приходит |
|---|---|---|---|
| Video Call Started | video_call_started | Начало видеозвонка | В чате или треде начался видеозвонок |
| Video Call Finished | video_call_finished | Завершение видеозвонка | Видеозвонок завершился |
| Video Call Recording Ready | video_call_recording_ready | Готовность записи видеозвонка | Запись видеозвонка обработана и готова |
Все события
| Событие в узле | Значение | Пункт на вкладке «Исходящий вебхук» | Когда приходит |
|---|---|---|---|
| All Events | * | Пункты всех событий, которые разбирает workflow | Любое событие, которое Пачка отправила боту |
Выбор события в Pachca Trigger
Режим новых сообщений
У пункта Новые сообщения два режима. Любые сообщения присылает все новые сообщения, Начинающиеся с команд — только те, что начинаются с одной из команд бота. Режим действует и на Message Updated, а Message Deleted приходит в любом режиме.
Новый бот подписан только на новые сообщения в режиме «Начинающиеся с команд» с пустым списком команд, поэтому workflow с New Message ничего не получит. Выберите режим «Любые сообщения» или перечислите команды, например /отпуск. Как устроены команды — в разделе Сообщения.
Если workflow отвечает в тот же чат, включите на вкладке Исходящий вебхук переключатель Игнорировать свои сообщения. Иначе в режиме «Любые сообщения» каждый ответ бота снова запустит workflow. Что ещё отсекает переключатель, сказано в разделе Какие события создавать.
Как работают вебхуки в Пачке
У бота в Пачке один слот для адреса исходящего вебхука. Поэтому:
- На одного бота можно зарегистрировать только один URL
- Новая запись полностью перезаписывает предыдущую
- Каждому workflow с Pachca Trigger нужен свой бот: из двух workflow на одном боте события получает тот, чей адрес записан последним
- Несколько событий одним ботом обрабатывает один workflow с событием All Events и узлом Switch, как в примере Заявка на отпуск
- Для тестов и продакшена нужны разные боты, иначе тестовый запуск перезапишет адрес продакшена
Pachca Trigger поддерживает два режима настройки: автоматический (узел сам регистрирует URL в Пачке при публикации workflow) и ручной (вы копируете URL и вставляете его в настройки бота сами).
Чтобы добавить узел Pachca Trigger, в пустом workflow нажмите Add first step…: справа откроется панель What triggers this workflow? с поиском. Введите в поиск Pachca. Поиск находит одну запись Pachca с отметкой verified, в ней собраны и действия, и Pachca Trigger. Откройте её и в разделе Triggers выберите событие, например On new message. n8n добавит узел Pachca Trigger с этим событием в поле Event.
Поиск Pachca в пустом workflow
Как регистрируется вебхук
В узле Pachca Trigger параметр Webhook Setup определяет, кто прописывает адрес вебхука в настройках бота — вы или сам узел:
| Режим | Что делает узел | Когда использовать |
|---|---|---|
| Ручной (по умолчанию) | Не трогает настройки бота. Вы сами копируете Production URL из панели узла и вставляете его в настройки бота в Пачке. | Работает с любым токеном, включая токены ботов. Не может случайно перезаписать слот вебхука. |
| Автоматический | При публикации workflow регистрирует Production URL в настройках бота, при снятии с публикации — очищает. С токеном бота — методом PUTСаморегистрация вебхука бота, без Bot ID: нужны права profile:read и bot_self:webhook:write. С персональным токеном — методом PUTРедактирование бота: нужны скоуп bots:write, доступ редактора к боту и Bot ID. | Когда хотите, чтобы n8n сам управлял слотом вебхука бота. |
В обоих режимах события и режим новых сообщений отмечаются на вкладке Исходящий вебхук по таблице из раздела Поддерживаемые события.
Ручной режим
Настройка Pachca Trigger
Режим по умолчанию. Узел не обращается к API Пачки: вы копируете адрес вебхука из n8n и вставляете его в настройки бота в Пачке сами. При снятии workflow с публикации узел тоже ничего не делает со слотом.
Добавьте Pachca Trigger
Создайте новый workflow и добавьте узел Pachca Trigger с нужным событием, как описано выше: Add first step…, поиск Pachca, событие в разделе Triggers. В поле Credential выберите учётные данные Пачки. Параметр Webhook Setup оставьте в значении Manual (это значение по умолчанию).
Скопируйте Production URL
Раскройте блок Webhook URLs в верхней части панели узла. Переключатель в нём показывает один из двух URL:
- Test URL (
/webhook-test/...) — временный URL, активен только во время теста кнопкой Execute step - Production URL (
/webhook/...) — постоянный URL, работает, пока workflow опубликован
Для настройки в Пачке нужен Production URL. Выберите его в переключателе и нажмите на адрес: n8n скопирует его и покажет «URL copied».
Test URL и Production URL в верхней части панели узла
Вставьте URL в настройки бота в Пачке
Откройте карточку бота в Пачке и на вкладке Исходящий вебхук нажмите Включить, если вебхук ещё не включён. В карточке Как получать события вставьте скопированный Production URL в поле Webhook URL и нажмите Сохранить рядом с полем. Подробнее — в разделе Как получать события.
Отметьте события
На той же вкладке отметьте пункт для выбранного события по таблице событий. Для New Message выберите режим Любые сообщения или перечислите команды.
Вернитесь в n8n и опубликуйте workflow
Нажмите Publish в правом верхнем углу и подтвердите кнопкой Publish в окне Publish workflow. Кнопка сменится на Published, и с этого момента бот отправляет события в ваш workflow.
Автоматический режим
profile:read и bot_self:webhook:write), и с персональным токеном (нужны скоуп bots:write, доступ редактора к боту и Bot ID).Автоматический режим: переключатель Webhook Setup и поле Bot ID (нужно только для персонального токена)
Узел определяет тип токена методом GETСвой профиль. Токен бота регистрирует свой вебхук сам — методом PUTСаморегистрация вебхука бота, Bot ID не нужен. Персональный токен прописывает вебхук выбранному боту методом PUTРедактирование бота — Bot ID обязателен, потому что персональный токен не привязан к конкретному боту.
Для метода GETСвой профиль токену нужно право profile:read. Права токена бота выбирают отдельно для каждого токена, поэтому проверьте, что это право у него отмечено. Если права нет и Bot ID не заполнен, узел не активируется и называет недостающее право. С заполненным Bot ID узел регистрирует вебхук как персональный токен. Что делать в каждом случае — в разделе Узел не определил тип токена.
Вставьте токен в Credentials
Откройте Pachca API Credentials и в поле Access Token вставьте токен. Подойдёт токен бота (карточка бота → вкладка API) с правами profile:read и bot_self:webhook:write — тогда бот зарегистрирует вебхук сам. Или персональный токен (Интеграции → API) со скоупом bots:write, если его владелец может редактировать целевого бота.
Переключите Webhook Setup на Automatic
В узле Pachca Trigger выберите нужное событие, затем установите Webhook Setup = Automatic.
Укажите Bot ID для персонального токена
Для персонального токена заполните появившееся поле Bot ID — ID бота, которому нужно прописать адрес вебхука (это user_id на вкладке API карточки бота, его же видно в адресе карточки). Для токена бота это поле не нужно: бот регистрирует себя сам.
Опубликуйте workflow
Нажмите Publish в правом верхнем углу и подтвердите кнопкой Publish в окне Publish workflow. Узел сам зарегистрирует Production URL в настройках бота, и вебхук бота включится.
Отметьте события в карточке бота
Откройте карточку бота в Пачке и на вкладке Исходящий вебхук отметьте пункт для выбранного события по таблице событий. Для New Message выберите режим Любые сообщения или перечислите команды. Отметки сохраняются, когда узел очищает и снова прописывает адрес.
При снятии workflow с публикации узел автоматически очищает адрес вебхука в настройках бота — бот перестаёт отправлять события.
profile:read и bot_self:webhook:write (карточка бота → вкладка API → Редактировать в меню токена). Для персонального токена нужен скоуп bots:write и доступ редактора к указанному боту — проверьте доступы или вернитесь в Manual. Тексты ошибок и решения — в разделе 403 Forbidden при публикации Pachca Trigger.Установка адреса узлом Pachca
Адрес вебхука можно прописать и обычным узлом Pachca, прямо из workflow: например, в рамках деплоя или чтобы переключать слот между разными серверами n8n. Этот путь не требует публиковать workflow с Pachca Trigger.
| Токен в Credentials | Операция | Поля |
|---|---|---|
Токен бота с правом bot_self:webhook:write | Bot → Update Webhook | Outgoing URL |
Персональный токен со скоупом bots:write и доступом редактора к боту | Bot → Update | ID бота и Webhook URL |
Запустите узел вручную или по расписанию. В Update Webhook поле адреса обязательное: чтобы очистить слот, задайте в нём выражение {{ "" }}. Если у бота включена история событий, события продолжат сохраняться в неё. В Update пустое поле оставляет адрес как есть. В узле v1 есть только Bot → Update, поле id бота в нём называется Bot ID.
С персональным токеном операция Update задаёт и события: в Additional Fields укажите Events — значения из колонки «Значения в events» таблицы Какие события откуда приходят через запятую, например message_new,button_click, и Trigger On = All Messages. Список событий заменяется целиком.
Тестирование
У бота в Пачке только один слот для адреса вебхука, поэтому тестовый запуск требует осторожности: неправильный тест перезаписывает адрес продакшена и ломает живой workflow. В автоматическом режиме Pachca Trigger блокирует тестовый запуск кнопкой Execute step, если workflow уже опубликован. Это защищает от самого частого сценария. В ручном режиме узел не управляет слотом, и за подмену адреса отвечаете вы. Полная инструкция с тремя способами тестирования и диаграммой — в разделе Тестирование.
Безопасность
Проверка подписи
Для защиты от поддельных запросов вставьте секрет подписи бота в поле Webhook Signing Secret в Credentials. Секрет лежит в поле Signing secret на вкладке Исходящий вебхук в карточке бота. Pachca Trigger проверяет HMAC-SHA256 подпись каждого запроса по заголовку pachca-signature и отклоняет запросы без подписи или с неверной подписью.
Подробнее о механизме подписи — в разделе Безопасность и обработчик.
Ограничение по IP
Укажите в поле Webhook Allowed IPs в Credentials через запятую адреса, с которых Пачка отправляет вебхуки. Список адресов — в разделе Безопасность и обработчик, укажите все.
Если поле пустое — проверка IP отключена и запросы принимаются с любого адреса.
x-forwarded-for может быть подменён, если n8n не стоит за доверенным reverse proxy. Используйте его вместе с Webhook Signing Secret.Защита от повторов
Pachca Trigger отклоняет события, у которых метка webhook_timestamp в теле запроса старше 5 минут или больше чем на минуту в будущем. Это защищает от повторной отправки перехваченного запроса (replay-атаки). Если в Credentials заполнен Webhook Signing Secret, отклоняется и событие без метки, а без секрета такое событие принимается.
Пачка ставит метку заново при каждой попытке доставки, поэтому её собственные повторы в это окно укладываются. Отклонить их может только неверное время на сервере n8n: если его часы отстают больше чем на минуту или спешат больше чем на пять.
Фильтрация событий
Узел запускает workflow только при совпадении с выбранным событием, остальные события он отбрасывает. Один узел слушает одно событие.
*) и разведите их узлом Switch по полям type и event из тела события. Поскольку у бота один адрес вебхука, это единственный способ получать разные события одним ботом.Готовые сценарии с Pachca Trigger — в разделе Примеры workflow.