🔍

Руководство по боту ПСО

Инструкция для волонтёров, координаторов и руководства

🙋 Волонтёр

Как участвовать в поиске

Пошаговая инструкция — от вступления в чат до закрытия своей задачи. Всё управление происходит прямо в чате поиска.

Шаг 1 — Войти в чат поиска
1

Вступите в чат поиска

Когда вас добавляют в чат — бот приветствует вас и показывает кнопки выбора роли. Если кнопки не появились — напишите /role.

2

Выберите роль

🚗 Выезд — вы едете на место поиска физически.

💻 Удалёнка — работаете дистанционно: прозвон, разбор карт, районы.

Кнопки придут в ваши личные сообщения с ботом. Нажмите нужную.

Шаг 2 — Взять район или задачу
1

Откройте закреплённое сообщение

В чате поиска сверху закреплено сообщение со списком районов и задач — нажмите на него.

2

Выберите строку и процитируйте

Удерживайте нужную строку с районом → выберите «Цитировать» (или «Ответить» на всё сообщение целиком).

3

Напишите «беру»

Отправьте слово беру в ответ на цитату. Бот закрепит район или задачу за вами и обновит закреп.

Также понимает: возьму, взял, взяла, беру эти, беру район и другие варианты.

💡 Районы доступны только для роли «Удалёнка». Задачи может брать любой волонтёр.
Шаг 3 — Закрыть район или задачу
1

Ответьте «закрыто» на своё сообщение «беру»

Найдите в чате своё сообщение где писали «беру», нажмите «Ответить» и отправьте закрыто.

Также: готово, сделано, закончил, закончила, выполнено и др.

2

Закреп обновится автоматически

Бот снимет отметку «в работе» с ваших районов/задач. Они снова станут доступны другим.

Команды волонтёра
беру
Взять район или задачу. Отправляется ответом на цитату из закрепа. Работают варианты: «возьму», «взял», «взяла», «беру эти» и т.п.
закрыто
Закрыть свой район или задачу. Ответом на своё же «беру». Варианты: «готово», «сделано», «закончил», «выполнено» и т.п.
/role
Выбрать или сменить роль. Пришлёт кнопки в личные сообщения с ботом. Используйте если хотите поменять «Выезд» на «Удалёнку» или наоборот.
/get_route
Маршрут до штаба. Бот пришлёт кнопку в ЛС — нажмите, чтобы перейти и отправить свою геолокацию. В ответ получите маршруты в Яндекс.Картах и Google Maps.
дежурные
Кто сегодня дежурит. Напишите слово «дежурные» в любом чате — бот покажет оператора и координатора на сегодня с телефонами.
псо регионы
Найти ПСО по региону. Напишите «псо регионы» — бот спросит название региона и выдаст контакты всех организаций в нём.
график
Ваши дежурства. В личных сообщениях с ботом — покажет ваш график дежурств на ближайшее время.
/help
Справка. Список доступных команд с кратким описанием.
Дежурства
!

В 22:00 приходит оповещение о смене

Если вы сегодня дежурный — в чате дежурных появится сообщение с кнопками ✅ Заступил и ❌ Не могу.

!

Нажмите «✅ Заступил»

Это подтвердит вашу смену. Если другой дежурный ещё не подтвердил — бот напомнит вам связаться с ним.

!

Если не можете выйти — нажмите «❌ Не могу»

Бот сообщит что нужна замена. Кто готов заменить — пишет поменяться в ответ на то сообщение.

🎯 Координатор

Управление поиском

Координатор запускает и ведёт поиск: создаёт операцию, управляет районами и задачами, рассылает информацию, завершает поиск.

Подготовка к поиску
1

Добавьте бота в группу поиска как администратора

Управление группой → Администраторы → Добавить бота. Дайте все права кроме «Анонимности».

2

Откройте историю чата

Управление группой → История чата → «Видима для новых участников». Без этого вступившие не увидят закреп.

3

Включите нужные роли

/field — включить/выключить кнопку «Выезд».

/remote — включить/выключить кнопку «Удалёнка».

По умолчанию обе включены после запуска поиска.

Запуск поиска
1

Напишите /search в чате поиска

Бот попросит ввести вводную информацию: ФИО ребёнка, возраст, приметы, последнее место.

2

Отправьте описание одним сообщением

Бот автоматически опубликует его в инфоканал и рабочую группу с кнопкой «Откликнуться», создаст закреп в чате поиска.

3

Добавьте районы и задачи в закреп

Используйте /set_districts для списка районов и /add_tasks для задач — они появятся в закреплённом сообщении.

Управление районами
/set_districts
Задать список районов. Бот спросит список — каждый район с новой строки. Заменяет текущий список полностью.
/add_districts
Добавить районы к существующим. Не удаляет текущие — дописывает новые в конец закрепа.
/del_districts
Удалить районы. Бот спросит какие удалить — перечислите их по одному на строке.
Управление задачами
/add_tasks
Добавить задачи. Бот спросит список задач — каждая с новой строки. Добавляются к существующим.
/update_tasks
Обновить весь список задач. Заменяет все задачи целиком новым списком.
/edit_task
Изменить одну задачу. Процитируйте строку с задачей из закрепа → напишите /edit_task → отправьте новый текст задачи.
Управление командой
/add_coord
Назначить координатора. Ответьте на сообщение человека командой /add_coord — он получит права координатора в этом поиске.
/remove_coord
Снять координатора. Ответом на сообщение пользователя.
/transfer
Передать координаторство. Ответом на сообщение — передаёт ваши права другому и снимает с вас.
/add_inforg
Назначить инфорга. Права как у координатора, кроме управления другими координаторами.
/remove_inforg
Снять инфорга. Ответом на сообщение пользователя.
/field
Вкл/выкл кнопку «Выезд». Переключает доступность этой роли для волонтёров.
/remote
Вкл/выкл кнопку «Удалёнка». Переключает доступность этой роли для волонтёров.
Информирование и завершение
/new_info
Новая информация по поиску. Рассылает текст (или фото с подписью) в инфоканал и рабочую группу с кнопкой «Откликнуться».
/close
Завершить поиск. Удаляет все данные поиска из системы. Группа и история сообщений сохраняются.
⚠️ /close необратима. Все данные о районах, задачах и волонтёрах будут удалены из базы. Используйте только когда поиск действительно завершён.
👑 Старший координатор / Директор

Управление организацией

Доступ к административным функциям: управление базой волонтёров, рассылки, дежурства. Большинство команд работают в личных сообщениях с ботом.

Где работают команды
📱 Все административные команды ниже работают только в личных сообщениях с ботом (ЛС). Исключение — рассылка, которая доступна также из чата поиска.
База волонтёров
добавить волонтера
Добавить нового участника. Напишите фразу — бот запросит данные в формате:
@username, Иванов Иван Иванович, +79001234567
Если у человека нет username — используйте id_XXXXX (Telegram ID).
удалить волонтера
Удалить участника из базы. Бот спросит username — введите его без @. Удаление из базы не удаляет человека из групп.
обновить данные волонтера
Изменить ФИО или телефон. Найдите по @username, ФИО или телефону — бот покажет карточку и спросит новые данные. Чтобы не менять username — поставьте - на его месте.
список волонтеров
Полный список участников. Выводит всех с @username, ФИО, телефоном и ролью.
Рассылки и информирование
сделать рассылку
Рассылка в инфоканал и рабочую группу. Бот попросит текст — можно отправить фото с подписью. Работает из ЛС и из чата поиска.
/info
Альтернативная команда для рассылки. Аналог «сделать рассылку» — на выбор.
Дежурства
!

График синхронизируется из Google Sheets

Каждые 4 часа бот скачивает актуальный XLSX и обновляет расписание дежурств. Таблица должна быть открыта «для всех по ссылке».

!

В 22:00 МСК — автоматическое оповещение

Бот отправляет два сообщения в чат дежурных: для оператора и для координатора. Если не подтвердили до 22:30 МСК — продолжаются «тревожные» напоминания каждые 10 минут.

!

Обновить график вручную

Напишите обновить график в ЛС с ботом — немедленно скачает актуальный файл из Google Sheets.

!

Посмотреть своё расписание

Напишите график в ЛС с ботом — покажет ваши дежурства на ближайшее время.

🔄 Замена дежурных работает через поменяться в чате дежурных — ответом на сообщение об отказе. Замена сохраняется в базе и не меняет Google Sheets.
Сборы в штабе
сбор в штабе ДД.ММ.ГГГГ ЧЧ:ММ
Объявить сбор. Напишите фразу с датой и временем, например:
сбор в штабе 15.08.2025 19:30
Бот опубликует объявление и пришлёт напоминание за 2 часа.
Только для Директора
поменять должность
Изменить роль волонтёра в базе. Найдите по username/ФИО — бот покажет карточку. Доступные должности: директор, старший координатор, волонтер.
⚠️ Роль в базе определяет права в боте (кто может запускать поиски, делать рассылки). Не путать с ролью в поиске (Выезд/Удалёнка).
Полезные команды из ЛС
псо регионы
Найти ПСО в регионе. Напишите название или часть — бот выдаст список организаций с контактами.
дежурные
Кто дежурит сегодня. Работает в любом чате — показывает оператора и координатора с телефонами.
/help
Полный список команд. В ЛС показывает расширенный список для вашей роли.