API Tutorial
Comment publier sur Telegram par API
Pour publier sur Telegram par API, connecte le compte Telegram via Modiva (qui gère OAuth et les scopes), puis appelle l'outil `posts_create` avec ton texte et tes médias — Modiva le publie sur Telegram et renvoie l'ID du post.
L'API propre à Telegram exige une revue d'application, la gestion d'OAuth et les bonnes autorisations de publication avant que tu puisses ne serait-ce que poster une mise à jour. Modiva s'occupe de tout cela pour toi et expose un unique outil `posts_create` qui publie sur Telegram (et sur toute autre plateforme connectée) de la même manière.
Étape par étape
Créer un compte Modiva et une clé MCP
Inscris-toi gratuitement et génère une clé MCP (`mk_live_…`) dans le tableau de bord. La même clé authentifie à la fois le serveur MCP hébergé (pour les agents IA) et l'API REST (pour ton backend), si bien que tu ne gères qu'un seul identifiant d'accès.
Connecter ton compte Telegram
Dans le tableau de bord, clique sur Connecter et choisis Telegram. Modiva exécute le flux OAuth et demande les scopes appropriés à ta place, puis stocke les tokens d'accès et de rafraîchissement dans un coffre chiffré et les maintient à jour — tu ne manipules jamais les identifiants d'API bruts de Telegram. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Appeler posts_create pour publier sur Telegram
Appelle l'outil `posts_create` avec l'ID de connexion et ton contenu. Modiva valide la charge utile par rapport aux règles de format de Telegram (longueur, types de médias, ratios d'aspect) et publie immédiatement, en renvoyant l'ID et l'URL du post en direct.
Aller plus loin — planifier, cross-poster, automatiser
Le même appel pilote un agent IA via MCP : pointe Claude ou Cursor vers `https://mcp.modiva.ai/v1` et il peut publier sur Telegram en ton nom. Remplace `posts_create` par `posts_schedule` pour le mettre en file d'attente, ou `posts_cross_post` pour diffuser un même contenu sur toutes les plateformes d'un coup.
Exemple de requête
Appelez l'outil posts_create via l'API REST de Modiva. Le même outil est disponible pour les agents IA sur le serveur MCP à l'adresse 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 🚀" }
}'Essayez-le avec Telegram
Commencer gratuitementFAQ
Ai-je besoin d'une application développeur Telegram pour publier par API ?
Non. Modiva possède l'application Telegram vérifiée et prend en charge OAuth, si bien que tu te connectes en un clic et tu démarres — pas de revue d'application, pas de bidouillage de scopes.
Un agent IA peut-il publier sur Telegram à ma place ?
Oui. Le même outil `posts_create` est exposé via le Model Context Protocol, si bien que n'importe quel client MCP (Claude, Cursor, etc.) peut publier sur Telegram dès que tu ajoutes ta clé MCP Modiva.