Built to help you manage and
grow your Telegram bots
Streamline bot operations – from user handling to analytics and campaigns – in one place.
User Management
Track user status, store attributes like preferences or balances, and segment your audience to power experiences.
Analytics Dashboard
Monitor user growth, command usage, and engagement trends to optimize decisions and performance.
Configuration Engine
Update languages, feature flags, and bot settings instantly – with no redeploys needed, all changes go live in seconds.
Campaign Management
Plan broadcasts, run A/B tests, and track delivery across multiple content types and user segments,
User Segmentation
Create groups based on behavior, profile data, or interaction history to personalize engagement and automate actions.
Conversation History
Browse conversations with context, media, sentiment, and AI-generated summaries for faster insights and support.
Everything you need to go live with your bots – fast
Our SDK works seamlessly across multiple platforms and languages, including Node.js, Python, and cURL – so you can build in the environment you already use.
1import { Bot, format, bold, code } from "gramio";
2import { BotApi } from "@cthrone-sdk/telegram";
3
4const cthroneApi = new BotApi(process.env.CTHRONE_API_KEY);
5
6const config = await cthroneApi.loadConfig();
7
8const bot = new Bot(config.bot.token);
9
10bot.derive("message", async (context) => {
11 // Getting user data with aditional content
12 // from cThrone Platform
13 let user = await cthroneApi.findUser(context.user);
14
15 if (!user)
16 // Registering a user in cThrone Platform
17 user = await cthroneApi.registerUser(context.user);
18
19 return {
20 user
21 };
22});
23
24bot.command("buy", async (context) => {
25 // {balance} is a custom field
26 // you can set up them on cThrone Platform
27 if (context.user.balance <= 0)
28 return await context.send(
29 // Requesting i18n message from the platform
30 await cthroneApi.i18n.t("balance.low_balance_message", null, context.user.lang);
31 );
32});1from aiogram import Bot, Dispatcher, types
2from aiogram.filters import Command
3from cthrone.telegram import CThroneApi
4
5async def setup_bot():
6 # Initialize cThrone API client
7 cthrone_api = CThroneApi(os.environ.get("CTHRONE_API_KEY", ""))
8
9 # Load configuration
10 config = await cthrone_api.load_config()
11
12 # Initialize bot and dispatcher
13 bot = Bot(token=config["bot"]["token"])
14 dp = Dispatcher()
15
16 # User middleware for enriching context with user data
17 @dp.update.outer_middleware()
18 async def user_middleware(message: types.Message, bot: Bot) -> Dict[str, Any]:
19 # Getting user data with additional content from cThrone Platform
20 user = await cthrone_api.find_user(message.from_user)
21
22 if not user:
23 # Registering a user in cThrone Platform
24 user = await cthrone_api.register_user(message.from_user)
25
26 # Return data to be added to context
27 return {"user": user}
28
29 # Buy command handler
30 @dp.message(Command("buy"))
31 async def buy_command(message: types.Message, user: Dict[str, Any]):
32 # {balance} is a custom field you can set up on cThrone Platform
33 if user["balance"] <= 0:
34 # Requesting i18n message from the platform
35 low_balance_message = await cthrone_api.i18n.t(
36 "balance.low_balance_message",
37 None,
38 user["lang"]
39
40 await message.answer(low_balance_message)
41
42 return bot, dp1# cThrone API Examples using cURL
2
3# 1. Authentication - Getting a configuration
4# This retrieves your bot configuration from cThrone Platform
5curl -X GET "https://api.cthrone.com/v1/tg/config" \
6 -H "Authorization: Bearer YOUR_CTHRONE_API_KEY" \
7 -H "Content-Type: application/json"
8
9# Sample Response:
10# {
11# "success": true,
12# "data": {
13# "bot": {
14# "token": "1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZ",
15# "username": "your_bot_username"
16# },
17# "other_configs": { ... }
18# }
19# }
20
21# 2. Find a user in cThrone Platform
22# This looks up a user by their Telegram ID
23curl -X GET "https://api.cthrone.com/v1/tg/users/find" \
24 -H "Authorization: Bearer YOUR_CTHRONE_API_KEY" \
25 -H "Content-Type: application/json" \
26 -d '{
27 "id": 123456789,
28 "username": "user_username",
29 "first_name": "First",
30 "last_name": "Last"
31 }'
32
33# Sample Response:
34# {
35# "success": true,
36# "data": {
37# "id": 123456789,
38# "username": "user_username",
39# "first_name": "First",
40# "last_name": "Last",
41# "balance": 1000,
42# "lang": "en",
43# "custom_fields": { ... }
44# }
45# }
46
47# 3. Register a new user in cThrone Platform
48# When a user is not found, you can register them
49curl -X POST "https://api.cthrone.com/v1/tg/users/register" \
50 -H "Authorization: Bearer YOUR_CTHRONE_API_KEY" \
51 -H "Content-Type: application/json" \
52 -d '{
53 "id": 123456789,
54 "username": "user_username",
55 "first_name": "First",
56 "last_name": "Last",
57 "lang": "en"
58 }'
59
60# Sample Response:
61# {
62# "success": true,
63# "data": {
64# "id": 123456789,
65# "username": "user_username",
66# "first_name": "First",
67# "last_name": "Last",
68# "balance": 0,
69# "lang": "en"
70# }
71# }
72
73# 4. Get internationalization (i18n) message
74# This fetches translated messages from cThrone Platform
75curl -X GET "https://api.cthrone.com/v1/tg/i18n/translate" \
76 -H "Authorization: Bearer YOUR_CTHRONE_API_KEY" \
77 -H "Content-Type: application/json" \
78 -d '{
79 "key": "bWhat other developers are saying
Real teams saving time, scaling faster, and improving engagement with cThrone.
Mike P.
"I used to spend 30–40% of my dev time building admin tools. Cthrone wiped out that overhead completely"
Andrii S.
"cThrone’s configuration system is a game-changer. We can update settings, toggle features, and ship instantly updates to our subscribers."
Alex G.
"Cthrone saved me from building admin panels from scratch for every project."
Ivan K.
"I don’t build dashboards anymore. Cthrone gives me what I need out of the box."
Yunus K.
“Used to maintain a bunch of scripts for analytics and toggles. Cthrone solved fro me."
Oscar F.
"User segmentation in helped us run targeted campaigns that actually convert. Engagement jumped 20% in the first week."
Supercharge your Telegram bots.
Launch in minutes with cThrone – the all-in-one dashboard for user management, analytics, and broadcasts.
No more building admin panels from scratch.
Flexible pricing for every stage of your bot
Whether you’re just getting started or scaling to thousands of users, there’s a plan that fits your needs.
Indie
$5.00
Up to 5 bots- Up to 2,000 users
- Basic analytics
- Core configuration tools
Pro
$15.00
- Up to 20 bots
- Up to 10,000 users
- Full analytics suite
- Complete configuration tools
- Message campaigns
Scale
$50.00
- Up to 50 bots
- Up to 50,000 users
- Advanced analytics with export
- White-label admin panel
- Custom integrations
Contact Us
We’d love to hear from you – whether you have a question, feedback, or need support.
