API Tutorial

Come ottenere le analitiche di Telegram tramite API

Per ottenere le analitiche di Telegram tramite API, collega Telegram con Modiva e poi chiama `analytics_unified` — restituisce reach, impression, engagement e metriche sui follower in una forma normalizzata che puoi visualizzare o analizzare.

Ogni piattaforma riporta le metriche in modo diverso, quindi il reporting cross-piattaforma di solito richiede un livello di mapping per ogni rete. Lo strumento `analytics_unified` di Modiva restituisce le metriche di Telegram nello stesso schema di ogni altra piattaforma, così una singola query alimenta un'intera dashboard.

Passo dopo passo

Crea un account Modiva e una chiave MCP

Registrati gratuitamente e genera una chiave MCP (`mk_live_…`) dalla dashboard. La stessa chiave autentica sia il server MCP ospitato (per gli agenti IA) sia la REST API (per il tuo backend), così gestisci un'unica credenziale.

Collega il tuo account Telegram

Nella dashboard clicca su Collega e scegli Telegram. Modiva esegue il flusso OAuth e richiede per te gli scope corretti, poi salva i token di accesso e di refresh in un vault cifrato e li mantiene aggiornati — non maneggi mai le credenziali API grezze di Telegram. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.

Chiama analytics_unified per le metriche di Telegram

Chiama `analytics_unified` con l'ID della connessione, le metriche che desideri e un intervallo di tempo. Modiva le recupera da Telegram, normalizza i nomi dei campi e restituisce una forma JSON coerente, pronta da visualizzare.

Unisci ogni piattaforma in un unico report

Passa più ID di connessione per combinare Telegram con il resto del tuo stack in un'unica risposta. Tramite MCP un agente può recuperare i numeri e scrivere il report settimanale per te, poi chiamare `analytics_best_time_to_post` per pianificare il prossimo.

Richiesta di esempio

Chiama lo strumento analytics_unified tramite l'API REST di Modiva. Lo stesso strumento è disponibile per gli agenti IA sul server MCP all'indirizzo https://mcp.modiva.ai/v1.

POST /v1/tools/invoke

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" }
  }'

Provalo con Telegram

Inizia gratis

FAQ

Le metriche di Telegram sono confrontabili con quelle delle altre piattaforme?

Sì — Modiva normalizza le analitiche di Telegram in uno schema comune, così reach ed engagement combaciano su ogni rete collegata.

Un agente IA può generare il report?

Sì. Esponi `analytics_unified` tramite MCP e un agente può recuperare i numeri di Telegram e comporre la sintesi in autonomia.

Continua a costruire con Telegram

Integrazione API Telegram Server MCP Telegram Come pubblicare su Telegram tramite API Come pianificare i post su Telegram tramite API Come inviare messaggi su Telegram tramite API Come ottenere le analitiche di Instagram tramite API Come ottenere le analitiche di TikTok tramite API