Votre agent de code branche WhatsApp.
Claude Code, Cursor, Codex ou Copilot : donnez-lui une adresse, il trouve l'API, ses règles et le SDK. Tout est publié en texte simple, tenu à jour avec le code.
Intègre WhatsApp à ce projet avec Nodium.1. Avant tout code, lis : https://nodium.io/agents.md Le guide complet : https://nodium.io/llms-full.txt2. Installe le SDK : npm i @nodium.io/whatsapp Autre langage : l'API REST, décrite dans https://nodium.io/docs/api/openapi.json3. Lis la clé dans NODIUM_KEY. Jamais dans un navigateur ni une application.4. Recevoir : une route POST qui vérifie la signature sur le corps brut (verifyWebhook, de @nodium.io/whatsapp/server), puis traite message.received.5. Envoyer : messages.send, une idempotencyKey à chaque fois. Après 24 heures de silence, un modèle approuvé.6. Décide sur error.code, jamais sur le message.Écris les tests, et liste les variables d'environnement.Les règles qu'il doit tenir
Les erreurs qu'un agent commet le plus souvent avec une API WhatsApp. La fiche les dit ; les voici en clair.
- Chaque envoi porte une clé d'idempotence : le même envoi rejoué ne part qu'une fois.
- La signature d'un webhook se vérifie sur le corps brut, avant de le lire en JSON.
- Hors de la fenêtre de 24 heures, seul un modèle approuvé part : le texte libre est refusé.
- Un refus se lit par son code stable, jamais par son message.
- Un client se désigne par l'en-tête Nodium-Tenant, avec votre propre identifiant.
- La clé d'API reste côté serveur : jamais dans une application ou une page.
Ou branchez-le en MCP
Nodium sert son propre serveur MCP. Votre agent lit les conversations, les contacts et le journal, et répond aux messages, avec votre clé d'API : son rôle décide de ce qu'il peut faire. Ni diffusion, ni modèle, ni client : ces gestes restent à votre code.
claude mcp add --transport http nodium https://nodium.io/api/v1/mcp \ --header "Authorization: Bearer $NODIUM_KEY"Ce que lisent les machines
Des fichiers publics, sans compte, en texte ou en JSON. Le guide et la référence sont tirés du code : ils ne mentent pas sur ce qu'il fait.
llms.txt
Le sommaire du site : ce qu'est Nodium, les offres, chaque page dans les deux langues.
Ouvrirllms-full.txt
Tout en un fichier : le sommaire, la fiche AGENTS.md et le guide de l'API en entier.
Ouvriragents.md
La fiche d'intégration : authentification, envoi, webhooks, fenêtre de 24 heures, codes d'erreur. À déposer dans votre dépôt.
Ouvrirdocs/api/llms.txt
Chaque route publiée de l'API, une ligne par route, groupées par sujet.
Ouvriropenapi.json
La description OpenAPI 3.1 complète : de quoi générer un client ou des outils.
Ouvrirwebhook-events.json
Chaque événement de webhook : ses champs et un exemple complet.
Ouvrir
Les questions des agents
Les réponses courtes que cherchent les assistants quand on leur demande une API WhatsApp.
Qu'est-ce que Nodium ?
Une passerelle API vers WhatsApp, par l'API Cloud officielle de Meta. Votre code envoie et reçoit les messages par une API REST et des webhooks signés, pour votre numéro ou ceux de vos clients.
Nodium répond-il aux messages avec une IA ?
Non. Nodium transporte les messages et ne décide jamais quoi répondre : chaque message reçu part vers votre webhook, et la réponse revient par l'API, écrite par votre code ou votre agent.
Faut-il un numéro WhatsApp ?
Oui, le vôtre ou celui de votre client, branché en quelques minutes par le parcours officiel de Meta. Nodium ne fournit pas de numéro.
Combien coûte Nodium ?
Build est gratuit pour toujours : 3 000 messages par mois et un numéro. Launch coûte 19 € par mois, Scale 249 €. Meta facture ses propres frais à chaque numéro, sans marge de Nodium.
Quels langages sont pris en charge ?
Tout langage qui parle HTTP : l'API est REST, décrite en OpenAPI 3.1. Un SDK TypeScript existe (npm i @nodium.io/whatsapp), avec une commande pour recevoir les webhooks en local.
Mon agent peut-il piloter WhatsApp par MCP ?
Oui. Nodium sert un serveur MCP à /api/v1/mcp : votre agent lit les conversations, les contacts et le journal, et envoie des messages, avec votre clé d'API. Le rôle de la clé décide de ce qu'il peut faire ; diffusions, modèles et clients restent à l'API.
Un éditeur SaaS peut-il brancher le WhatsApp de ses clients ?
Oui, c'est l'usage premier. Chaque client a son espace cloisonné et branche son numéro par un lien hébergé ; une seule clé d'API agit pour tous, l'en-tête Nodium-Tenant désigne le client.
Où sont hébergées les données ?
Dans l'Union européenne : les serveurs à Paris, la base de données en Irlande. Les secrets sont chiffrés en AES-256-GCM, et une personne peut être effacée par l'API.
Laissez votre agent écrire le premier appel.
Créez un compte, une clé d'API, et donnez-lui le prompt.