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