> ## Documentation Index
> Fetch the complete documentation index at: https://mavrodi.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Устранение распространённых проблем в InviteBot

> Пошаговые решения распространённых проблем с Telegram-ботом InviteBot, Интентами, Запросами на помощь, Поручениями, реквизитами и балансом MAVRO.

Это руководство поможет вам разобраться с самыми частыми проблемами, с которыми сталкиваются участники, и как их решить. Если ничего из приведённого ниже не помогает, см. раздел [Получение помощи](#getting-help) внизу страницы — там описано, как обратиться к Наставнику или в поддержку.

## Проблемы с ботом

### Бот не отвечает на команды

<Steps>
  <Step title="Проверьте интернет-соединение">
    Убедитесь, что устройство подключено к сети. Попробуйте открыть веб-страницу или другое приложение для проверки.
  </Step>

  <Step title="Перезапустите Telegram">
    Полностью закройте Telegram и откройте его снова, затем повторите команду.
  </Step>

  <Step title="Подождите несколько минут">
    Иногда бот может быть недоступен из-за обслуживания. Подождите 2–5 минут и попробуйте снова.
  </Step>

  <Step title="Свяжитесь с поддержкой, если проблема не уходит">
    Если бот всё ещё не отвечает спустя несколько минут, используйте `/support`, чтобы сообщить о проблеме в техподдержку.
  </Step>
</Steps>

***

### Команды возвращают ошибки

<Steps>
  <Step title="Проверьте написание команды">
    Команды чувствительны к регистру и должны начинаться с `/`. Сверьтесь со [справочником команд](/participants/commands), чтобы убедиться в правильном написании.
  </Step>

  <Step title="Проверьте статус аккаунта и разрешения">
    Некоторые команды доступны только участникам с определёнными статусами или после выполнения определённых действий (например, для создания Запроса на помощь сначала нужен подтверждённый Поручением Перевод).
  </Step>

  <Step title="Попробуйте через несколько минут">
    Временные сбои иногда проходят сами. Подождите немного и повторите.
  </Step>

  <Step title="Свяжитесь с поддержкой, если ошибка повторяется">
    Если та же ошибка появляется снова, обратитесь в поддержку командой `/support` и укажите команду, которую вы использовали, и текст ошибки.
  </Step>
</Steps>

***

### Пропали кнопки клавиатуры

Отправьте боту `/start`. Эта команда восстанавливает основную клавиатуру со всеми стандартными кнопками действий.

***

### Не приходят уведомления о Поручениях

<Steps>
  <Step title="Проверьте настройки уведомлений Telegram">
    Откройте настройки Telegram и убедитесь, что уведомления для чата с ботом включены.
  </Step>

  <Step title="Убедитесь, что вы не заблокировали бота">
    Если вы заблокировали бота в Telegram, он не сможет отправлять вам сообщения. Разблокируйте его в контактах или настройках чата.
  </Step>

  <Step title="Проверьте, что ваши Интенты активны">
    Поручения выпускаются только по активным Интентам. Командой `/intents` убедитесь, что у вас есть хотя бы один Интент в статусе **Активный**.
  </Step>

  <Step title="Попросите Наставника проверить ваш статус">
    Наставник может убедиться, что ваш аккаунт корректно настроен для получения Поручений.
  </Step>
</Steps>

***

## Интенты и Запросы

### Не получается создать Запрос на помощь

Бот может блокировать создание нового Запроса на помощь по нескольким причинам:

<Steps>
  <Step title="Проверьте, что вы выполнили хотя бы одно Поручение">
    Для стандартного Запроса вы должны сначала оказать помощь — то есть хотя бы одно Поручение по вашим Интентам должно быть выполнено и подтверждено.
  </Step>

  <Step title="Проверьте, что у вас есть активные реквизиты">
    На счёте должен быть хотя бы один активный способ оплаты. Просмотрите реквизиты командой `/accounts`. Если активных нет, добавьте новый командой `/account_add`.
  </Step>

  <Step title="Проверьте, нет ли уже активного Запроса">
    Одновременно разрешён только один активный Запрос на помощь. Проверьте командой `/asks`. Если активный Запрос ещё есть, дождитесь его завершения, прежде чем создавать новый.
  </Step>
</Steps>

***

### Запрос на помощь больше 3 дней в статусе «Новый»

Свяжитесь с Наставником напрямую. Новые Запросы рассматривает он, и если прошло более 3 дней без решения, сообщение ему — правильный следующий шаг. Найдите контакт Наставника командой `/start`.

***

### Интент не одобрен 3 и более дней

Напишите Наставнику. Он рассматривает Интенты и подскажет, ожидает ли решение или нужны изменения перед одобрением.

***

## Поручения

### Перевёл деньги, но не нахожу кнопку «Перевод выполнен»

Используйте команду прямого открытия Поручения:

```
/o_12345
```

Замените `12345` на фактический номер вашего Поручения. Откроется карточка с кнопками действий, включая **«Перевод выполнен»**.

***

### Получатель не подтверждает поступление

<Steps>
  <Step title="Сохраните подтверждение перевода">
    Сделайте скриншот завершённого перевода и зафиксируйте номер транзакции. Сохраните эти доказательства — они могут понадобиться позже.
  </Step>

  <Step title="Свяжитесь с Наставником">
    Обратитесь к Наставнику и сообщите номер Поручения и доказательства перевода. Наставник свяжется с получателем и выступит посредником.
  </Step>

  <Step title="Дайте время на эскалацию">
    Если получатель и после вмешательства Наставника не подтверждает, Наставник может передать спор дальше внутри системы.
  </Step>
</Steps>

<Warning>
  Не отмечайте перевод как неуспешный и не пытайтесь отозвать его самостоятельно. При неподтверждении со стороны получателя всегда действуйте через Наставника.
</Warning>

***

## Реквизиты

### `/account_add` не работает

Следуйте подсказкам бота пошагово — команда интерактивная и ожидает ответа на каждый вопрос по очереди. Внимательно читайте каждое сообщение и отвечайте запрошенной информацией (тип оплаты, номер карты или адрес кошелька и т. д.). Если пропустить шаг или отправить неожиданный ответ, начните процесс заново командой `/account_add`.

***

### Введён неверный номер карты

Сохранённый реквизит нельзя редактировать напрямую. Чтобы исправить ошибку:

<Steps>
  <Step title="Добавьте правильные реквизиты">
    Используйте `/account_add`, чтобы добавить правильный номер карты или другие реквизиты.
  </Step>

  <Step title="Попросите Наставника деактивировать старую запись">
    Свяжитесь с Наставником и попросите его деактивировать неверную запись. Это предотвратит случайное использование неверных реквизитов отправителями.
  </Step>
</Steps>

***

## MAVRO и баланс

### `/balance` ничего не показывает

Команда `/balance` доступна только в **проектах с режимом MAVRO**. Если вы в таком проекте, а баланс пуст:

* Подождите немного и попробуйте `/balance` снова — данные могут подгружаться.
* Если баланс остаётся пустым, обратитесь к Наставнику, чтобы убедиться, что аккаунт корректно настроен для учёта MAVRO в этом проекте.

***

### Не получается конвертировать MAVRO

Если кнопка **КОНВЕРТИРОВАТЬ** не появляется на позиции или конвертация заблокирована, проверьте:

* **Позиция в резерве** — это значит, что MAVRO привязан к активному Запросу на помощь. Дождитесь, пока Запрос будет завершён или отменён, и MAVRO снова станет доступным.
* **Позиция заморожена** — замороженный MAVRO нельзя конвертировать. Уточните у Наставника, когда заморозка будет снята.

***

## Получение помощи

Если ничего из вышеперечисленного не помогло, используйте следующий маршрут эскалации:

| Контакт                                    | Когда использовать                                     |
| ------------------------------------------ | ------------------------------------------------------ |
| **Ваш Наставник** — контакт через `/start` | Первая линия по любым вопросам процесса или аккаунта   |
| `/lost`                                    | Если Наставник не отвечает **3 и более дней**          |
| `/100`                                     | Эскалация к Сотнику, если до Наставника не дозвониться |
| `/support`                                 | Технические проблемы с ботом или веб-кабинетом         |

<Note>
  Наставник занимается большинством вопросов по Интентам, Запросам, Поручениям и статусу аккаунта. Техподдержка (`/support`) — для ошибок и технических сбоев бота.
</Note>