API Tutorial
Comment envoyer des messages X par API
Pour envoyer des messages X par API, connecte X 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 X 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 X 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 X
Dans le tableau de bord, clique sur Connecter et choisis X. 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 X. 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 X et renvoie l'ID du message, en respectant les fenêtres et les règles de messagerie de X.
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 X 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 X
Commencer gratuitementFAQ
Puis-je construire une boîte de réception unifiée qui inclut X ?
Oui. `messages_inbox` renvoie les conversations de X 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 X ?
Oui — Modiva applique les fenêtres de messagerie et les exigences de politique de X, afin que tes envois restent conformes.