API WhatsApp pour les plateformes de fidélité : tutoriel 2026

Intégrer l'API WhatsApp dans une plateforme de fidélité se résume à trois actions techniques : configurer un compte WhatsApp Business via un BSP, créer et faire approuver des templates, puis câbler les appels API aux événements métier de votre plateforme. Ce tutoriel couvre chaque étape dans l'ordre, avec les points d'attention spécifiques aux éditeurs de solutions de fidélisation.

Étape 1 — Onboarding du compte WhatsApp Business

Avant d'envoyer le premier message, votre client (la marque qui utilise votre plateforme) doit disposer d'un compte WhatsApp Business API (WABA). Avec Whakup, le processus utilise l'embedded signup : votre client connecte son compte Meta Business directement depuis votre interface, sans quitter votre plateforme.

Les prérequis côté client sont :

• Un compte Meta Business Manager vérifié
• Un numéro de téléphone non encore enregistré sur WhatsApp (fixe ou mobile)
• Un display name conforme aux règles Meta (nom de la marque reconnaissable)

Une fois le WABA créé, Whakup vous retourne un waba_id et un phone_number_id. Ces deux identifiants sont indispensables pour tous les appels API suivants.

Pour bien paramétrer l'application Meta associée à votre intégration, consultez notre guide sur la création d'une app Meta pour l'API WhatsApp.

Étape 2 — Créer et soumettre vos templates HSM

L'API WhatsApp impose d'utiliser des templates pré-approuvés par Meta pour toute communication sortante initiée par la plateforme (hors conversation active). Voici comment structurer les templates les plus courants pour un programme de fidélité.

Exemple — Notification de crédit de points (catégorie utility) :

Bonjour {{1}}, vous venez de recevoir {{2}} points suite à votre achat du {{3}}.
Votre solde actuel : {{4}} points.
Consultez vos avantages : {{5}}

Les variables {{1}} à {{5}} sont injectées dynamiquement à l'envoi. Meta évalue le template sur sa structure, pas sur les valeurs réelles.

Points clés lors de la soumission :

• Choisir la catégorie utility pour les messages transactionnels (moins cher que marketing)
• Rédiger le corps en minuscules, sans majuscules excessives (critère de rejet fréquent)
• Prévoir une version sans bouton et une avec bouton CTA si vous souhaitez rediriger vers votre app

Le délai d'approbation est généralement inférieur à 24 heures pour les templates utility bien formés.

Étape 3 — Câbler les événements métier aux appels API

Une fois le template approuvé, l'envoi se fait via un appel POST à l'endpoint de l'API Cloud Meta :

POST https://graph.facebook.com/v19.0/{phone_number_id}/messages
Authorization: Bearer {access_token}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "33XXXXXXXXX",
  "type": "template",
  "template": {
    "name": "points_credites",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Marie" },
          { "type": "text", "text": "150" },
          { "type": "text", "text": "12/07/2026" },
          { "type": "text", "text": "2 340" },
          { "type": "text", "text": "https://fidelite.marque.fr/compte" }
        ]
      }
    ]
  }
}

Dans votre plateforme de fidélité, cet appel doit être déclenché par l'événement transaction.validated de votre backend. Vous pouvez le placer dans un worker asynchrone pour ne pas bloquer le flux de paiement.

Étape 4 — Gérer les statuts de livraison et les réponses

L'API retourne les statuts de livraison via des webhooks configurés lors de l'onboarding. Trois statuts sont essentiels à tracer :

Statut	Signification	Action recommandée
sent	Message transmis à Meta	Log, pas d'action
delivered	Message délivré sur l'appareil	Log, KPI de délivrabilité
read	Message lu par le destinataire	Indicateur d'engagement
failed	Échec d'envoi (numéro invalide, limite dépassée…)	Alerte + fallback SMS/email

Si votre client répond à la notification, le webhook messages.received est déclenché. Vous pouvez router cette réponse vers un agent de service client ou un flux conversationnel automatisé dans votre plateforme.

Pour approfondir la configuration des webhooks, notre article sur la réception et configuration des webhooks WhatsApp API détaille les paramètres de sécurité et les bonnes pratiques de retry.

FAQ

Comment tester l'intégration avant de la mettre en production ?

Whakup propose un environnement sandbox qui permet d'envoyer des messages de test vers des numéros whitelistés sans consommer de messages facturables. C'est l'environnement à utiliser pendant la phase de développement et les recettes QA.

Que se passe-t-il si un membre n'a pas WhatsApp sur son téléphone ?

L'API retourne une erreur 131026 (numéro non enregistré sur WhatsApp). Votre plateforme doit prévoir un fallback : SMS ou email selon la disponibilité des coordonnées du membre.

Peut-on envoyer des messages en plusieurs langues depuis la même plateforme ?

Oui. Il suffit de créer un template par langue cible et de sélectionner le bon language.code lors de l'appel API. Les templates sont indépendants par langue dans la console Meta.

Combien de messages peut-on envoyer par jour au démarrage ?

Le niveau de messagerie initial est de 1 000 conversations uniques par tranche de 24 heures. Ce plafond monte automatiquement à 10 000 puis 100 000 en fonction du volume envoyé et du quality score du numéro.

---

En suivant ces quatre étapes, votre plateforme de fidélité peut envoyer des notifications WhatsApp en production en moins d'une semaine. Pour accéder à l'API WhatsApp Business via Whakup et bénéficier de l'embedded signup, de l'hébergement EU et du support technique dédié, contactez notre équipe pour un démarrage rapide.