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

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

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 (доступен администраторам и владельцам)
Отправка сообщений, чаты, задачиmessages:write, chats:write, tasks:write

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

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

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. Bot ID не указан — при отсутствии Bot ID в Credentials авторегистрация не работает. Укажите Bot ID или настройте вебхук вручную
  4. n8n недоступен извне — при локальной установке Пачка не может отправить вебхук на localhost. Используйте туннель (ngrok, Cloudflare Tunnel) или разверните n8n на сервере с публичным IP

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

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

Решение: скопируйте Signing Secret из настроек бота в Пачке (вкладка API) и вставьте в 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 делает несколько запросов последовательно

Общие рекомендации

  1. Включите Retry On Fail в настройках узла (Settings → Retry On Fail) для автоматического повтора при временных ошибках
  2. Используйте Error Trigger для обработки ошибок в отдельном workflow — отправляйте уведомление об ошибке в специальный канал
  3. Проверяйте Credentials кнопкой Test перед запуском workflow
  4. Используйте Execute Step для отладки узлов по одному, не запуская весь workflow