Relier WhatsApp à votre logiciel métier avec la Cloud API de Meta

Qui peut brancher la Cloud API, et avec quel statut ?

Un logiciel métier se connecte à la WhatsApp Business Platform de Meta. Selon sa documentation, la Cloud API envoie les messages (texte, image, document, localisation, listes et boutons de réponse) depuis un numéro professionnel enregistré, et des webhooks transmettent au logiciel les messages des clients et les statuts de livraison.

Pour une PME qui relie son propre logiciel, le premier profil suffit. YMHB Web intervient sans statut de Tech Provider ni de Solution Partner, inutile dans ce cas : l'application Meta et le compte WhatsApp Business sont créés dans votre propre portefeuille d'entreprise, à votre nom.

La fenêtre de 24 heures et les modèles : la règle qui structure tout

Quand un client écrit ou appelle votre numéro WhatsApp, une fenêtre de service client de 24 heures s'ouvre, relancée par chacun de ses nouveaux messages. Dans cette fenêtre, votre logiciel envoie librement des messages de service : texte, image, document, localisation, liste ou boutons de réponse (trois au plus). Hors fenêtre, seuls des modèles préparés à l'avance et approuvés par Meta peuvent partir, dans trois catégories : marketing, utilitaire (utility) et authentification. Dans tous les cas, le destinataire doit avoir accepté de recevoir vos messages.

Le logiciel doit donc mémoriser, pour chaque client, l'heure de son dernier message pour choisir entre message libre et modèle, connaître les modèles approuvés et leurs variables, et tracer l'accord du client (opt-in) avec sa date et sa source.

Combien coûte un message WhatsApp depuis juillet 2025 ?

Depuis le 1er juillet 2025, Meta facture par message et non plus par conversation : seul un message de modèle est facturé, et seulement s'il est livré, à un tarif qui dépend de sa catégorie et de l'indicatif du pays du destinataire. Selon la page de tarification de Meta :

• les messages hors modèle envoyés dans la fenêtre de service sont gratuits, tout comme les modèles utilitaires envoyés dans cette fenêtre ;
• un client qui écrit depuis une publicité « Click to WhatsApp » ou un bouton de page Facebook ouvre, si l'entreprise répond dans les 24 heures, 72 heures de messages gratuits ;
• les tarifs ne changent qu'au 1er janvier, avril, juillet ou octobre, avec un préavis d'au moins un mois ;
• la grille est publiée dans 16 devises, dont l'euro, et les tarifs marketing pour la France ont baissé au 1er janvier 2026.

Pour un service après-vente, la plupart des échanges sont donc gratuits ; ce sont les relances à l'initiative de l'entreprise, hors fenêtre, qui coûtent. Le montant par catégorie se lit dans la grille officielle au moment du cadrage.

Jetons d'accès, débit et plafonds d'envoi

Le jeton temporaire du tableau de bord expire vite et ne sert qu'au premier essai. Pour la production, Meta oriente vers un utilisateur système et son jeton longue durée, avec trois permissions : business_management, whatsapp_business_management et whatsapp_business_messaging ; l'utilisateur système doit aussi avoir accès au compte WhatsApp Business visé.

Le palier de 2 000 se débloque par la vérification de l'entreprise, ou par 2 000 messages de modèle de bonne qualité livrés à des numéros uniques sur 30 jours glissants. Ensuite, la hausse est automatique si la qualité reste bonne et si l'entreprise utilise au moins la moitié de sa limite sur 7 jours. Ces plafonds sont partagés par tous les numéros du portefeuille. Au-delà du débit autorisé, l'API renvoie l'erreur 130429 jusqu'au retour sous le seuil : le connecteur ralentit au lieu de renvoyer aussitôt.

Webhooks WhatsApp : ce qui arrive et comment le contrôler

Les messages des clients, les statuts de livraison et les erreurs asynchrones arrivent par webhook, en JSON. Le champ messages couvre messages reçus et statuts ; d'autres champs signalent l'état des modèles, les alertes du compte ou la qualité du numéro.

1. Vérification de l'adresse : à l'abonnement, Meta envoie une requête GET avec hub.mode, hub.challenge et hub.verify_token ; le logiciel compare le jeton à sa valeur secrète et renvoie hub.challenge.
2. Contrôle de chaque message : l'en-tête X-Hub-Signature-256 porte un HMAC-SHA256 du corps, calculé avec le secret de l'application ; un écart signale un message à rejeter.
3. Certificat : un certificat TLS valide est obligatoire ; Meta accepte aussi le mTLS, qu'il recommande plutôt qu'une liste d'adresses IP, ces adresses changeant périodiquement.
4. Doublons : un message non acquitté par un code 200 est relancé à fréquence décroissante pendant 7 jours au plus, puis abandonné ; les relances peuvent créer des doublons, et une charge utile peut atteindre 3 Mo.

L'application Meta doit être en mode Live : en mode développement, certains webhooks ne partent pas.

Cinq conversations WhatsApp branchées sur un logiciel métier

1. Demande de SAV. Un client envoie la photo de son équipement en panne. Le webhook crée un ticket rattaché à sa fiche par le numéro de téléphone ; le technicien répond depuis le logiciel, sans frais tant que la fenêtre est ouverte. Voir notre page pour centraliser les demandes clients.
2. Confirmation de rendez-vous. La prise de rendez-vous déclenche un modèle utilitaire avec la date et l'adresse. Si le client répond, la fenêtre s'ouvre et le logiciel lui propose trois boutons : « Je confirme », « Je décale », « J'annule ». Le planning se met à jour.
3. Avis d'expédition. L'étiquette créée, un modèle utilitaire part avec le numéro de suivi ; une réponse du client pour changer de point de livraison arrive dans le dossier de la commande.
4. Devis en PDF. Dans la fenêtre ouverte par la demande du client, le commercial envoie le devis comme document, et les statuts de livraison remontent dans l'affaire.
5. Code de connexion. Un portail client envoie un code à usage unique par un modèle de la catégorie authentification.

Organisation, consentement et alternatives à l'intégration directe

Ouvrir WhatsApp aux clients crée un canal de plus à tenir : qui répond, à quelles heures, où les messages sont conservés. Meta exige l'accord du client avant tout modèle ; pour l'e-mail et le SMS, la CNIL rappelle de son côté qu'une prospection vers des particuliers suppose un consentement préalable, avec dans chaque message l'identité de l'émetteur et un moyen simple de refuser la suite. Nous appliquons la même prudence aux modèles marketing WhatsApp. Numéros, messages et pièces jointes sont des données personnelles dont la durée de conservation se fixe dans le logiciel (voir combien de temps conserver les données clients).

L'intégration directe n'est pas la seule voie. Si le besoin se limite à une boîte de réception partagée pour l'équipe commerciale, l'outil d'un fournisseur de solutions WhatsApp peut suffire. L'intégration au logiciel métier se justifie quand les conversations créent ou mettent à jour des dossiers (tickets, commandes, rendez-vous) et quand les envois partent d'événements de votre activité.

Ce que YMHB Web met en service

Nous cadrons les conversations (qui écrit, quels modèles, quelles catégories, quel volume hors fenêtre), puis nous chiffrons. Le développement commence avec le numéro de test proposé dans le tableau de bord de Meta, puis passe sur votre numéro professionnel enregistré.

• l'application Meta, le compte WhatsApp Business et l'utilisateur système dans votre portefeuille d'entreprise ;
• les modèles rédigés avec vous et soumis à l'approbation de Meta ;
• le point de réception des webhooks, avec vérification de signature, dédoublonnage et file d'attente ;
• le code, documenté et déposé chez vous, et un journal de chaque message envoyé ou reçu ;
• le suivi de la qualité du numéro et des nouvelles versions de l'API.

Les autres canaux de messages sont traités sur nos pages Twilio et Brevo.