# MAX Bot

Ошибки при подключении, настройке и отправке сообщений через MAX Bot.

## Ошибки отправки сообщений

***

### `MAX_SEND_MESSAGE_UNKNOWN` — неизвестная ошибка MAX Bot

**Описание:** Неизвестная ошибка при отправке сообщения в MAX Bot, обратитесь в техподдержку Nextbot для уточнения причины

**Причина:** Ошибка не распознана.

**Решение:** Обратитесь в техподдержку Nextbot с кодом и деталями.

***

### `MAX_SEND_MESSAGE_423` — ссылка на изображение некорректна или устарела

**Описание:** Не удалось отправить сообщение в MAX Bot, ссылка на изображение некорректна или устарела

**Причина:** URL изображения недействителен или недоступен.

**Решение:** Проверьте ссылку на изображение. Убедитесь, что файл доступен.

## Ошибки подключения и токена

***

### `MAX_BOT_ACCESS_TOKEN_MISSING` — не задан Access Token

**Описание:** Токен доступа MAX Bot не задан. Укажите `access_token` в настройках подключения MAX Bot

**Причина:** В настройках подключения не заполнен `Access Token`.

**Решение:** Откройте настройки интеграции `MAX Bot`, укажите корректный `Access Token` и сохраните подключение.

***

### `MAX_BOT_PROPERTIES_NOT_FOUND` — настройки MAX Bot не найдены

**Описание:** Настройки MAX Bot не найдены для агента. Подключите MAX Bot в разделе интеграций

**Причина:** Для выбранного агента не настроено подключение `MAX Bot`.

**Решение:** Перейдите в раздел интеграций и подключите `MAX Bot` для нужного агента.

***

### `PLATFORM_HANDLER_MAX_BOT_PROPERTIES_NOT_FOUND` — настройки MAX Bot не найдены

**Описание:** Настройки MAX Bot не найдены для агента. Подключите MAX Bot в разделе интеграций

**Причина:** Обработчик сообщений не нашёл активные настройки `MAX Bot` для агента.

**Решение:** Подключите `MAX Bot` в разделе интеграций и убедитесь, что он настроен именно для нужного агента.

***

### `MAX_BOT_WEBHOOK_BASE_URL_MISSING` — не задан базовый URL вебхука

**Описание:** Не задан базовый URL для вебхука MAX Bot. Обратитесь в техподдержку Nextbot

**Причина:** Системный URL для webhook `MAX Bot` не настроен.

**Решение:** Обратитесь в техподдержку Nextbot.

***

### `MAX_BOT_WEBHOOK_BASE_URL_NOT_HTTPS` — webhook должен использовать HTTPS

**Описание:** Базовый URL для вебхука MAX Bot должен использовать протокол HTTPS. Обратитесь в техподдержку Nextbot

**Причина:** Адрес webhook настроен без `HTTPS`.

**Решение:** Обратитесь в техподдержку Nextbot для настройки защищённого webhook URL.

## Ошибки получателя

***

### `MAX_BOT_RECIPIENT_MISSING` — не указан получатель сообщения

**Описание:** Не указан получатель сообщения (`chat_id` или `user_id`). Невозможно определить, кому отправить сообщение

**Причина:** В запросе отсутствует идентификатор получателя.

**Решение:** Проверьте настройки отправки и убедитесь, что передаётся `chat_id` или `user_id`.

***

### `SEND_MAX_CHAT_ID_MISSING` — не найден chatId

**Описание:** Не найден идентификатор чата (`chatId`) для отправки сообщения в MAX Bot

**Причина:** Для текущего диалога или получателя не сохранён `chatId`.

**Решение:** Убедитесь, что пользователь или группа уже взаимодействовали с `MAX Bot` и получатель был корректно привязан.

## Ошибки загрузки файлов

***

### `MAX_BOT_UPLOAD_URL_MISSING` — не получен URL для загрузки файла

**Описание:** Не удалось получить URL для загрузки файла от API MAX Bot. Попробуйте повторить попытку позже

**Причина:** API `MAX Bot` не вернул ссылку для загрузки файла.

**Решение:** Повторите попытку позже. Если ошибка сохраняется, обратитесь в техподдержку Nextbot.

***

### `MAX_BOT_UPLOAD_PAYLOAD_EMPTY` — пустой результат после загрузки файла

**Описание:** Файл был загружен, но API MAX Bot вернул пустой результат. Попробуйте повторить попытку или используйте другой файл

**Причина:** API `MAX Bot` не вернул данные о загруженном файле.

**Решение:** Повторите попытку отправки или используйте другой файл.

***

### `SEND_MAX_FILE_MISSING` — файл для отправки не найден

**Описание:** Файл для отправки не найден. Проверьте корректность ссылки на файл

**Причина:** Ссылка на файл недействительна, устарела или файл удалён.

**Решение:** Проверьте ссылку на файл и убедитесь, что файл доступен.

## Ошибки API MAX Bot

***

### `MAX_BOT_ATTACHMENT_NOT_READY` — вложение ещё не готово

**Описание:** Вложение ещё не обработано сервером MAX Bot. Система автоматически выполнит повторную попытку отправки

**Причина:** Сервер `MAX Bot` ещё не завершил обработку вложения.

**Решение:** Подождите, пока система выполнит повторную попытку автоматически. Если ошибка повторяется, попробуйте отправить файл ещё раз позже.

***

### `MAX_BOT_CHAT_NOT_FOUND` — чат или диалог не найден

**Описание:** Чат или диалог не найден в MAX Bot. Возможно, пользователь удалил чат или бот был исключён из группы

**Причина:** Чат удалён, бот исключён из группы или идентификатор чата больше недействителен.

**Решение:** Проверьте, что чат существует, а `MAX Bot` добавлен в него и имеет доступ к переписке.

## Ошибки сервиса

***

### `MAX_API_SERVICE_METHOD_FAILED` — ошибка запроса к API MAX Bot

**Описание:** Произошла ошибка при выполнении запроса к API MAX Bot. Обратитесь в техподдержку Nextbot, если проблема сохраняется

**Причина:** Запрос к API `MAX Bot` завершился с ошибкой.

**Решение:** Повторите попытку позже. Если проблема сохраняется, обратитесь в техподдержку Nextbot.

***

### `MESSAGE_SENDER_MAXAPI_PROPERTIES_MISSING` — настройки MAX Bot не найдены

**Описание:** Настройки MAX Bot не найдены для агента. Проверьте, что MAX Bot подключён в разделе интеграций

**Причина:** Сервис отправки не нашёл настройки `MAX Bot` для текущего агента.

**Решение:** Проверьте, что `MAX Bot` подключён в разделе интеграций и настроен для нужного агента.

## Ошибки обработки входящих сообщений

***

### `MAX_HANDLER_GROUP_NOT_ALLOWED` — работа в группах отключена

**Описание:** Агент не настроен для работы в групповых чатах MAX Bot. Включите поддержку групп в настройках интеграции MAX Bot

**Причина:** В настройках `MAX Bot` отключена работа в групповых чатах.

**Решение:** Включите поддержку групповых чатов в настройках интеграции `MAX Bot`.

***

### `MAX_BOT_ADMIN_RIGHTS_UPDATE_FAILED` — не удалось обновить права администратора

**Описание:** Не удалось обновить права администратора для бота MAX Bot. Попробуйте ввести пароль администратора повторно

**Причина:** Не удалось подтвердить или обновить права администратора по введённому паролю.

**Решение:** Повторно задайте одноразовый пароль администратора и отправьте его `MAX Bot` ещё раз.

***

### `PLATFORM_HANDLER_MAX_BOT_ADMIN_RIGHTS_UPDATE_FAILED` — не удалось обновить права администратора

**Описание:** Не удалось обновить права администратора MAX Bot. Попробуйте ввести пароль администратора повторно

**Причина:** Обработчик `MAX Bot` не смог обновить права администратора.

**Решение:** Повторно задайте одноразовый пароль администратора и введите его ещё раз.

***

### `PLATFORM_HANDLER_MAX_ADMIN_RIGHTS_UPDATE_FAILED` — ошибка обновления настроек администрирования

**Описание:** Ошибка при обновлении настроек администрирования MAX Bot. Обратитесь в техподдержку Nextbot

**Причина:** При обновлении настроек администрирования `MAX Bot` произошёл внутренний сбой.

**Решение:** Повторите попытку позже. Если ошибка сохраняется, обратитесь в техподдержку Nextbot.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/questions-answers/errors-description/channels/max-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
