API Tutorial
Come pubblicare su Telegram tramite API
Per pubblicare su Telegram tramite API, collega l'account Telegram con Modiva (che gestisce OAuth e scope) e poi chiama lo strumento `posts_create` con il tuo testo e i tuoi media — Modiva lo pubblica su Telegram e restituisce l'ID del post.
L'API di Telegram richiede la revisione dell'app, la gestione di OAuth e i permessi di pubblicazione corretti prima ancora di poter pubblicare un solo aggiornamento. Modiva si occupa di tutto questo per te e mette a disposizione un unico strumento `posts_create` che pubblica su Telegram (e su ogni altra piattaforma collegata) nello stesso modo.
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_create per pubblicare su Telegram
Chiama lo strumento `posts_create` con l'ID della connessione e il tuo contenuto. Modiva verifica il payload rispetto alle regole di formato di Telegram (lunghezza, tipi di media, proporzioni) e pubblica immediatamente, restituendo l'ID e l'URL del post live.
Fai di più — pianifica, cross-posta, automatizza
La stessa chiamata alimenta un agente IA tramite MCP: indirizza Claude o Cursor su `https://mcp.modiva.ai/v1` e potrà pubblicare su Telegram per tuo conto. Sostituisci `posts_create` con `posts_schedule` per metterlo in coda, oppure `posts_cross_post` per diffondere un post su ogni piattaforma in una volta sola.
Richiesta di esempio
Chiama lo strumento posts_create 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_create",
"connectionId": "conn_…",
"args": { "text": "Shipped via Modiva 🚀" }
}'Provalo con Telegram
Inizia gratisFAQ
Ho bisogno di un'app per sviluppatori Telegram per pubblicare tramite API?
No. Modiva possiede l'app Telegram già approvata e gestisce OAuth, così ti colleghi con un clic e parti subito — nessuna revisione dell'app, nessuna complicazione con gli scope.
Un agente IA può pubblicare su Telegram per me?
Sì. Lo stesso strumento `posts_create` è esposto tramite il Model Context Protocol, così qualsiasi client MCP (Claude, Cursor e simili) può pubblicare su Telegram non appena aggiungi la tua chiave MCP di Modiva.