API Tutorial
Come ottenere le analitiche di WhatsApp tramite API
Per ottenere le analitiche di WhatsApp tramite API, collega WhatsApp 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 WhatsApp 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 WhatsApp
Nella dashboard clicca su Collega e scegli WhatsApp. 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 WhatsApp. La connessione riceve un `connectionId` stabile a cui fai riferimento in ogni chiamata.
Chiama analytics_unified per le metriche di WhatsApp
Chiama `analytics_unified` con l'ID della connessione, le metriche che desideri e un intervallo di tempo. Modiva le recupera da WhatsApp, 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 WhatsApp 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.
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 WhatsApp
Inizia gratisFAQ
Le metriche di WhatsApp sono confrontabili con quelle delle altre piattaforme?
Sì — Modiva normalizza le analitiche di WhatsApp 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 WhatsApp e comporre la sintesi in autonomia.