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