Connection methods
Metriox supports three main connection methods for sending events:
1. HTTP API (Telegram WebApp / Mini App)
Send events straight through the HTTP API from your Telegram Mini App.
When to use it:
- You are building a Telegram Mini App (WebApp)
- You want maximum control over how events are sent
- You want to integrate without an SDK
2. SDK
Use the official SDKs for a simpler integration:
- JavaScript/TypeScript - for Node.js and the browser (telegram web apps)
- C# - for .NET applications
When to use it:
- You want a fast, convenient integration
- You want data serialized for you
- You want built-in error handling
3. Automatic
Connect automatically by simply providing your Telegram bot token.
When to use it:
- It is the fastest way to get started
- It needs minimal configuration
- It collects basic events automatically
Choosing a connection method
| Method | Setup speed | Control | Requires code |
|---|---|---|---|
| HTTP API | Slow | Full | Yes |
| SDK | Medium | High | Yes |
| Bot token | Instant | Basic | No |
Recommendation: If you are just starting out, begin with the Telegram bot token. It takes 2-3 minutes and lets you see data right away. Later you can set up the SDK or API for more flexible control.
What's next?
- HTTP API — when you need full flexibility
- SDK — for a quick integration in code
- Telegram bot token — the simplest option
Or go back to the core concepts to better understand how events work.