API WhatsApp pour les plateformes SMS : tutoriel 2026

Intégrer l'API WhatsApp Business dans une plateforme SMS existante suit une logique proche de celle d'une passerelle SMS : un token d'authentification, un endpoint d'envoi, des webhooks entrants. Ce tutoriel détaille les étapes concrètes pour un développeur qui démarre l'intégration via Whakup, Meta Tech Provider certifié.

Étape 1 : préparer l'environnement et obtenir vos credentials

Avant d'écrire la moindre ligne de code, il vous faut trois éléments :

1. Un compte Whakup actif avec accès à l'espace partenaire.
2. Un Phone Number ID : l'identifiant du numéro WhatsApp associé au compte de test.
3. Un token d'accès : généré depuis votre espace Whakup, il s'utilise dans chaque requête HTTP comme Bearer token.

Whakup fournit un environnement sandbox pour tester l'intégration sans facturation. C'est l'environnement à utiliser pendant la phase de développement. Pour une présentation complète de la sandbox, consultez l'article sandbox WhatsApp API.

Une fois vos credentials en main, configurez les variables d'environnement dans votre application :

WHAKUP_TOKEN=<votre_token>
WHAKUP_PHONE_NUMBER_ID=<votre_phone_number_id>
WHAKUP_API_BASE=https://api.whakup.com/v1

Étape 2 : envoyer un message template (HSM)

L'envoi d'un message initié par la plateforme (hors fenêtre de conversation de 24h) nécessite un template approuvé par Meta. C'est la brique de base de toute intégration plateforme SMS vers WhatsApp.

Structure de la requête POST :

POST /messages
Authorization: Bearer <token>
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "+33612345678",
  "type": "template",
  "template": {
    "name": "confirmation_commande",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Marie" },
          { "type": "text", "text": "#78542" }
        ]
      }
    ]
  }
}

Points d'attention :

• Le nom du template (confirmation_commande) doit correspondre exactement à celui approuvé dans votre espace Meta Business.
• Les paramètres sont positionnels : {{1}} = premier paramètre, {{2}} = deuxième.
• Le numéro destinataire doit être au format international avec +.

Pour comprendre les catégories de templates (marketing, utility, authentication) et leurs règles respectives, lisez l'article templates WhatsApp catégories.

Étape 3 : recevoir les réponses via webhooks

Contrairement au SMS, WhatsApp permet une conversation bidirectionnelle. Votre plateforme doit exposer un endpoint webhook pour recevoir les messages entrants et les statuts de livraison.

Configuration du webhook dans l'espace Whakup :

Paramètre	Valeur
URL de callback	https://votre-plateforme.com/webhooks/whatsapp
Verify token	Chaîne secrète définie par vous
Événements	messages, message_status

Payload typique d'un message entrant :

{
  "object": "whatsapp_business_account",
  "entry": [{
    "changes": [{
      "value": {
        "messages": [{
          "from": "33612345678",
          "type": "text",
          "text": { "body": "Oui, je confirme." },
          "timestamp": "1720000000"
        }]
      }
    }]
  }]
}

Votre webhook doit répondre avec un HTTP 200 immédiatement, puis traiter le message en asynchrone. Un délai de réponse ou une erreur 5xx entraîne des tentatives de renvoi de la part de Meta.

Pour approfondir la configuration des webhooks, l'article webhooks WhatsApp API couvre les cas avancés.

Étape 4 : gérer le multi-tenant pour vos clients

Si votre plateforme SMS héberge plusieurs clients (agences, marques), chaque client doit avoir son propre WABA (WhatsApp Business Account) et son propre numéro. Whakup gère cette isolation nativement.

Flux d'onboarding d'un nouveau client :

1. Le client déclenche l'Embedded Signup depuis votre interface.
2. Whakup crée automatiquement un WABA dédié et associe le numéro.
3. Votre plateforme reçoit un webhook de confirmation avec le phone_number_id du nouveau client.
4. Vous stockez ce phone_number_id dans votre base et l'utilisez pour tous les envois de ce client.

Chaque appel API identifie ainsi le compte émetteur. Vos clients sont isolés, leurs templates et historiques sont séparés.

L'API WhatsApp Whakup expose un endpoint dédié pour lister et gérer les comptes clients associés à votre espace partenaire.

FAQ

Quelle différence entre l'API Cloud Meta et l'API Whakup ?

L'API Cloud Meta est l'infrastructure de base fournie par Meta. Whakup est une couche BSP au-dessus : elle simplifie l'authentification, ajoute le multi-tenant, l'Embedded Signup et le support. Vous appelez l'API Whakup ; Whakup gère la relation avec Meta. Voir la comparaison build vs buy WhatsApp API.

Comment tester sans envoyer de vrais messages ?

Whakup met à disposition un environnement sandbox avec un numéro de test préconfiguré. Les messages envoyés en sandbox ne sont pas facturés et ne partent pas vers de vrais destinataires. Idéal pour valider l'intégration avant la mise en production.

Que se passe-t-il si mon webhook est indisponible ?

Meta retente la livraison plusieurs fois sur une période pouvant aller jusqu'à 72 heures. Si votre endpoint ne répond pas, les messages entrants sont mis en file d'attente. Il est conseillé d'implémenter une file de traitement asynchrone côté plateforme pour absorber les pics.

Combien de messages par seconde peut-on envoyer ?

Le débit dépend du niveau de messagerie attribué au numéro WhatsApp. Un nouveau numéro commence à 1 000 conversations uniques par 24h (Tier 1) et monte automatiquement selon l'usage et la qualité. Whakup documente les niveaux et les conditions de passage dans son espace partenaire.

---

Vous êtes prêt à passer en production ? Whakup accompagne les éditeurs de plateformes SMS avec une API documentée, un support technique dédié et un Embedded Signup natif. Démarrez votre intégration WhatsApp avec Whakup.