Устранение ошибок

Установка расширения

Расширение не появляется в Nodes panel

Причина: verified-ноды Пачки не подключены к instance n8n.

Решение:

  • n8n Cloud: verified-ноды включены по умолчанию. Если в поиске их нет, instance owner мог отключить их в Cloud Admin Panel — попросите включить
  • Self-hosted: проверьте переменную N8N_COMMUNITY_PACKAGES_ENABLED=true (значение по умолчанию). Подробнее — в официальных доках n8n
  • Старая версия n8n (< 1.0): community-ноды не поддерживаются — обновите n8n до актуальной версии

Кнопка Install неактивна

Причина: verified-ноду может установить только instance owner или admin.

Решение: запросите установку у администратора. После установки нода доступна всем участникам instance — отдельной активации для каждого пользователя не нужно.


Ошибки авторизации

Неверный токен (401 Unauthorized)

Ошибка авторизации

Причина: указан некорректный или просроченный Access Token.

Решение:

  1. Откройте Credentials и проверьте значение Access Token
  2. Убедитесь, что токен скопирован целиком, без лишних пробелов
  3. Нажмите Test — при ошибке создайте новый токен в Пачке
  4. Для бот-токена: Настройки бота → вкладка API → скопируйте токен
  5. Для персонального токена: АвтоматизацииИнтеграцииAPI

Недостаточно прав (403 Forbidden)

Причина: операция требует более высокий уровень доступа, чем предоставляет текущий токен.

Решение:

Доступ к операциям определяется скоупами токена, а не его типом. Убедитесь, что ваш токен включает нужные скоупы:

ОперацияТребуемые скоупы
Управление сотрудниками (User > Create/Update/Delete)users:write (доступен администраторам и владельцам)
Журнал безопасности (Security > Get Many)audit_events:read (доступен администраторам и владельцам)
Управление тегами (Group Tag > Create/Update/Delete)group_tags:write (доступен администраторам и владельцам)
Автоматическая регистрация вебхука в Pachca Triggerbots:write
Отправка сообщений, чаты, задачиmessages:write, chats:write, tasks:write

Подробнее — в разделе Авторизация.

403 Forbidden при активации Pachca Trigger

Причина: узел попытался автоматически прописать Webhook URL в настройках бота через PUTОбновление бота, но у персонального токена либо отсутствует скоуп bots:write, либо нет доступа редактора к указанному боту.

Текст ошибки:

Pachca rejected automatic webhook registration (403 Forbidden).

Решение:

  1. Откройте настройки бота в Пачке и убедитесь, что у пользователя, которому принадлежит персональный токен, стоит роль Редактор в списке доступов бота
  2. Проверьте, что у токена есть скоуп bots:write (в настройках токена в АвтоматизацииИнтеграцииAPI)
  3. Либо переключите Webhook Setup = Manual и пропишите Production URL в настройках бота самостоятельно — см. Ручной режим

Автоматический режим не поддерживается для токенов ботов

Причина: в узле Pachca Trigger выбран режим Automatic, но в Credentials указан токен бота. Публичный API Пачки сейчас не разрешает боту обновлять собственный outgoing_url.

Текст ошибки:

Automatic webhook registration is not yet supported for bot tokens.

Решение: используйте один из трёх вариантов:

  • Переключите Webhook Setup = Manual и вставьте Production URL из узла в настройки бота (вкладка Исходящий Webhook → поле Webhook URL) — работает с любым токеном, включая бот-токены
  • Укажите в Credentials персональный токен со скоупом bots:write и доступом редактора к боту, затем в узле задайте Bot ID целевого бота
  • Пропишите Webhook URL отдельным узлом Pachca Bot Update — см. Альтернатива: установка URL через узел Pachca Bot Update
Поддержка автоматического режима для токенов ботов находится в активной разработке на стороне бекенда Пачки и появится в одном из ближайших обновлений.

Ошибки лимитов

Превышение лимита (429 Too Many Requests)

Причина: слишком много запросов за единицу времени.

Лимиты API:

Тип операцииЛимит
Отправка сообщений~4 запроса/сек на чат
Остальные операции~50 запросов/сек

Решение:

  1. Добавьте узел Wait между операциями для замедления
  2. Используйте Batching в настройках узла Pachca (Additional Fields → Request Options → Batching)
  3. Для массовых операций используйте Return All = false с ограниченным Limit
При получении 429 или 5xx расширение автоматически повторяет запросы с экспоненциальной задержкой и jitter (до 5 попыток). Учитывается заголовок Retry-After из ответа API.

Ошибки триггера

Вебхук не приходит

Возможные причины и решения:

  1. Бот не добавлен в чат — бот получает события только из чатов, в которых он состоит. Добавьте бота в нужный канал
  2. Workflow не активирован — нажмите Activate в правом верхнем углу. Неактивные workflow не принимают вебхуки
  3. URL не прописан в настройках бота — в ручном режиме узел не трогает webhook-слот бота. Проверьте, что Production URL вставлен в поле Webhook URL в настройках бота (вкладка Исходящий Webhook). В автоматическом режиме убедитесь, что в узле указан корректный Bot ID
  4. n8n недоступен извне — при локальной установке Пачка не может отправить вебхук на localhost. Используйте туннель (ngrok, Cloudflare Tunnel) или разверните n8n на сервере с публичным IP

Ошибка подписи (Signature Mismatch)

Причина: Signing Secret в Credentials не совпадает с секретом бота в Пачке.

Решение: скопируйте Signing Secret из настроек бота в Пачке (вкладка Исходящий Webhook) и вставьте в Credentials.


Ошибки данных

Entity ID не найден

Причина: указан несуществующий ID чата, пользователя или сообщения.

Решение:

  • Для чатов: используйте Search (Search > Get Many Chats) для поиска по имени
  • Для пользователей: используйте Search (Search > Get Many Users) для поиска
  • Для сообщений: убедитесь, что сообщение не было удалено

Бот не может отправить сообщение

Причина: бот не является участником целевого чата.

Решение: добавьте бота в чат. Бот может отправлять сообщения только в те чаты, в которых он состоит.


Ошибки форм

Форма не открывается

Причина: trigger_id из события button_pressed действителен только 3 секунды. Если между получением вебхука и вызовом POSTОткрытие представления проходит больше времени — форма не откроется.

Решение:

  1. Убедитесь, что узел Form > Create стоит сразу после триггера, без долгих операций между ними
  2. Не используйте узел Wait между получением trigger_id и открытием формы
  3. Если нужна дополнительная логика — выполняйте её после отправки формы, а не до

Подробнее о формах — в документации форм.


Ошибки пагинации

Возвращаются не все данные

Причина: API возвращает данные постранично. Если Return All выключен, вы получаете только первую страницу (по умолчанию до 50 записей).

Решение:

  1. Включите Return All = true в настройках узла — n8n автоматически пройдёт по всем страницам через cursor-based пагинацию
  2. Если нужен ограниченный набор — используйте Return All = false и укажите нужное число в поле Limit
  3. Для больших объёмов данных учитывайте лимиты API — при Return All n8n делает несколько запросов последовательно

Общие практики тестирования и отладки — Retry On Fail, Error Trigger workflow, Execute Step, проверка Credentials — собраны в разделе Тестирование.