Триггер

Узел 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

Бот получает события только из чатов, в которых он состоит. Убедитесь, что бот добавлен в нужные чаты.

Настройка

Добавьте узел Pachca Trigger в workflow — найдите его через поиск в панели узлов.

Поиск Pachca Trigger

Автоматический режим (рекомендуется)

Настройка Pachca Trigger

При наличии Bot ID в Credentials вебхук регистрируется автоматически:

Укажите Bot ID в Credentials

Откройте Pachca API Credentials и заполните поле Bot ID — это ID вашего бота в Пачке.

Добавьте Pachca Trigger

Создайте новый workflow и добавьте узел Pachca Trigger. Выберите нужный тип события.

Активируйте workflow

Нажмите Activate. n8n автоматически вызовет PUTОбновление бота и зарегистрирует webhook URL в настройках бота.

При деактивации workflow вебхук автоматически удаляется.

Автоматическая регистрация вебхука
Загрузка диаграммы...

Ручной режим

Если Bot ID не указан в Credentials:

  1. Добавьте узел Pachca Trigger в workflow
  2. Скопируйте сгенерированный Webhook URL из настроек узла
  3. Вставьте URL в настройки бота в Пачке (раздел Webhook URL)
  4. Активируйте workflow

Безопасность

Проверка подписи

Для защиты от поддельных запросов добавьте Signing Secret бота в Credentials. Trigger автоматически проверяет HMAC-SHA256 подпись каждого входящего запроса через заголовок pachca-signature и отклоняет невалидные.

Подробнее о механизме подписи — в разделе Исходящие вебхуки.

Рекомендуется всегда использовать Signing Secret в продакшене для защиты от несанкционированных запросов.

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

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

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

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

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

Trigger автоматически отклоняет события старше 5 минут (по полю webhook_timestamp в теле запроса). Это защищает от replay-атак — повторной отправки перехваченного запроса.

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

Выберите конкретный тип события для фильтрации — workflow будет запускаться только при совпадении. Можно выбрать только один тип события на один узел Trigger.

Используйте All Events (*) и фильтруйте в последующих узлах (например, через IF или Switch), если нужна сложная логика маршрутизации по типу события или обработка нескольких типов в одном workflow.

Пример: бот-эхо

Workflow с триггером и действием Pachca

Простой workflow, который отвечает на каждое новое сообщение:

  1. Pachca Trigger — событие New Message
  2. IF — условие: message.user_id не равен ID бота (чтобы бот не отвечал сам себе)
  3. Pachca — операция Message > Create, entityId = ID чата из триггера, content = текст ответа
ID бота — это user_id из ответа GETИнформация о профиле при авторизации токеном бота.

Больше готовых сценариев — в разделе Примеры workflow.