WhatsApp pour les campagnes marketing via l'API : tutoriel pour les éditeurs

Envoyer une campagne marketing WhatsApp via l'API Business nécessite quatre étapes techniques distinctes : créer et faire approuver un template MARKETING, constituer une liste de contacts opt-in, déclencher les envois via l'API REST, et traiter les webhooks de statut pour mesurer les résultats. Ce tutoriel guide les équipes de développement d'éditeurs SaaS à travers chacune de ces étapes avec des exemples concrets.

Ce tutoriel suppose que votre plateforme dispose déjà d'un accès API Whakup actif et d'au moins un numéro WhatsApp Business configuré. Si ce n'est pas encore le cas, commencez par le guide complet de l'API WhatsApp Business pour les prérequis d'intégration.

Étape 1 — Créer et soumettre un template marketing

Un template MARKETING doit être soumis à Meta avant tout envoi. Il ne peut pas être modifié après approbation — soignez-le dès la première soumission.

Structure du template à préparer :

Nom du template : promo_soldes_ete_2026
Langue          : fr
Catégorie       : MARKETING

Header (optionnel) : [IMAGE] Visuel de la promotion

Body :
"Bonjour {{1}}, les soldes d'été sont là !
Profitez de -{{2}}% sur toute notre collection jusqu'au {{3}}.
Offre valable uniquement pour les membres."

Footer : "Répondez STOP pour vous désabonner."

Bouton CTA : "Voir les offres" → https://example.com/soldes?utm_source=wa&ref={{4}}

Points à respecter pour maximiser l'approbation :

• Le footer de désinscription est fortement recommandé (et obligatoire selon la loi française)
• Pas de numéro de téléphone dans le body
• Pas de promesse exagérée ("Devenez riche en 24h")
• La variable {{4}} dans le bouton URL permet un tracking individuel par envoi

La soumission se fait via l'API d'administration Whakup ou directement dans l'interface. Le retour de Meta prend généralement 24 à 48 heures pour les templates marketing.

Pour les règles détaillées par catégorie, consultez le guide des catégories de templates WhatsApp.

Étape 2 — Préparer la liste de contacts

Avant l'envoi, construisez votre liste d'envoi en filtrant sur les contacts ayant un opt-in WhatsApp marketing valide.

Format attendu pour chaque destinataire :

Champ	Format	Exemple
Numéro	International, sans espace	+33612345678
Variable 1	Texte libre	Marie
Variable 2	Texte libre	30
Variable 3	Texte libre	31 juillet 2026
Variable 4	Identifiant unique	cust_8471

Vérifications à effectuer avant envoi :

• Numéro au format E.164 (préfixe pays inclus, pas d'espace ni de tiret)
• Opt-in WhatsApp marketing actif et non révoqué
• Pas de doublon dans la liste (un même numéro contacté deux fois compte comme deux conversations Meta)
• Taille de la liste cohérente avec le tier actuel du numéro expéditeur

Étape 3 — Déclencher les envois via l'API REST

L'envoi d'un template marketing s'effectue par un appel POST sur l'endpoint /messages de l'API Whakup. Voici la structure de la requête pour un envoi individuel (à boucler pour votre liste) :

Corps de la requête (JSON) :

{
  "messaging_product": "whatsapp",
  "to": "+33612345678",
  "type": "template",
  "template": {
    "name": "promo_soldes_ete_2026",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "header",
        "parameters": [
          {
            "type": "image",
            "image": { "link": "https://cdn.example.com/soldes-header.jpg" }
          }
        ]
      },
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Marie" },
          { "type": "text", "text": "30" },
          { "type": "text", "text": "31 juillet 2026" }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          { "type": "text", "text": "cust_8471" }
        ]
      }
    ]
  }
}

Réponse API en cas de succès :

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "+33612345678", "wa_id": "33612345678" }],
  "messages": [{ "id": "wamid.AbCdEfGhIj123456" }]
}

Stockez le message_id retourné pour chaque envoi. Il servira à corréler les webhooks de statut avec vos enregistrements internes.

Gestion des erreurs courantes :

• 131026 : numéro non enregistré sur WhatsApp → fallback SMS
• 131047 : message marketing bloqué par l'utilisateur → retirer de la liste
• 130429 : limite de taux atteinte → attendre et réessayer avec backoff exponentiel

Étape 4 — Traiter les webhooks de statut

Whakup envoie des webhooks en temps réel vers votre endpoint configuré pour chaque changement de statut de message.

Événements à traiter :

Statut	Signification	Action recommandée
sent	Message envoyé vers Meta	Log de traçabilité
delivered	Message livré sur le téléphone	Incrémenter compteur délivrabilité
read	Message lu par le destinataire	Incrémenter compteur lecture
failed	Échec d'envoi	Log erreur + fallback selon code

Structure d'un webhook delivered :

{
  "object": "whatsapp_business_account",
  "entry": [{
    "changes": [{
      "value": {
        "statuses": [{
          "id": "wamid.AbCdEfGhIj123456",
          "status": "delivered",
          "timestamp": "1753900000",
          "recipient_id": "33612345678"
        }]
      }
    }]
  }]
}

Votre endpoint webhook doit répondre avec un HTTP 200 dans les 3 secondes. Au-delà, Whakup réessaie. Implémentez un traitement asynchrone (queue + worker) pour les campagnes à fort volume.

Mesurer et optimiser les résultats

Après chaque campagne, calculez vos métriques clés :

• Taux de délivrabilité = delivered / sent × 100
• Taux de lecture = read / delivered × 100
• Taux de réponse = contacts ayant répondu / delivered × 100
• Taux de conversion = clics CTA trackés / delivered × 100

Les benchmarks observés sur les marchés européens pour les campagnes marketing WhatsApp bien ciblées : 90 à 95 % de délivrabilité, 65 à 80 % de taux de lecture, 5 à 15 % de taux de réponse.

Si le taux de délivrabilité est inférieur à 85 %, vérifiez la qualité de votre base (numéros inactifs sur WhatsApp). Si le taux de lecture est inférieur à 50 %, testez un autre horaire d'envoi ou reformulez le header du template.

Pour comprendre comment Whakup positionne cette API dans un contexte multi-éditeur, consultez l'article sur le choix d'un BSP WhatsApp en France.

FAQ

Peut-on envoyer plusieurs campagnes le même jour avec le même numéro ?

Oui, dans la limite du tier du numéro. Chaque contact compte comme une conversation unique par 24 heures, quelle que soit le nombre de messages envoyés dans cette fenêtre. Envoyer deux messages marketing dans la même journée au même contact ne coûte qu'une conversation Meta côté facturation, mais double le risque de blocage.

Comment personnaliser l'image du header par destinataire ?

Les headers image dans les templates WhatsApp ne supportent pas les variables dynamiques dans l'URL de l'image directement dans le template soumis à Meta. En revanche, à l'envoi via l'API, vous pouvez fournir une URL d'image différente par destinataire dans le composant header.parameters. Cette approche permet une personnalisation visuelle sans re-soumettre le template.

Quel est le délai maximum entre l'envoi et la réception du webhook "delivered" ?

Dans la grande majorité des cas, le statut delivered arrive dans les secondes suivant l'envoi si l'appareil est connecté. Pour les téléphones hors ligne, WhatsApp stocke le message jusqu'à 30 jours. Vous recevrez le webhook delivered dès que l'appareil se reconnecte, ce qui peut représenter un délai de plusieurs jours.

Faut-il une certification Meta spécifique pour envoyer des campagnes marketing ?

Non, si vous passez par un Meta Tech Provider certifié comme Whakup. La certification Meta est portée par Whakup — vous n'avez pas à la passer vous-même ni à gérer les contrôles de conformité Meta directement. Votre équipe se concentre sur l'intégration produit, pas sur les démarches administratives Meta.

---

Prêt à intégrer les campagnes marketing WhatsApp dans votre plateforme ? Whakup fournit une API WhatsApp Business complète avec documentation, sandbox et support technique. En tant que Meta Tech Provider certifié, nous gérons la relation Meta pour vous. Contactez-nous pour démarrer.