API Tutorial
Come pianificare i post su Telegram tramite API
Per pianificare i post su Telegram tramite API, collega Telegram con Modiva e poi chiama `posts_schedule` con il tuo contenuto e un timestamp `publish_at` — Modiva lo mette in coda e lo pubblica automaticamente su Telegram in quel momento.
Pianificare significa salvare un post e pubblicarlo in modo affidabile più tardi — qualcosa che l'API di Telegram lascia interamente a te. Modiva gestisce la coda, riprova in caso di errori temporanei di Telegram e mette a disposizione un unico strumento `posts_schedule` che funziona in modo identico su ogni piattaforma.
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 posts_schedule con un orario publish_at
Chiama `posts_schedule` con l'ID della connessione, il tuo contenuto e un timestamp `publish_at` in formato ISO. Modiva salva il job e pubblica su Telegram in quel momento, gestendo il refresh dei token e i tentativi ripetuti senza bisogno di un tuo cron.
Trova il momento migliore e componi un calendario
Chiama `analytics_best_time_to_post` per scegliere uno slot, poi pianifica un'intera settimana in un ciclo. Tramite MCP un agente IA può pianificare e mettere in coda un intero calendario di contenuti Telegram a partire da un singolo prompt.
Richiesta di esempio
Chiama lo strumento posts_schedule 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": "posts_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Provalo con Telegram
Inizia gratisFAQ
Lo scheduler lo gestisce Modiva o io?
Modiva. Una volta chiamato `posts_schedule`, Modiva salva il job e pubblica su Telegram all'orario desiderato — non ti servono una coda o un cron tuoi.
Posso pianificare lo stesso post su più piattaforme?
Sì — passa più ID di connessione (oppure usa `posts_cross_post`) e Modiva pianifica il post per Telegram e per ogni altra piattaforma, adattandolo di volta in volta al formato.