See who uses your Telegram bot, and message all of them.
Telegram shows one monthly number on your bot's page. Connect your bot and you see who came back, where they came from and who can still get your message. Free for now.
Pinewood Quiz
Sample bot Your Overview looks like this, with your own numbersTotal users
On your list, who your messages can reach, 86 new this week
- Your channel1,180+18%
- Giveaway link796+9%
- Direct588-3%
Active users
People seen in the last 30 days
Come back rate
Of new people came back a week or more later
- After 1 day62%+3 pts
- After 7 days38%+2 pts
- After 30 days21%0 pts
Where users come from
Your channel brought the most new people in 30 days
| Channel | Percent | Total |
|---|---|---|
| Your channel | 46% | 374 |
| Giveaway link | 31% | 252 |
| Direct | 23% | 186 |
Retention
Still coming back 4 weeks or more after joining
Each row is a week of new people. Columns are weeks since they joined.
Messages
Reached by "Quiz night", 2 days ago
See who's using your bot
Active users today, this week and this month. How many are new and how many came back. Each week of new people gets its own row, so you can see if last month's update made people stay.
Who came back
Weeks since they joined
Know where users come from
Make a tracked link for each place you post: a channel, a group, an ad. Each one counts its clicks, so you stop paying for the places that bring nobody.
We count who pressed Start through a link when the panel runs your bot. If your own code runs it, we count the clicks.
Where new users came from
Tracked links
3| Link | Clicks | Joins |
|---|---|---|
| Your channel | 1,604 | 374 |
| Giveaway link | 1,079 | 252 |
| Partner group | 312 | 61 |
Message everyone
Write once and send from one bot or several. Send now or pick a time. Send to everyone, or to a group you saved, like people active this month. The preview looks like Telegram, and you can send yourself a test first.
Afterwards you see who got it, who blocked you and who couldn't be reached. Someone on two of your bots can get it just once.
How it went out
Sent from 2 bots
| Bot | Delivered | Blocked |
|---|---|---|
| Pinewood Quiz | 1,612 | 29 |
| Pinewood Trivia | 478 | 9 |
ScheduledNext one set to send Friday at 8 PM, to Active this month
Keep your list clean
Find out who blocked your bot, deleted their account or never started it, without sending anyone a message. Nobody sees a thing. It doesn't use your daily messages, and you can run 3 checks a day.
Your sends already skip those people. Delete them when you want the numbers to be honest. Nothing is deleted unless you press the button.
Can't be reached
Replies by themselves
Set what your bot says when someone presses Start, with a picture and buttons if you like. Then add rules: when someone writes a word you choose, the bot answers by itself. There's no coding, and you can have 50 rules.
This needs the panel to run your bot, so it's for a bot with no code of its own. If your code answers people, it carries on doing that.
Your rules
2When someone writes prize or win
The bot answers
The winner of each round gets 50 Stars, the same night.
When someone sends /rules
The bot answers
Ten questions, ten seconds each. No looking it up.
Show real numbers publicly
List your bot and it gets its own page in the directory. A mini app with our one line, or a bot the panel runs, is counted by us, so its page says Verified. Those numbers rank in Most active once we've counted 50 people.
Numbers your own code sends show as Reported, because we can't check them. They stay off your page until you choose, and they never rank.
Verified: counted by miniapps.me
Most active
Works with your code
Your bot stays on your server and keeps its webhook. Add one line to a mini app, tell us what people do in a bot, and add people to your list when you want to. We never need your database.
The panel page for your bot has these with its real id in them, and a live check that shows the first event arrive. Read the API docs.
A mini app: one line, and no key
<script src="https://miniapps.me/stats.js" data-app="your-app" async></script>
A bot: tell us what people do
curl https://miniapps.me/api/v1/events \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"bot": 123, "user": 123456789, "event": "command", "name": "/start"}'
Add the people you already have
curl https://miniapps.me/api/v1/panel/users \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"bot": 123, "users": [{"id": 123456789, "language": "en"}]}'
How it starts
- 1
Add your bot
Paste its token from @BotFather and say if it's a bot, a mini app or both. Nothing about your bot changes.
- 2
Connect your data
One line for a mini app, two calls for a bot with its own code, and nothing to install for a bot we run. You watch the first event arrive.
- 3
See it and send
Your numbers fill in by themselves. Write your first message and try it on yourself before it goes out.
Your token proves the bot is yours and lets us send for you, so we do keep it. It's stored encrypted and never shown again, and you can cancel it in @BotFather at any time.
Questions
Is it really free?
Yes, for now. There is nothing to pay and no card to enter. A free account can connect 3 bots, keep 20,000 people and send 20,000 messages a day.
Will connecting break my bot?
No. Connecting leaves your bot as it is, and you add people by uploading them or through our API. You can choose later, in the bot's settings, to have miniapps.me receive its messages. That replaces its webhook, so only do it if the bot has no other code running.
Who can I send messages to?
Only people who have started your bot. Telegram doesn't let any bot message someone who never did, and that goes for uploaded lists too.
I have a mini app, not a bot. Can I use this?
Yes, through its bot. A mini app is listed by its bot, so that's the one you connect.
Do I have to list my bot in the directory?
No. The panel and the directory are separate. If you use both, they show up together under Your bots in your account.
Are the numbers on this page real?
No. They belong to Pinewood Quiz, a sample bot we made up. The cards are the ones you get, and yours fill in with your own bot's numbers.