Документация / команды и настройки гороскопов
Техническая документация

Как использовать VibeGuard как гороскоп-бот для Telegram-группы

Гороскоп-бот для Telegram-группы в VibeGuard даёт участникам лёгкий ежедневный ритуал: запросить знак зодиака, получить ответ в чате и вернуться к общению. В этом гайде — команды, поддерживаемые знаки, ежедневный кэш, AI-стилизация и fallback, если источник или AI временно недоступны.

Перед использованием гороскопов

Гороскопы в VibeGuard относятся к слою вовлечения сообщества. Это не основная функция безопасности и не замена модерации. Сначала стоит настроить базовые вещи: бот добавлен в группу, понятны права, включены нужные модули защиты, модерации и AI/ИИ-сводок.

В фан-чате, авторском сообществе или дружеской группе ежедневный гороскоп может стать лёгким поводом для разговоров. В строгом маркетплейсе, рабочей группе или support-чате такую функцию можно оставить выключенной или использовать очень аккуратно.

Как и другие функции VibeGuard, гороскопы работают в контексте конкретной Telegram-группы. Настройки, язык, кэш и поведение функции не должны смешиваться между разными чатами.

Команды гороскопа в Telegram

Основной триггер на русском:

гороскоп <знак>

Также поддерживается английский вариант:

horoscope <sign>

Примеры:

  • гороскоп овен
  • гороскоп лев
  • гороскоп скорпион
  • гороскоп ♓
  • horoscope leo

VibeGuard может распознавать прямые названия знаков, русские алиасы, английские алиасы и символы зодиака, если они поддерживаются локализацией группы.

Если участник вводит знак необычным способом и бот не распознаёт его, лучше попробовать полное название: гороскоп рыбы, гороскоп козерог, horoscope aries.

Какие знаки поддерживаются

Поддерживаются все 12 знаков зодиака:

  • Овен
  • Телец
  • Близнецы
  • Рак
  • Лев
  • Дева
  • Весы
  • Скорпион
  • Стрелец
  • Козерог
  • Водолей
  • Рыбы

Для русскоязычной страницы и русскоязычных групп основными примерами лучше делать русские названия. Английские алиасы полезны для смешанных сообществ, где участники привыкли к aries, leo, scorpio и другим вариантам.

Зодиакальные символы тоже могут использоваться как короткий ввод, если бот их распознаёт.

Как возвращается ежедневный гороскоп

Когда участник просит гороскоп, VibeGuard делает несколько шагов:

  1. Читает команду и определяет знак.
  2. Определяет сервисный день.
  3. Проверяет, есть ли уже кэшированный результат для этого знака на сегодня.
  4. Если кэша нет, запрашивает текст из настроенного источника.
  5. При необходимости применяет AI-стилизацию.
  6. Сохраняет результат в кэш и отвечает в Telegram.

Кэш важен. Если несколько участников за день просят гороскоп для одного и того же знака, бот может вернуть уже готовый ответ. Так ответы приходят быстрее, а лишние запросы к источнику и AI не создаются без необходимости.

AI-стилизация и fallback

Гороскоп может быть дополнительно стилизован через AI-слой VibeGuard: текст становится более живым, аккуратным и подходящим для общения в группе.

AI-стилизация не обязательна. Если AI временно недоступен или отключён, VibeGuard должен вернуть исходный текст, если он доступен. Если недоступен сам источник гороскопа, бот должен показать понятную ошибку, а не молчать и не создавать ощущение, что команда сломалась без объяснения.

AI-функции в VibeGuard управляются серверно и через квоты. Интерактивные AI help/prompts — отдельная поверхность продукта: каждый участник группы может использовать до 10 AI help/prompts бесплатно, а расширение нужно только сверх бесплатного использования или для продвинутых сценариев.

Настройки админа и локализация

Админам стоит включать гороскопы только там, где они реально помогают вайбу группы. Это лёгкая social-функция, а не обязательная часть защиты или модерации.

На уровне сервиса гороскопы могут учитывать источник контента, AI-стилизацию, сервисную таймзону, кэш и режим доставки в Telegram. Обычным участникам не нужно управлять этими настройками из чата.

Для русскоязычных групп ответы и примеры должны звучать по-русски. Для смешанных сообществ можно оставить поддержку английских алиасов, но основной UX лучше делать понятным большинству участников.

Ожидаемый результат

После настройки участники могут запросить ежедневный гороскоп по знаку. Если результат уже есть в кэше на текущий сервисный день, бот отвечает быстро. Если AI-стилизация включена и доступна, ответ может быть оформлен более естественно. Если AI недоступен, бот возвращает исходный текст. Если источник недоступен, участник получает понятное сообщение об ошибке.

Troubleshooting

Бот не распознал знак. Попробуйте полное русское название: гороскоп овен, гороскоп рыбы, гороскоп козерог. Для смешанных групп можно попробовать английский алиас или символ.

Один и тот же гороскоп повторяется. Это ожидаемо для одного знака в рамках одного сервисного дня. VibeGuard кэширует ежедневный результат.

Ответ выглядит простым, без AI-стиля. AI-стилизация может быть отключена или временно недоступна. Команда всё равно может вернуть исходный текст.

Гороскоп не отвечает в группе. Проверьте, активен ли VibeGuard в чате и включена ли функция гороскопов для этой группы.

“Сегодня” кажется сдвинутым. Проверьте ожидания группы по таймзоне. Ежедневный гороскоп привязан к сервисному дню.

FAQ

VibeGuard — это гороскоп-бот для Telegram-группы?

VibeGuard включает команды гороскопа как часть функций вовлечения. Участники могут запросить ежедневный гороскоп по знаку, алиасу или символу, если функция доступна в группе.

Какие знаки зодиака поддерживаются?

Поддерживаются все 12 знаков: от Овна до Рыб. Ввод может работать через русские названия, английские алиасы и символы зодиака, если они поддерживаются локализацией.

Нужен ли AI для гороскопов?

Нет. AI-стилизация может улучшить подачу текста, но гороскопы не должны падать только из-за недоступности AI. Если возможно, бот вернёт исходный текст.

Почему бот возвращает тот же гороскоп повторно?

VibeGuard кэширует ежедневный результат по знаку и сервисному дню. Это ускоряет ответы и снижает лишнюю нагрузку на источник и AI.

Гороскопы бесплатны?

У VibeGuard есть бесплатная версия навсегда для каждой группы. AI help/prompts считаются отдельно: каждый участник группы получает до 10 бесплатных AI help/prompts, а платное расширение нужно только сверх бесплатного использования или для продвинутых потребностей.

Сначала защитите чат и настройте модерацию. Затем включайте лёгкие функции вовлечения, которые подходят вашей группе.