> ## 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>