API WhatsApp pour les intégrateurs : cas pratique 2026

Intégrer l'API WhatsApp Business dans une plateforme existante pose des questions concrètes : comment gérer plusieurs comptes clients, comment facturer les coûts Meta, comment garantir la conformité RGPD. Ce cas pratique décrit l'intégration réalisée par un éditeur de CRM pour PME qui a ajouté WhatsApp comme canal natif à son produit.

Le contexte : un CRM pour PME qui veut proposer WhatsApp

Un éditeur de CRM SaaS destiné aux PME françaises constate une demande croissante : ses clients veulent envoyer des messages WhatsApp directement depuis leur fiche contact, sans jongler entre plusieurs outils. Objectif : WhatsApp comme canal de communication intégré, au même titre que l'email et le SMS déjà présents.

Contraintes techniques et business :

• Multi-tenant strict : chaque client CRM doit avoir son propre numéro WhatsApp, ses propres templates, sans aucune fuite de données entre comptes.
• Marque blanche : WhatsApp doit apparaître comme une fonctionnalité native du CRM, sans mention visible d'un tiers.
• Hébergement EU : le CRM est certifié RGPD, l'ensemble de la chaîne doit rester en Europe.
• Pas de surcharge R&D : l'équipe technique est réduite. Pas question de maintenir une connexion directe à l'API Meta.

BSP retenu : Whakup, pour son statut de Meta Tech Provider certifié, son hébergement EU, son embedded signup et son API multi-tenant.

Architecture mise en place

Onboarding d'un nouveau client WhatsApp

L'embedded signup Whakup a été intégré directement dans le wizard d'activation du canal WhatsApp côté CRM. Le flux se déroule en trois clics pour le client final :

1. Le client clique sur "Activer WhatsApp" dans son interface CRM.
2. Une fenêtre modale charge le flux OAuth Meta via Whakup. Le client connecte son compte Meta Business et vérifie son numéro de téléphone.
3. Whakup retourne un phone_number_id et un token. Le CRM les stocke chiffrés dans sa base, associés au compte client.

L'activation est effective en moins de 24 heures. Le client n'a jamais vu le nom Whakup.

Envoi de messages depuis la fiche contact

Depuis la fiche contact, un agent CRM sélectionne "Envoyer un WhatsApp". Une modale propose les templates approuvés pour ce compte client, avec les champs de personnalisation à remplir.

Le backend CRM appelle l'API Whakup :

POST https://api.whakup.com/v1/messages
Authorization: Bearer <token_du_client>
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "<numéro_du_contact>",
  "type": "template",
  "template": {
    "name": "relance_devis_fr",
    "language": { "code": "fr" },
    "components": [...]
  }
}

Le wamid retourné est stocké dans le fil de conversation CRM. Les statuts (livré, lu) arrivent via webhook et mettent à jour l'affichage en temps réel dans l'interface.

Réception et affichage des réponses

Un endpoint webhook unique reçoit tous les événements Whakup pour l'ensemble des clients. Le phone_number_id présent dans chaque payload identifie le compte client concerné. Le message entrant est routé vers le bon fil de conversation CRM.

Flux	Volume estimé	Latence observée
Envoi de message sortant	~500/jour (ensemble des clients)	< 500ms
Réception webhook entrant	~200/jour	< 1s (handler async)
Mise à jour statut livraison	~1 500/jour	< 200ms

Modèle de facturation adopté

L'éditeur CRM facture WhatsApp à ses clients de deux manières :

• Abonnement mensuel fixe pour le droit d'accès au canal (inclus dans le plan "Pro").
• Facturation à l'usage pour les messages : refacturation des coûts Whakup + Meta avec une marge de 20 %.

Whakup fournit un export mensuel des consommations par phone_number_id. L'éditeur l'importe dans son système de facturation pour générer les lignes de coût par client.

Coût brut de référence pour les clients PME français :

• Message marketing : ~0,08 €
• Message utility/relance commerciale : ~0,0336 €

Pour le détail de la structure tarifaire, consultez l'article sur les prix de l'API WhatsApp Business en 2026.

Difficultés rencontrées et solutions

Problème 1 — Gestion des templates par client

Chaque client CRM a son propre compte Meta Business avec ses propres templates. L'éditeur a dû créer une interface de gestion des templates dans le CRM, avec soumission à Meta via l'API Whakup et suivi du statut d'approbation. Sans cela, les clients auraient dû gérer leurs templates dans Meta Business Manager, ce qui rompait l'expérience marque blanche.

Problème 2 — Taux d'échec sur les numéros non WhatsApp

Environ 15 % des contacts dans les CRM PME n'ont pas WhatsApp sur leur numéro. Les appels API retournent une erreur 131026. L'éditeur a ajouté une étape de validation préalable et un indicateur visuel "WhatsApp disponible" sur les fiches contact.

Problème 3 — Conformité opt-in

Meta exige un consentement explicite avant d'envoyer des messages marketing. L'éditeur a intégré un champ "opt-in WhatsApp" dans ses formulaires de contact et ajouté un filtre automatique dans l'envoi de templates marketing pour exclure les contacts sans opt-in.

Pour les bonnes pratiques d'intégration et les critères de choix d'un BSP, le guide sur le Meta Tech Provider WhatsApp est une lecture utile.

FAQ

Combien de temps a pris l'intégration complète ?

Dans ce cas pratique, l'intégration a pris environ 6 semaines : 2 semaines pour le backend (API + webhooks + multi-tenant), 2 semaines pour l'interface utilisateur (gestion des templates, fil de conversation), 2 semaines de tests et ajustements. Une équipe de 2 développeurs.

Faut-il un contrat spécifique avec Whakup pour la marque blanche ?

Oui. Whakup propose un contrat partenaire pour les éditeurs qui souhaitent revendre l'accès WhatsApp en marque blanche. Ce contrat précise les conditions de facturation, de support et d'utilisation du logo Meta.

Comment garantir l'isolation des données entre clients CRM ?

Whakup isole les données par phone_number_id. Côté CRM, l'éditeur stocke les tokens dans une colonne chiffrée de sa base de données, avec un accès applicatif restreint à chaque contexte client. Les webhooks entrants sont routés par phone_number_id avant tout traitement.

L'intégration fonctionne-t-elle avec les numéros WhatsApp existants des clients ?

Oui, à condition que le numéro ne soit pas déjà sur WhatsApp Business App (il faut le migrer). L'embedded signup Whakup guide le client dans ce processus de migration, qui entraîne la suppression de l'accès via l'application mobile standard.

---

Vous souhaitez ajouter WhatsApp en canal natif à votre plateforme ? L'API WhatsApp Whakup est conçue pour les intégrateurs avec un modèle marque blanche, hébergement EU et support technique dédié. Contactez-nous pour discuter de votre cas.