Chat with your AI agent from Telegram. The fastest channel to set up — most people finish in under 5 minutes.
Telegram is often the easiest channel to set up — most people get it working in under 5 minutes. No developer portals, no permissions panels, no server setup. Just a bot token and you're live.
BotFather is Telegram's official bot for creating and managing bots. It's made by Telegram — not a third party.
/start) to begin./newbot to create a new bot.bot (e.g., my_heyron_bot). It must be unique across all of Telegram.7123456789:AAH.... Copy it and save it.Never share your bot token publicly. Treat it like a password. Anyone with your token can control your bot. If you accidentally leak it, use /revoke in BotFather to invalidate it.
Go to your heyron dashboard at heyron.ai/chat and tell your agent:
Your agent handles everything from here — it saves the token, configures the Telegram channel, and restarts the gateway. Usually takes about 15 seconds.
bot).Go back to your heyron dashboard and tell your agent:
Once approved, you're connected. Chat freely with your agent from Telegram — it works just like the web dashboard.
That's it. Your agent is now live on Telegram. Messages in Telegram and your web dashboard are separate conversations — each channel has its own history.
If you add your bot to a Telegram group, it won't see messages by default. You need to either disable privacy mode via /setprivacy in BotFather, or make the bot a group admin.
To disable privacy mode:
/setprivacy.Alternatively, making your bot an admin in the group also lets it see all messages without changing privacy mode.
Something not working? Here are the most common issues.
First, make sure the pairing was approved. Go to your dashboard and check that Telegram shows as a connected channel.
If pairing is approved but it still won't reply, verify the token is correct. You can check by telling your agent: "Is Telegram connected?"
If nothing else works, regenerate the token in BotFather (/mybot → select your bot → API Token → Revoke) and give the new token to your agent.
Privacy mode is on by default for all Telegram bots. This means your bot can't see messages in group chats unless it's mentioned or privacy mode is disabled.
Fix it: send /setprivacy to @BotFather, select your bot, and choose Disable. Or make the bot a group admin.
This usually means you're not in an active private chat with that exact bot identity, or you're replying in the wrong place (group vs direct chat).
Run this quick reset:
1) Search for your bot username directly in Telegram and open the private chat.
2) Tap Start (or send /start) again.
3) Send a plain text message like ping (not a forwarded message).
4) If you're testing in a group, either mention the bot explicitly or disable privacy mode with /setprivacy.
If it still fails, regenerate your token in BotFather and reconnect Telegram from a fresh heyron session before retesting.
Go back to @BotFather in Telegram. Send /mybot, select your bot, then tap API Token. You can view the current token or revoke it and generate a new one.
If you generate a new token, make sure to update your agent with it in the dashboard.
This is by design. Each channel is a separate session — Telegram and web chat have independent conversation histories. Your agent remembers context within each channel, but they don't cross over.
Think of it like texting vs. calling — same person, different conversations.