Comment ajouter WhatsApp à votre SaaS
Pour ajouter WhatsApp à un SaaS, on branche le numéro de chaque client à l'API Cloud officielle de Meta, on reçoit ses messages sur un webhook et on répond par une API REST. Avec une passerelle comme Nodium, cela tient en cinq étapes, sans application Meta à soi.
Les cinq étapes
- Créez un compte et une clé d'API. La clé (
nod_…) pilote tout votre compte. - Ajoutez chaque client (
POST /tenants), avec votre propre identifiant. Voir une clé pour tous vos clients. - Envoyez-lui un lien de branchement. Il branche son propre numéro par l'inscription de Meta, en quelques minutes. Voir le lien de branchement.
- Déclarez un webhook. Chaque message des contacts de vos clients arrive en
message.received, signé. - Envoyez. Un modèle pour écrire en premier, du texte libre pour répondre dans les 24 heures.
# 1. Write first to a customer: on WhatsApp, an approved templatecurl https://nodium.io/api/v1/messages \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "channelId": "<channel id>", "to": "+33612345678", "type": "template", "templateName": "order_ready", "templateLanguage": "en", "variables": { "1": "Karim" }, "idempotencyKey": "order-1042-confirmation" }'# 2. The customer answers: you receive message.received on your webhook.# Reply in free text, within 24 hours:curl https://nodium.io/api/v1/messages \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "channelId": "<channel id>", "to": "+33612345678", "type": "text", "text": "Yes, it is ready.", "idempotencyKey": "order-1042-reply-1" }'Ce que WhatsApp impose, quel que soit le fournisseur
- La fenêtre de 24 heures : du texte libre seulement dans les 24 heures qui suivent le dernier message du client ; un modèle approuvé sinon.
- Les modèles sont relus par Meta avant de pouvoir partir.
- Meta facture ses propres frais de message au compte WhatsApp Business de chaque numéro. Voir les prix de Meta expliqués.
- Un numéro est sur l'API ou sur WhatsApp classique, jamais les deux ; l'appli WhatsApp Business peut rester, avec la coexistence.
Le construire soi-même, ou passer par une passerelle
Appeler Meta directement, c'est créer une application Meta, faire vérifier son entreprise, passer la revue d'application et devenir Tech Provider avant qu'un seul client puisse se brancher, puis entretenir jetons, webhooks et inscription intégrée. Une passerelle porte tout cela. Voir Tech Provider ou Solution Partner.
Questions fréquentes
Combien de temps faut-il pour ajouter WhatsApp à un SaaS ?
Avec une passerelle, un premier message envoyé et répondu prend un après-midi : une clé d'API, une route de webhook et deux appels. Le branchement de chaque client lui prend ensuite quelques minutes, sur une page hébergée.
À qui appartient le numéro ?
À votre client. Il branche un numéro qui est le sien, qui reste dans son compte WhatsApp Business, et avec lequel il peut partir.