API Tutorial
Comment envoyer des messages Instagram par API
Pour envoyer des messages Instagram par API, connecte Instagram via Modiva puis appelle `messages_send` avec le destinataire et le texte — lis la conversation avec `messages_list` pour alimenter des boîtes de réception et des réponses automatiques par IA.
La messagerie par programmation sur Instagram implique d'ordinaire de se frayer un chemin à travers des API de messagerie spécifiques à la plateforme et des autorisations. Modiva abstrait cela dans `messages_send`, `messages_list` et `messages_inbox`, si bien qu'une boîte de réception unifiée ou un répondeur IA fonctionne sur Instagram exactement comme partout ailleurs.
É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 Instagram
Dans le tableau de bord, clique sur Connecter et choisis Instagram. 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 Instagram. La connexion reçoit un `connectionId` stable auquel tu fais référence dans chaque appel.
Envoyer un message avec messages_send
Appelle `messages_send` avec l'ID de connexion, un `recipient_id` et ton texte. Modiva le remet via Instagram et renvoie l'ID du message, en respectant les fenêtres et les règles de messagerie de Instagram.
Construire une boîte de réception ou un répondeur IA
Utilise `messages_inbox` et `messages_list` pour rassembler les conversations dans une seule vue. Via MCP, un agent peut lire un message Instagram entrant, décider d'une réponse et répondre avec `messages_send` — une boucle de support IA complète.
Exemple de requête
Appelez l'outil messages_send 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": "messages_send",
"connectionId": "conn_…",
"args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
}'Essayez-le avec Instagram
Commencer gratuitementFAQ
Puis-je construire une boîte de réception unifiée qui inclut Instagram ?
Oui. `messages_inbox` renvoie les conversations de Instagram sous la même forme que tout autre canal, si bien qu'une seule interface de boîte de réception les couvre toutes.
Modiva respecte-t-il les règles de messagerie de Instagram ?
Oui — Modiva applique les fenêtres de messagerie et les exigences de politique de Instagram, afin que tes envois restent conformes.