API WhatsApp multi-clients : une clé pour tous vos clients
Une API WhatsApp multi-clients permet à un éditeur de logiciel de donner à chacun de ses clients son propre numéro WhatsApp, cloisonné des autres. Avec Nodium, chaque client final est un client de votre compte : une seule clé d'API les pilote tous, et un en-tête nomme le client pour lequel un appel agit.
Le modèle
- Un client par client final (
POST /tenants), avec votre propreexternalId: votre identifiant sert partout où un identifiant de client est attendu. - Le cloisonnement : chaque client a ses numéros, ses conversations, ses contacts et ses modèles. Une ressource d'un autre client répond
404. - Une clé : ajoutez
Nodium-Tenant: <id ou externalId>à n'importe quel appel. Ou émettez une clé épinglée à un client, qui ne peut jamais agir sur un autre. - Un webhook : un abonnement sur votre propre entreprise reçoit les événements de tous les clients, chaque charge portant le client d'origine.
# Same key, one header: the call acts for that customercurl https://nodium.io/api/v1/messages \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Nodium-Tenant: cust_1042" \ -H "Content-Type: application/json" \ -d '{ "channelId": "<channel id>", "to": "+33612345678", "type": "text", "text": "Your glasses are ready.", "idempotencyKey": "order-1042-ready" }'Brancher le numéro de chaque client
Chaque client branche son propre numéro depuis un lien de branchement hébergé, sans créer de compte Nodium. Le numéro reste le sien, et Meta facture ses frais à son propre compte WhatsApp Business.
Ce que ça coûte
Un client est gratuit. Le prix de votre offre suit les numéros connectés et les messages transportés, mis en commun entre tous vos clients. Voir les tarifs.
Questions fréquentes
Un de mes clients peut-il voir les messages d'un autre ?
Non. Chaque ressource appartient à un client, et un appel qui agit pour un client ne peut pas lire celles d'un autre : il répond 404, comme si la ressource n'existait pas.
Me faut-il un webhook par client ?
Non. Un abonnement sur votre propre entreprise reçoit les événements de tous vos clients. Un abonnement créé pour un client ne reçoit que les siens.