API Tutorial
Comment planifier des publications Discord par API
Pour planifier des publications Discord par API, connecte Discord via Modiva puis appelle `posts_schedule` avec ton contenu et un horodatage `publish_at` — Modiva le met en file d'attente et le publie automatiquement à ce moment-là sur Discord.
Planifier, c'est enregistrer une publication et la diffuser plus tard de façon fiable — quelque chose que l'API de Discord te laisse entièrement gérer. Modiva exploite la file d'attente, réessaie en cas d'erreurs temporaires de Discord et expose un unique outil `posts_schedule` qui fonctionne à l'identique sur chaque plateforme.
É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 Discord
Dans le tableau de bord, clique sur Connecter et choisis Discord. 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 Discord. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Appeler posts_schedule avec une heure publish_at
Appelle `posts_schedule` avec l'ID de connexion, ton contenu et un horodatage `publish_at` au format ISO. Modiva enregistre la tâche et publie à ce moment-là sur Discord, en prenant en charge le rafraîchissement des tokens et les réessais sans ton propre cron.
Trouver le meilleur moment et regrouper un calendrier
Appelle `analytics_best_time_to_post` pour choisir un créneau, puis planifie toute une semaine en boucle. Via MCP, un agent IA peut planifier et mettre en file d'attente un calendrier de contenu Discord complet à partir d'un seul prompt.
Exemple de requête
Appelez l'outil posts_schedule 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_schedule",
"connectionId": "conn_…",
"args": { "text": "Weekly roundup is live", "publish_at": "2026-07-01T15:00:00Z" }
}'Essayez-le avec Discord
Commencer gratuitementFAQ
Est-ce Modiva ou moi qui exploite le planificateur ?
Modiva. Dès que tu appelles `posts_schedule`, Modiva enregistre la tâche et publie à l'heure voulue sur Discord — tu n'as besoin ni de ta propre file d'attente ni d'un cron.
Puis-je planifier la même publication pour plusieurs plateformes ?
Oui — transmets plusieurs ID de connexion (ou utilise `posts_cross_post`) et Modiva planifie la publication pour Discord et chaque autre plateforme, adaptée au format de chacune.