# 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 propre `externalId` : 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.

```bash
# Same key, one header: the call acts for that customer
curl 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é](https://nodium.io/fr/features/embedded-signup), 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](https://nodium.io/fr/pricing).

## 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.

Mis à jour le 2026-11-10 · https://nodium.io/fr/features/multi-tenant