Устранение ошибок
Установка расширения
Расширение не появляется в 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.
Решение:
- Откройте Credentials и проверьте значение Access Token
- Убедитесь, что токен скопирован целиком, без лишних пробелов
- Нажмите Test — при ошибке создайте новый токен в Пачке
- Для бот-токена: Настройки бота → вкладка API → скопируйте токен
- Для персонального токена: Автоматизации → Интеграции → API
Недостаточно прав (403 Forbidden)
Причина: операция требует более высокий уровень доступа, чем предоставляет текущий токен.
Решение:
Доступ к операциям определяется скоупами токена, а не его типом. Убедитесь, что ваш токен включает нужные скоупы:
| Операция | Требуемые скоупы |
|---|---|
| Управление сотрудниками (User > Create/Update/Delete) | users:write (доступен администраторам и владельцам) |
| Журнал безопасности (Security > Get Many) | audit_events:read (доступен администраторам и владельцам) |
| Управление тегами (Group Tag > Create/Update/Delete) | group_tags:write (доступен администраторам и владельцам) |
| Автоматическая регистрация вебхука в Pachca Trigger | bots:write |
| Отправка сообщений, чаты, задачи | messages:write, chats:write, tasks:write |
Подробнее — в разделе Авторизация.
403 Forbidden при активации Pachca Trigger
Причина: узел попытался автоматически прописать Webhook URL в настройках бота через PUTОбновление бота, но у персонального токена либо отсутствует скоуп bots:write, либо нет доступа редактора к указанному боту.
Текст ошибки:
Pachca rejected automatic webhook registration (403 Forbidden).
Решение:
- Откройте настройки бота в Пачке и убедитесь, что у пользователя, которому принадлежит персональный токен, стоит роль Редактор в списке доступов бота
- Проверьте, что у токена есть скоуп
bots:write(в настройках токена в Автоматизации → Интеграции → API) - Либо переключите 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 запросов/сек |
Решение:
- Добавьте узел Wait между операциями для замедления
- Используйте Batching в настройках узла Pachca (Additional Fields → Request Options → Batching)
- Для массовых операций используйте Return All =
falseс ограниченным Limit
Retry-After из ответа API.Ошибки триггера
Вебхук не приходит
Возможные причины и решения:
- Бот не добавлен в чат — бот получает события только из чатов, в которых он состоит. Добавьте бота в нужный канал
- Workflow не активирован — нажмите Activate в правом верхнем углу. Неактивные workflow не принимают вебхуки
- URL не прописан в настройках бота — в ручном режиме узел не трогает webhook-слот бота. Проверьте, что Production URL вставлен в поле Webhook URL в настройках бота (вкладка Исходящий Webhook). В автоматическом режиме убедитесь, что в узле указан корректный Bot ID
- 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Открытие представления проходит больше времени — форма не откроется.
Решение:
- Убедитесь, что узел Form > Create стоит сразу после триггера, без долгих операций между ними
- Не используйте узел Wait между получением
trigger_idи открытием формы - Если нужна дополнительная логика — выполняйте её после отправки формы, а не до
Подробнее о формах — в документации форм.
Ошибки пагинации
Возвращаются не все данные
Причина: API возвращает данные постранично. Если Return All выключен, вы получаете только первую страницу (по умолчанию до 50 записей).
Решение:
- Включите Return All =
trueв настройках узла — n8n автоматически пройдёт по всем страницам через cursor-based пагинацию - Если нужен ограниченный набор — используйте Return All =
falseи укажите нужное число в поле Limit - Для больших объёмов данных учитывайте лимиты API — при Return All n8n делает несколько запросов последовательно