Перейти до основного вмісту

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, щоб знайти того, хто пропав, або оцінити повний розмір групи.

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

Коли учасник групи надсилає Інтент — заявку на передачу певної суми — він потрапляє у вашу чергу на схвалення.
/intents @username
/intents TGID
Працюють обидві форми: можна використовувати Telegram-імʼя користувача або числовий Telegram ID. Команда повертає всі Інтенти учасника з їхніми поточними статусами (Новий, Активний, Частково підтверджений, Повністю підтверджений, Відхилений, Скасований).
Ви можете зустріти чотири типи Інтентів: стандартний (intent), бонусний (bonus), передавальний (passon) і системний (system). Стандартні Інтенти створюють учасники. Бонусні та передавальні створюють Наставники. Системні Інтенти створюють лише Тисячники та адміністратори.

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

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

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

Для системних Запитів можна налаштувати пріоритет обробки (0–9, вище — раніше):
/ask_1234567_priority_5
Можна викликати /ask_1234567_priority без числа — бот сам запропонує його ввести.

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

Доручення повʼязують Інтенти із Запитами та представляють фактичний переказ між учасниками.
/orders @username   — Доручення за участю конкретної людини
/orders my          — Доручення, за які відповідаєте ви як Наставник
Детальний опис кожного статусу Доручення й доступних дій — на сторінці Життєвий цикл Доручення.

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

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

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

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

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

Щоб змінити статус учасника (наприклад, підвищити або заблокувати проблемний акаунт), скористайтеся:
/status
Команда відкриває інтерактивний процес. Зміни статусу набирають чинності негайно й впливають на те, що учасник може робити в системі.

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

/send
Надсилає повідомлення одному або кільком учасникам структури. Використовуйте для важливих оновлень або коли потрібно достукатися до когось напряму через бота.
/admin
Надсилає повідомлення адміністратору. Використовуйте, якщо питання виходить за межі вашої компетенції як Наставника.
/report
Надсилає звіт-зворотний звʼязок. Див. також /tickets_add_report нижче — для винагороди учасників, які надіслали відеовідгук.

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

Щоб підтвердити або керувати звʼязком між вашим Наставницьким акаунтом і акаунтом учасника в боті:
/connected_userid    — Підтвердити звʼязок Наставник↔Учасник у Telegram
/disconnect_userid   — Розірвати звʼязок між вашим акаунтом і учасником
Ці команди корисні, коли учасник змінив пристрій або Telegram-акаунт.

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

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

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

Якщо учасник не відповідає і здається недоступним, його можна позначити як втраченого. Для відстеження таких випадків використовуйте:
/losts          — Список заявок `/lost`, поданих вами або повʼязаних з вашими учасниками
/losts_all      — Усі нерозвʼязані заявки `/lost` по всій структурі

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

Повідомлення, яке отримують нові учасники у вашій структурі, можна налаштувати:
/intro           — Установити текст привітання
/intro_delay     — Установити затримку (в секундах) перед надсиланням привітання
Гарне привітання задає очікування: що учаснику робити в першу чергу, як з вами звʼязатися та що робить система. Робіть його коротким і орієнтованим на дію.

Чат-журнал

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

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

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

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

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

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

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

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

Щоб переглядати або додавати способи оплати (банки чи криптосервіси), повʼязані зі структурою:
/banks       — Перегляд доступних способів оплати
/bank_add    — Додати новий спосіб оплати