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

Триггер

Узел Pachca Trigger запускает workflow, когда в Пачке что-то происходит: приходит новое сообщение, сотрудник нажимает кнопку или отправляет форму, меняется состав чата, начинается видеозвонок.

Поддерживаемые события

В поле Event узла выбирается одно из 19 событий или All Events. Пачка присылает боту только те события, которые отмечены на вкладке Исходящий вебхук в его карточке, поэтому для каждого события ниже указан пункт, который нужно отметить. Отмечать пункты нужно в обоих режимах регистрации: узел прописывает боту только адрес вебхука и список событий не меняет.

Сообщения и чаты

Событие в узлеЗначениеПункт на вкладке «Исходящий вебхук»Когда приходит
New Messagenew_messageНовые сообщенияВ чате или треде появилось сообщение
Message Updatedmessage_updatedРедактирование и удаление сообщенийСообщение отредактировали
Message Deletedmessage_deletedРедактирование и удаление сообщенийСообщение удалили
New Reactionnew_reactionДобавление и удаление реакцийНа сообщение поставили реакцию
Reaction Deletedreaction_deletedДобавление и удаление реакцийРеакцию сняли
Chat Member Addedchat_member_addedИзменение состава участников чатовВ чат добавили участника
Chat Member Removedchat_member_removedИзменение состава участников чатовУчастника удалили из чата

Кнопки, формы и ссылки

Событие в узлеЗначениеПункт на вкладке «Исходящий вебхук»Когда приходит
Button Pressedbutton_pressedНажатие кнопокСотрудник нажал Data-кнопку в сообщении бота
Form Submittedform_submittedНажатие кнопокСотрудник отправил форму, которую открыл бот
Link Sharedlink_sharedОтправка ссылок в сообщении (unfurl)В сообщении появилась ссылка на один из доменов бота

Отдельного пункта для форм нет: отправка формы приходит вместе с нажатиями кнопок. Пункт для ссылок и домены включает только администратор или владелец пространства, и у бота с этим пунктом адрес вебхука тоже меняют только они. Как настроить для такого бота Pachca Trigger — в разделе Разворачивание ссылок.

Сотрудники

Событие в узлеЗначениеПункт на вкладке «Исходящий вебхук»Когда приходит
User Invitedcompany_member_inviteИзменение участников пространстваСотруднику отправили приглашение
User Confirmedcompany_member_confirmИзменение участников пространстваСотрудник принял приглашение
User Activatedcompany_member_activateИзменение участников пространстваСотрудника снова активировали
User Updatedcompany_member_updateИзменение участников пространстваИзменились данные сотрудника
User Suspendedcompany_member_suspendИзменение участников пространстваСотрудника приостановили
User Deletedcompany_member_deleteИзменение участников пространстваСотрудника удалили

Видеозвонки

Событие в узлеЗначениеПункт на вкладке «Исходящий вебхук»Когда приходит
Video Call Startedvideo_call_startedНачало видеозвонкаВ чате или треде начался видеозвонок
Video Call Finishedvideo_call_finishedЗавершение видеозвонкаВидеозвонок завершился
Video Call Recording Readyvideo_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 сам управлял слотом вебхука бота.

В обоих режимах события и режим новых сообщений отмечаются на вкладке Исходящий вебхук по таблице из раздела Поддерживаемые события.

Автоматический режим управляет единственным слотом вебхука бота: при публикации он перезапишет текущий адрес, при снятии с публикации — очистит. Если слот занят чем-то ещё, используйте ручной режим или отдельного бота для 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.

В ручном режиме URL в настройках бота вы ставите сами — значит и очищать его тоже нужно самостоятельно. Если вы удаляете workflow или меняете URL, замените адрес на вкладке Исходящий вебхук в карточке бота или удалите там вебхук кнопкой Удалить вебхук — иначе Пачка будет продолжать отправлять события на недоступный адрес. Удаление вебхука сбрасывает отмеченные события и меняет Signing secret: если позже снова подключите этого бота к n8n, отметьте события заново и вставьте новый секрет в поле Webhook Signing Secret в Credentials, иначе узел отклонит все события.

Автоматический режим

Автоматический режим работает и с токеном бота (проще всего — саморегистрация, без Bot ID, нужны права 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 с публикации узел автоматически очищает адрес вебхука в настройках бота — бот перестаёт отправлять события.

Автоматическая регистрация вебхука
Загрузка диаграммы...
Если получили 403 Forbidden при публикации — токену не хватает прав. Для токена бота добавьте ему права 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:writeBot → Update WebhookOutgoing URL
Персональный токен со скоупом bots:write и доступом редактора к ботуBot → UpdateID бота и 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 и отклоняет запросы без подписи или с неверной подписью.

Подробнее о механизме подписи — в разделе Безопасность и обработчик.

В продакшене всегда заполняйте Webhook Signing Secret: без него узел принимает запросы от кого угодно, кто знает адрес.

Ограничение по IP

Укажите в поле Webhook Allowed IPs в Credentials через запятую адреса, с которых Пачка отправляет вебхуки. Список адресов — в разделе Безопасность и обработчик, укажите все.

Если поле пустое — проверка IP отключена и запросы принимаются с любого адреса.

Ограничение по IP — дополнительная мера. Заголовок x-forwarded-for может быть подменён, если n8n не стоит за доверенным reverse proxy. Используйте его вместе с Webhook Signing Secret.

Защита от повторов

Pachca Trigger отклоняет события, у которых метка webhook_timestamp в теле запроса старше 5 минут или больше чем на минуту в будущем. Это защищает от повторной отправки перехваченного запроса (replay-атаки). Если в Credentials заполнен Webhook Signing Secret, отклоняется и событие без метки, а без секрета такое событие принимается.

Пачка ставит метку заново при каждой попытке доставки, поэтому её собственные повторы в это окно укладываются. Отклонить их может только неверное время на сервере n8n: если его часы отстают больше чем на минуту или спешат больше чем на пять.

Фильтрация событий

Узел запускает workflow только при совпадении с выбранным событием, остальные события он отбрасывает. Один узел слушает одно событие.

Если нужно обрабатывать несколько событий, выберите All Events (*) и разведите их узлом Switch по полям type и event из тела события. Поскольку у бота один адрес вебхука, это единственный способ получать разные события одним ботом.

Готовые сценарии с Pachca Trigger — в разделе Примеры workflow.