API Tutorial
So rufst du Telegram-Analysen per API ab
Um Telegram-Analysen per API zu erhalten, verbinde Telegram über Modiva und rufe dann `analytics_unified` auf — es gibt Reichweite, Impressionen, Engagement und Follower-Metriken in einer normalisierten Form zurück, die du visualisieren oder auswerten kannst.
Jede Plattform meldet Metriken anders, daher bedeutet plattformübergreifendes Reporting meist eine Mapping-Schicht pro Netzwerk. Modivas `analytics_unified`-Tool gibt Telegram-Metriken im selben Schema zurück wie jede andere Plattform, sodass eine Abfrage ein ganzes Dashboard antreibt.
Schritt für Schritt
Modiva-Konto und MCP-Schlüssel erstellen
Registriere dich kostenlos und generiere im Dashboard einen MCP-Schlüssel (`mk_live_…`). Derselbe Schlüssel authentifiziert sowohl den gehosteten MCP-Server (für KI-Agenten) als auch die REST-API (für dein Backend), sodass du nur eine Zugangsberechtigung verwaltest.
Dein Telegram-Konto verbinden
Klicke im Dashboard auf Verbinden und wähle Telegram. Modiva führt den OAuth-Flow aus und fordert die passenden Scopes für dich an, speichert die Access- + Refresh-Tokens dann in einem verschlüsselten Tresor und hält sie aktuell — du hantierst nie mit den rohen API-Zugangsdaten von Telegram. Die Verbindung erhält eine stabile `connectionId`, auf die du in jedem Aufruf verweist.
analytics_unified für Telegram-Metriken aufrufen
Rufe `analytics_unified` mit der Connection-ID, den gewünschten Metriken und einem Zeitraum auf. Modiva holt sie von Telegram, normalisiert die Feldnamen und gibt eine konsistente JSON-Form zurück, bereit zum Visualisieren.
Jede Plattform in einen Bericht zusammenfassen
Übergib mehrere Connection-IDs, um Telegram mit dem Rest deines Stacks in einer einzigen Antwort zu kombinieren. Über MCP kann ein Agent die Zahlen abrufen und den Wochenbericht für dich schreiben und dann `analytics_best_time_to_post` aufrufen, um den nächsten zu planen.
Beispielanfrage
Rufe das Tool analytics_unified über die REST-API von Modiva auf. Dasselbe Tool steht KI-Agenten über den MCP-Server unter https://mcp.modiva.ai/v1 zur Verfügung.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "analytics_unified",
"connectionId": "conn_…",
"args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
}'Mit Telegram ausprobieren
Kostenlos startenFAQ
Sind Telegram-Metriken mit anderen Plattformen vergleichbar?
Ja — Modiva normalisiert Telegram-Analysen in ein gemeinsames Schema, sodass Reichweite und Engagement über jedes verbundene Netzwerk hinweg zusammenpassen.
Kann ein KI-Agent den Bericht erstellen?
Ja. Stelle `analytics_unified` über MCP bereit, und ein Agent kann die Telegram-Zahlen abrufen und die Zusammenfassung eigenständig verfassen.