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

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

### 401 Unauthorized — неверный токен

![Ошибка 401 при неверном токене](/images/n8n/error-invalid-token.avif)

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


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

**Решение:**

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

### 403 Forbidden — недостаточно прав

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

**Решение:**

Доступ к операциям определяется [скоупами](/api/authorization#skoupy) токена, а не его типом. Убедитесь, что ваш токен включает нужные скоупы:

| Операция | Требуемые скоупы |
|----------|-----------------|
| Управление сотрудниками (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` |

Подробнее — в разделе [Авторизация](/api/authorization).

---

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

### 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 /views/open) проходит больше времени — форма не откроется.

**Решение:**

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

Подробнее о формах — в [документации форм](/guides/forms/overview).

---

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

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

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

**Решение:**

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

---

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

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