Перед включением MusicFind
MusicFind лучше включать после базовой настройки группы: добавлен бот, понятны права админов, включены нужные функции безопасности и модерации.
Музыка — это слой вовлечения, а не замена антиспаму, антирейду или правилам чата. В фан-сообществе можно разрешить участникам искать треки свободно. В публичной группе, маркетплейсе или рабочем чате лучше ограничить публикацию, чтобы чат не утонул в аудио, повторных ссылках и ошибках провайдеров.
Настройки MusicFind хранятся отдельно для каждой Telegram-группы. У одного чата может быть свободный поиск и semi-open публикация, у другого — только admin-only режим.
Шаг 1. Выберите режим доступа
MusicFind поддерживает три практичных режима.
| Режим | Кто может искать | Кто может публиковать |
|---|---|---|
| Open | Все участники | Только админы |
| Semi-open | Все участники | Админы и участники из allowlist |
| Closed | Только админы | Только админы |
Для большинства сообществ лучше начинать с semi-open: участники могут искать музыку, но публиковать в чат могут только админы и доверенные участники.
Настройки MusicFind доступны админам. Обычные участники не должны менять режимы, провайдеров или allowlist.
Шаг 2. Ищите треки через команды
Для поиска используйте:
/поиск <запрос>
Например:
/поиск daft punk around the world
MusicFind нормализует запрос, проверяет включённых провайдеров, ждёт ответы с учётом таймаутов, ранжирует результаты, убирает похожие дубли и показывает короткий список.
В результате могут быть видны название, артист, длительность, провайдер и кнопки:
- Опубликовать
- Подробнее
- Открыть ссылку
- Отмена
Также доступны английские алиасы команд, если группа их использует: /search, /song, /post, /settings, /allow, /deny.
Шаг 3. Публикуйте аудио или ссылку
Для публикации используйте:
/пост <запрос>
или кнопку публикации в результатах поиска.
MusicFind сначала проверяет режим группы и права пользователя. Если публикация разрешена и у провайдера доступна authorized audio delivery, бот может отправить трек как Telegram-аудио. Если аудио недоступно или отправка не прошла, MusicFind может опубликовать ссылку.
Это нормальный fallback. MusicFind не должен незаметно переходить на scraping, неофициальные токены или сомнительные источники только потому, что трек нельзя отправить аудиофайлом.
Каждая публикация должна оставлять audit-friendly запись: кто опубликовал, какой трек, какой провайдер, был ли отправлен audio или link fallback.
Шаг 4. Настройте allowlist
Для просмотра и изменения настроек используйте:
/настройки
Чтобы разрешить доверенному участнику публиковать музыку в semi-open режиме:
/разрешить @username/разрешить ID/разрешить имя
Чтобы убрать право публикации:
/запретить @username/запретить ID/запретить имя
Когда возможно, MusicFind ищет участника через member directory группы. Если участник не найден так, можно использовать известный username или числовой Telegram ID.
Держите allowlist коротким. Лучше дать всем поиск, но оставить публикацию нескольким доверенным людям.
Шаг 5. Учитывайте правила провайдеров
MusicFind — это поиск и discovery, а не бот для нелегальных скачиваний.
Провайдеры должны использовать документированные и авторизованные API. MusicFind не должен скрейпить музыкальные сайты, генерировать неофициальные токены, имитировать клиентские приложения, обходить авторизацию или публиковать copyrighted downloads без разрешения.
Если провайдер недоступен, правильное поведение — показать понятное сообщение и подсказку по настройке. Это лучше, чем скрытый fallback, который может создать риск для группы или бота.
Ожидаемый результат после настройки
После настройки участники могут искать музыку в пределах правил чата. Доверенные пользователи могут публиковать результаты, если режим группы это разрешает. Если аудио недоступно, MusicFind использует ссылку. Если провайдер не отвечает, бот сообщает об этом понятно, а не делает сомнительный обход.
MusicFind остаётся частью VibeGuard: безопасность, модерация, AI/ИИ-сводки и Центр безопасности остаются основой, а музыка помогает поддерживать активность там, где это уместно.
Troubleshooting
Участники могут искать, но не могут публиковать. Проверьте режим доступа. В open режиме публикация остаётся admin-only. В semi-open режиме участник должен быть админом или в allowlist.
Трек опубликовался ссылкой, а не аудио. У провайдера могло не быть authorized audio delivery, или отправка аудио могла не пройти. Link fallback — ожидаемое поведение.
Поиск ничего не нашёл. Попробуйте более точный запрос: артист + название. Также проверьте, включены ли провайдеры и нет ли ошибок доступности.
Команда /разрешить не нашла участника. Попробуйте username, числовой ID или имя, которое уже известно группе. Участник должен быть видим в member directory или локальной истории бота.
Провайдер недоступен. Проверьте настройки провайдера. MusicFind должен показать понятную ошибку, а не использовать неофициальный источник.
FAQ
MusicFind — это музыкальный бот для Telegram-группы?
Да. MusicFind позволяет искать треки, смотреть результаты и публиковать аудио или ссылки, если это разрешено режимом группы и правилами провайдеров.
Можно ли всем участникам публиковать музыку в чат?
Не по умолчанию. В open режиме все могут искать, но публикуют только админы. В semi-open — админы и allowlist. В closed — всё доступно только админам.
MusicFind скачивает музыку из интернета?
Нет. MusicFind должен использовать только документированные и авторизованные provider API. Он не должен скрейпить сайты, обходить авторизацию или публиковать неразрешённые загрузки.
Почему вместо аудиофайла появилась ссылка?
Публикация аудио зависит от authorized audio URL или сохранённого Telegram file_id. Если это недоступно, ссылка — безопасный fallback.
MusicFind бесплатный?
У VibeGuard есть бесплатная версия навсегда для каждой группы. AI help/prompts считаются отдельно: каждый участник группы может использовать до 10 AI help/prompts бесплатно, а расширение нужно только сверх бесплатного использования или для продвинутых возможностей.
Добавьте music discovery в группу без потери контроля над публикациями и правилами провайдеров.