Telegram guide · current beta

How Harmonosphere works.

Harmonosphere is currently a Telegram-first music discovery assistant. Open @HarmonoSphereBot in Telegram, describe your mood or moment, and get one focused song recommendation.

The user flow

From one message to one song.

1

Start the Telegram bot

Open @HarmonoSphereBot and send /start. There is no separate account form or Harmonosphere mobile app required for the current beta.

2

For one direct song: mood + genre

For the clearest direct recommendation, include at least one mood and one genre in the same message — for example “dreamy synth-pop,” “melancholic indie rock,” or “energetic Japanese funk.” You can add activity, language, era, artist references, or other constraints too.

3

Harmonosphere understands the intent

Harmonosphere distinguishes between a direct song request and music conversation. A prompt such as “dreamy synth-pop” is treated as a focused recommendation request; a question such as “How did funk influence city pop?” can receive a conversational answer instead.

4

One candidate is generated

For a recommendation request, the system uses your message plus available recent context and tries to avoid recently recommended tracks.

5

A listening link is resolved

The Telegram flow tries your configured/default service and then supported alternatives including Spotify, YouTube Music, and YouTube. If a candidate cannot be resolved, the flow can retry with another song.

6

Listen, like, or ask for another

When recommendation persistence is available, the Telegram message can include Listen, Like, and Another buttons. If persistence is temporarily unavailable, the recommendation can still be delivered in beta/test mode, but database-dependent feedback buttons may be omitted.

Telegram commands

Commands are for control, not discovery.

Song discovery is conversational. The current commands manage help, credits, purchases, and payment information.

/start

Start here

Explains the core idea and gives example prompts.

/help

Usage help

Shows what you can describe and lists the available control commands.

/credits

Check balance

Shows paid credit balance and the status of today's free pick when entitlement mode is active.

/buy

Buy extra picks

Opens the Telegram Stars purchase menu when Stars payments are enabled.

/terms

Payment terms

Displays the current payment terms inside Telegram.

/paysupport

Payment support

Shows the payment-support information for Telegram purchases.

Free use & Telegram Stars

One daily free pick in production entitlement mode.

The current entitlement design gives one non-accumulating free recommendation per calendar day. After that, extra recommendations use paid credits. Recommendation quality is the same; credits change quantity, not model quality.

During beta, Stars enforcement can be switched off for testing, in which case recommendations may be unlimited.

Starter

8 credits

100 ⭐

Most Popular

30 credits

250 ⭐

Best Value

75 credits

500 ⭐

What happens behind the scenes

A small pipeline, not one giant prompt.

1. Telegram message arrives
↓
2. Intent router classifies the request

recommend a song · music conversation · off-topic

↓
3. Entitlement and context are checked

free daily right / paid credits, plus recent history when available

↓
4. Recommendation engine generates exactly one candidate
↓
5. Streaming link resolution is attempted

Spotify · YouTube Music · YouTube

↓
6. Recommendation is delivered in Telegram

FAQ

Frequently asked questions.

Do I need to configure genres and moods first?
No setup is required. Just write naturally. If you specifically want one song and a listening link, the clearest short format is at least one mood + one genre in the same message, such as “dreamy synth-pop” or “energetic Japanese funk.” You can also add activity, language, era, or artist references.
Does Harmonosphere send a song automatically every day?
Not in the current Telegram beta. The backend has scheduling data structures, but scheduled proactive delivery is still a roadmap item. Right now you ask when you want a recommendation.
Can I try HarmonoSphere without Telegram?
Not right now. HarmonoSphere currently runs as a Telegram bot at @HarmonoSphereBot, and every recommendation happens there. This website is an informational page only; a web app is planned for later.
Which messaging channels work today?
The current beta runs on Telegram. A web app is not launched yet. The backend remains channel-agnostic for future WhatsApp, email, Slack, Discord, Viber, and SMS adapters.
Which listening services are supported?
The current Telegram resolver can try Spotify, YouTube Music, and YouTube. Apple Music is not implemented in the current runtime.
What if the first song cannot be resolved to a link?
The current Telegram flow can retry the recommendation once, excluding the failed candidate, and then attempt link resolution again. The goal is to avoid handing you a recommendation that cannot be opened.
What are Like and Another for?
When persistence is available, Like records positive feedback and Another requests a new recommendation tied to the previous one. These buttons depend on a stored recommendation ID, so they can be omitted when the database is temporarily unavailable.
Is payment required to try it?
The production entitlement design includes one free recommendation per calendar day. During beta testing, Stars enforcement can be disabled and recommendations can be unlimited. Use /credits inside the bot to see the state that applies to your account.
Does paying improve recommendation quality?
No. The product rule is that free and paid usage use the same recommendation quality. Credits buy additional recommendation usage, not a better model tier.
Can I just chat about music?
Yes. Ask about artists, genres, eras, scenes, influences, similarities, or music history and Harmonosphere can answer conversationally. When you want to switch back to a direct song recommendation, give it a mood + genre and it will return one focused track instead of a broad list.
What happens with unrelated questions?
The current intent router identifies off-topic messages and redirects the conversation back toward music rather than acting as a general-purpose assistant.

Try the real flow.

Open the Telegram bot and describe a moment. No setup wizard is required.

Open @HarmonoSphereBot