API WhatsApp pour les intégrateurs : FAQ 2026

Les intégrateurs qui ajoutent WhatsApp à une plateforme SaaS, un CRM ou un outil martech font face à des questions techniques et business précises. Certification Meta, gestion multi-tenant, webhooks, tarification, conformité RGPD : voici les réponses directes pour les développeurs et décideurs techniques.

Questions sur la certification et le modèle BSP

Faut-il être certifié Meta Tech Provider pour intégrer l'API WhatsApp Business ?

Non. La certification Meta Tech Provider (anciennement BSP) est détenue par Whakup. En tant qu'intégrateur, vous accédez à l'API via Whakup, qui gère la relation avec Meta en votre nom. Vous n'avez aucun processus de certification à passer, aucun contrat direct avec Meta à négocier.

Quelle est la différence entre un BSP et un intégrateur ?

Le BSP (Business Solution Provider) est certifié Meta et fournit l'accès à l'API. Whakup est un Meta Tech Provider certifié. L'intégrateur est l'éditeur ou l'agence qui construit un produit au-dessus de l'API du BSP. Un même acteur peut être à la fois intégrateur (il construit un produit) et revendeur (il propose l'accès WhatsApp à ses propres clients). Pour comprendre les différents rôles dans l'écosystème, lisez notre article sur le Meta Tech Provider WhatsApp.

Peut-on passer directement par l'API Meta sans BSP ?

Techniquement oui, via l'accès développeur direct à l'API Cloud Meta. Mais cela requiert une application Meta approuvée, une gestion en propre des tokens, des webhooks et de l'infrastructure. Pour un éditeur qui veut proposer WhatsApp à plusieurs clients, le modèle BSP est quasi systématiquement plus rapide et moins coûteux à maintenir. Le guide build vs. buy sur l'API WhatsApp analyse ce choix en détail.

Questions sur l'architecture multi-tenant

Comment isoler les données de chaque client dans une architecture multi-tenant ?

Whakup attribue un phone_number_id distinct à chaque numéro activé. Ce paramètre est présent dans tous les appels API sortants et dans tous les payloads webhook entrants. Côté plateforme intégrateur, il suffit de stocker ce phone_number_id par compte client et de l'utiliser comme clé de routage.

Chaque client peut également avoir ses propres templates Meta (liés à son compte Meta Business). L'isolation des données est donc complète : templates, numéros, historique de messages.

Peut-on utiliser un seul endpoint webhook pour tous les clients ?

Oui, c'est même l'approche recommandée. Un seul endpoint reçoit les événements de tous vos numéros clients. Le payload contient toujours le phone_number_id qui permet d'identifier le client concerné et de router le traitement. Cette approche simplifie la configuration et la maintenance.

Y a-t-il une limite au nombre de numéros gérés sous un compte Whakup ?

Non, il n'y a pas de limite technique imposée par Whakup sur le nombre de numéros actifs. Les limites d'envoi sont par numéro (liées au quality rating Meta), pas par compte opérateur. Contactez Whakup pour les conditions commerciales au-delà d'un certain volume.

Questions techniques sur l'API et les webhooks

Quelle est la structure d'authentification de l'API Whakup ?

Whakup utilise l'authentification par token Bearer. Le header à inclure dans chaque requête est Authorization: Bearer <votre_token>. Les tokens sont permanents (pas d'expiration) et révocables manuellement depuis le tableau de bord. Stockez-les chiffrés dans votre base de données ou dans un secret manager.

Comment gérer les retransmissions de webhooks en cas d'erreur ?

Si votre endpoint webhook ne répond pas avec un HTTP 200 en moins de 3 secondes, Whakup considère la livraison comme échouée et retente. Votre handler doit impérativement répondre 200 immédiatement (avant tout traitement) et traiter l'événement de manière asynchrone. Pour éviter les doublons, implémentez une vérification de l'ID de message déjà traité (idempotence).

L'API Whakup supporte-t-elle les messages riches (images, PDF, boutons) ?

Oui. L'API supporte les types de messages suivants :

Type	Description
`text`	Message texte simple
`template`	Template approuvé avec variables et composants media
`image`	Image avec légende optionnelle
`document`	PDF, Word, Excel avec nom de fichier
`video`	Vidéo MP4
`audio`	Message vocal
`interactive`	Boutons de réponse rapide ou liste de sélection
`location`	Partage de localisation

Les messages interactive (boutons, listes) ne peuvent être envoyés qu'en réponse à un message entrant dans la fenêtre de 24 heures, ou via des templates avec composants interactifs approuvés par Meta.

Questions sur les tarifs et la facturation

Comment se décompose le coût d'un message WhatsApp pour un intégrateur ?

Deux lignes de coût :

Frais Whakup : 0,0088 €/message, quel que soit le type ou la destination.
Frais Meta : variables selon la catégorie du message et le pays du destinataire. Pour un numéro français : 0,0712 €/message marketing, 0,0248 €/message utility.

Total pour un message marketing vers un numéro FR : ~0,08 €. Pour un message utility : ~0,0336 €. Pour les détails par pays et catégorie, consultez l'article sur les prix de l'API WhatsApp Business en 2026.

Comment refacturer ces coûts à ses propres clients ?

Whakup fournit un export mensuel détaillé des consommations par phone_number_id. Vous pouvez importer cet export dans votre système de facturation pour générer des lignes de coût individuelles par client. La plupart des éditeurs adoptent un modèle mixte : abonnement fixe + refacturation à l'usage avec une marge.

Questions sur la conformité RGPD

Les données transitant par Whakup restent-elles en Union Européenne ?

Oui. Whakup héberge son infrastructure en Union Européenne. Les métadonnées des messages (numéros, statuts, timestamps) sont stockées en UE. Le contenu des messages est traité par l'API Cloud Meta, dont les serveurs peuvent être hors UE selon la région Meta. Whakup documente ces flux dans ses mentions légales et son DPA disponible sur demande.

Whakup fournit-il un DPA (Data Processing Agreement) pour la conformité RGPD ?

Oui. Whakup signe un DPA avec ses partenaires intégrateurs sur demande. Ce document formalise les rôles de responsable de traitement et de sous-traitant, les obligations de sécurité et les procédures en cas de violation de données.

D'autres questions sur l'intégration de WhatsApp à votre plateforme ? Consultez la documentation complète de l'API WhatsApp Whakup ou contactez notre équipe technique. Nous accompagnons les intégrateurs de la phase de conception jusqu'à la mise en production.