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

# Керування учасниками в структурі Наставника

> Дізнайтеся, як переглядати, редагувати, переводити учасників і спілкуватися з ними — від розгляду Запитів до керування записами для довнесення даних.

Ваша структура — це група учасників, за яких ви відповідаєте. Добре нею керувати — означає тримати в полі зору очікувані Інтенти та Запити, підтримувати точність даних учасників і бути на звʼязку, коли комусь із групи потрібна допомога. На цій сторінці — команди, якими ви користуєтеся найчастіше у щоденній роботі.

## Перегляд учасників

Почніть із розуміння того, хто входить у структуру і в якому стані.

| Команда          | Що повертає                         |
| ---------------- | ----------------------------------- |
| `/users`         | Активні учасники структури          |
| `/users_all`     | Усі учасники, включно з неактивними |
| `/users_blocked` | Учасники зі статусом «заблокований» |

Використовуйте `/users_all`, щоб знайти того, хто пропав, або оцінити повний розмір групи.

## Розгляд Інтентів

Коли учасник групи надсилає Інтент — заявку на передачу певної суми — він потрапляє у вашу чергу на схвалення.

```text theme={null}
/intents @username
/intents TGID
```

Працюють обидві форми: можна використовувати Telegram-імʼя користувача або числовий Telegram ID. Команда повертає всі Інтенти учасника з їхніми поточними статусами (Новий, Активний, Частково підтверджений, Повністю підтверджений, Відхилений, Скасований).

<Note>
  Ви можете зустріти чотири типи Інтентів: стандартний (`intent`), бонусний (`bonus`), передавальний (`passon`) і системний (`system`). Стандартні Інтенти створюють учасники. Бонусні та передавальні створюють Наставники. Системні Інтенти створюють лише Тисячники та адміністратори.
</Note>

## Розгляд Запитів на допомогу

Запити (Asks) від членів групи потребують вашого схвалення, перш ніж система почне їх обробляти. Скористайтеся `/asks`, щоб побачити чергу.

<Tabs>
  <Tab title="Ваша перша лінія">
    ```text theme={null}
    /asks
    ```

    Показує очікувані Запити від учасників безпосередньо у вашій (першій) лінії. Це ваша основна черга на розгляд.
  </Tab>

  <Tab title="Конкретний учасник">
    ```text theme={null}
    /asks @username
    ```

    Показує всі Запити одного учасника — корисно при спостереженні за конкретною ситуацією.
  </Tab>

  <Tab title="Уся структура">
    ```text theme={null}
    /asks structure
    ```

    Показує очікувані Запити по всій структурі, включно з учасниками під суб-Наставниками в ієрархії.
  </Tab>

  <Tab title="Особисті запити">
    ```text theme={null}
    /asks_my @username
    ```

    Показує Запити, які особисто належать учаснику (на відміну від запитів, видимих за структурною відповідальністю). Використовуйте при перегляді власної фінансової активності учасника.
  </Tab>
</Tabs>

### Установлення пріоритету Запиту

Для системних Запитів можна налаштувати пріоритет обробки (0–9, вище — раніше):

```text theme={null}
/ask_1234567_priority_5
```

Можна викликати `/ask_1234567_priority` без числа — бот сам запропонує його ввести.

## Перегляд Доручень

Доручення повʼязують Інтенти із Запитами та представляють фактичний переказ між учасниками.

```text theme={null}
/orders @username   — Доручення за участю конкретної людини
/orders my          — Доручення, за які відповідаєте ви як Наставник
```

Детальний опис кожного статусу Доручення й доступних дій — на сторінці [Життєвий цикл Доручення](/guiders/order-lifecycle).

## Переведення учасників між структурами

Якщо учасника потрібно перевести в іншу структуру — бо він переїхав, його Наставник недоступний або з інших причин — скористайтеся командою `/move`. Вона запускає інтерактивний процес, у якому вказуються учасник і цільова структура.

```text theme={null}
/move
```

<Warning>
  Переведення учасника передає всі його очікувані Інтенти й Запити у чергу розгляду нового Наставника. Перед переведенням узгодьте дію з приймаючим Наставником.
</Warning>

## Редагування даних учасника

Іноді потрібно оновити чи поправити дані від імені учасника.

| Команда  | Що редагує                                                                                 |
| -------- | ------------------------------------------------------------------------------------------ |
| `/set`   | Універсальний редактор полів — інтерактивне меню для правки будь-якого підтримуваного поля |
| `/name`  | Відображуване імʼя                                                                         |
| `/email` | Email-адреса                                                                               |
| `/phone` | Номер телефону                                                                             |
| `/about` | Короткий опис профілю                                                                      |
| `/card`  | Додати або оновити платіжну картку від імені учасника                                      |
| `/stage` | Змінити поточну стадію сценарію онбордингу учасника                                        |

Використовуйте `/set`, якщо не впевнені, яка команда потрібна — він охоплює всі редаговані поля в одному місці.

## Керування статусами

Щоб змінити статус учасника (наприклад, підвищити або заблокувати проблемний акаунт), скористайтеся:

```text theme={null}
/status
```

Команда відкриває інтерактивний процес. Зміни статусу набирають чинності негайно й впливають на те, що учасник може робити в системі.

## Спілкування з учасниками

```text theme={null}
/send
```

Надсилає повідомлення одному або кільком учасникам структури. Використовуйте для важливих оновлень або коли потрібно достукатися до когось напряму через бота.

```text theme={null}
/admin
```

Надсилає повідомлення адміністратору. Використовуйте, якщо питання виходить за межі вашої компетенції як Наставника.

```text theme={null}
/report
```

Надсилає звіт-зворотний звʼязок. Див. також `/tickets_add_report` нижче — для винагороди учасників, які надіслали відеовідгук.

## Звʼязок з учасниками в Telegram

Щоб підтвердити або керувати звʼязком між вашим Наставницьким акаунтом і акаунтом учасника в боті:

```text theme={null}
/connected_userid    — Підтвердити звʼязок Наставник↔Учасник у Telegram
/disconnect_userid   — Розірвати звʼязок між вашим акаунтом і учасником
```

Ці команди корисні, коли учасник змінив пристрій або Telegram-акаунт.

## Керування інвайт-кодами

Структура зростає, коли нові учасники приходять за вашими інвайт-посиланнями. Щоб створити додаткові інвайт-коди для групи:

```text theme={null}
/invite
```

## Робота з втраченим звʼязком

Якщо учасник не відповідає і здається недоступним, його можна позначити як втраченого. Для відстеження таких випадків використовуйте:

```text theme={null}
/losts          — Список заявок `/lost`, поданих вами або повʼязаних з вашими учасниками
/losts_all      — Усі нерозвʼязані заявки `/lost` по всій структурі
```

## Привітальне повідомлення для новачків

Повідомлення, яке отримують нові учасники у вашій структурі, можна налаштувати:

```text theme={null}
/intro           — Установити текст привітання
/intro_delay     — Установити затримку (в секундах) перед надсиланням привітання
```

<Tip>
  Гарне привітання задає очікування: що учаснику робити в першу чергу, як з вами звʼязатися та що робить система. Робіть його коротким і орієнтованим на дію.
</Tip>

## Чат-журнал

```text theme={null}
/set_chatlog
```

Підключає приватну Telegram-групу або чат як ваш особистий журнал активності. Після встановлення бот пересилає туди сповіщення про дії вашої структури, щоб у вас був пошуковий запис схвалень, відхилень і змін статусів.

## Перевірка фінансового підсумку учасника

```text theme={null}
/outcome
```

Показує, чи перебуває учасник у позитивній фінансовій позиції (віддав більше, ніж отримав), у негативній, чи взагалі нічого не передавав. Використовуйте при оцінці обґрунтованості Запиту з урахуванням історії.

## Заохочення відеовідгуків

Якщо учасник надсилає відеовідгук про свій досвід, можна видати йому 2 Білетики як винагороду:

```text theme={null}
/tickets_add_report
```

## Довнесення даних (backfill)

Якщо Інтенти чи Запити створювалися/виконувалися поза ботом (наприклад, у раніший період або вручну), їх можна внести в систему заднім числом:

```text theme={null}
/ia
```

Команда `/ia` відкриває інтерактивний процес довнесення записів Інтентів та Запитів. Використовуйте її лише тоді, коли у вас є підтверджена інформація — а не як обхід для поточних операцій.

## Способи оплати

Щоб переглядати або додавати способи оплати (банки чи криптосервіси), повʼязані зі структурою:

```text theme={null}
/banks       — Перегляд доступних способів оплати
/bank_add    — Додати новий спосіб оплати
```