WhatsApp pour le recouvrement de paiement via l'API : tutoriel pour les éditeurs

Ce tutoriel explique comment implémenter un système automatisé de recouvrement de paiement via l'API WhatsApp Business. Il couvre la création du template, l'envoi de la relance, la gestion des réponses et l'escalade progressive. Il s'adresse aux développeurs d'éditeurs SaaS de facturation, ERP ou plateformes fintech.

Étape 1 : Créer et soumettre le template utility

Le recouvrement se fait hors de la fenêtre de 24h (le client ne vous a pas écrit récemment). Tout message sortant doit donc être un template HSM approuvé par Meta, de catégorie utility.

Contenu du template de premier rappel :

Bonjour {{1}},

Votre facture n°{{2}} d'un montant de {{3}} € était due le {{4}}.

Elle n'apparaît pas encore comme réglée dans notre système. Régularisez votre situation en quelques secondes.

Avec :

• Un bouton d'appel à l'action de type url : "Payer en ligne" → https://paiement.votreplateforme.com/facture/{{5}}
• Un bouton de réponse rapide : "J'ai déjà payé"
• Un bouton de réponse rapide : "Contacter le service client"

Soumission du template via le Meta Business Manager ou l'API :

Si vous utilisez Whakup comme Meta Tech Provider, la soumission se fait via le dashboard partenaire ou l'API Whakup. Vous n'avez pas besoin d'un accès direct au Meta Business Manager. Le délai d'approbation est généralement de quelques heures pour les templates utility bien structurés.

Pour les règles de structure des templates, consulter l'article sur les catégories de templates WhatsApp.

Étape 2 : Identifier les factures éligibles et envoyer la relance

Votre système détecte chaque nuit (ou en temps réel) les factures dont l'échéance est dépassée et qui n'ont pas encore déclenché de relance WhatsApp.

Critères d'éligibilité :

• Facture impayée depuis X jours (selon votre politique : 1, 3, 7 jours)
• Client avec numéro WhatsApp validé en base et opt-in actif
• Aucune relance WhatsApp envoyée dans les dernières 48h pour cette facture

Appel API pour envoyer le template :

POST /v19.0/{phone-number-id}/messages
{
  "messaging_product": "whatsapp",
  "to": "33612345678",
  "type": "template",
  "template": {
    "name": "relance_facture_v1",
    "language": { "code": "fr" },
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "Martin" },
          { "type": "text", "text": "2026-0892" },
          { "type": "text", "text": "1 240,00" },
          { "type": "text", "text": "01/08/2026" }
        ]
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": "0",
        "parameters": [
          { "type": "text", "text": "2026-0892" }
        ]
      }
    ]
  }
}

Log à enregistrer en base pour chaque envoi :

Champ	Valeur
invoice_id	ID de la facture
phone_number	Numéro destinataire
template_name	Nom du template utilisé
sent_at	Timestamp d'envoi
message_id	ID de message renvoyé par Meta
level	Niveau de relance (1, 2, 3…)
status	sent, delivered, read, failed

Étape 3 : Gérer les webhooks de statut et de réponse

Votre endpoint webhook reçoit deux types d'événements :

A — Statuts de livraison :

{
  "statuses": [{
    "id": "wamid.xxxx",
    "status": "delivered",
    "timestamp": "1723750800",
    "recipient_id": "33612345678"
  }]
}

Mettez à jour le champ status en base pour chaque message_id correspondant.

B — Réponses du débiteur :

Quand le débiteur clique sur "J'ai déjà payé" :

{
  "messages": [{
    "from": "33612345678",
    "type": "interactive",
    "interactive": {
      "type": "button_reply",
      "button_reply": {
        "id": "btn_already_paid",
        "title": "J'ai déjà payé"
      }
    }
  }]
}

Logique de traitement selon la réponse :

Réponse reçue	Action déclenchée
Clic "Payer en ligne"	Logger le clic, surveiller paiement reçu
"J'ai déjà payé"	Notifier le service comptabilité pour vérification
"Contacter le service client"	Créer un ticket support et notifier un agent
Message texte libre	Ouvrir la conversation en mode human handoff
Aucune réponse sous 48h	Planifier relance niveau 2

Étape 4 : Implémenter l'escalade progressive

Un système de recouvrement efficace gère l'escalade automatiquement selon l'ancienneté de l'impayé.

Politique d'escalade recommandée :

J+1 après échéance  → Niveau 1 : rappel amiable (template relance_facture_v1)
J+7 sans réponse    → Niveau 2 : relance ferme (template relance_ferme_v1)
J+15 sans réponse   → Niveau 3 : mise en demeure (template mise_en_demeure_v1)
J+30 sans réponse   → Passage au canal humain ou contentieux

Chaque niveau a son propre template soumis et approuvé par Meta. Le ton progresse de neutre à ferme. À partir du niveau 2, vérifiez que la facture n'a pas été réglée entre-temps avant l'envoi.

Annulation automatique :

Quand le paiement est reçu dans votre système, déclenchez immédiatement l'annulation de toutes les relances planifiées pour cette facture. Un message de confirmation peut être envoyé en bonus : "Votre paiement de X € a bien été reçu. Merci."

Étape 5 : Tableaux de bord et métriques

Pour piloter l'efficacité du recouvrement WhatsApp, suivez ces métriques :

• Taux de livraison : messages delivered / messages sent
• Taux de lecture : messages read / messages delivered
• Taux de réponse : messages avec réponse du débiteur / messages read
• Taux de régularisation : factures payées après relance WhatsApp / total relances envoyées
• Délai moyen de régularisation : temps entre envoi de la relance et réception du paiement

Ces métriques permettent d'optimiser la politique de relance (délais, nombre de niveaux, ton des templates). Consultez le guide de l'API WhatsApp Business pour comprendre comment structurer l'infrastructure de webhooks qui alimente ces tableaux.

FAQ

Faut-il un numéro WhatsApp Business dédié au recouvrement ou peut-on utiliser le numéro général ?

Les deux sont possibles. Un numéro dédié au recouvrement présente l'avantage d'isoler le score de qualité : si les relances génèrent des blocages, cela n'affecte pas le numéro utilisé pour la communication client standard. Pour les éditeurs multi-tenant, chaque client peut avoir son numéro dédié via l'API Whakup multi-numéros.

Comment éviter que les relances WhatsApp soient perçues comme du spam ?

Trois facteurs clés : fréquence raisonnable (pas plus d'une relance tous les 3-5 jours), ton professionnel non agressif, et facilité de réponse (boutons d'action clairs). Les comptes qui génèrent trop de signalements "spam" voient leur score de qualité baisser et leurs limites de messagerie réduites.

Peut-on personnaliser le lien de paiement dans le template pour chaque facture ?

Oui. Les boutons de type url dans les templates supportent une variable dynamique dans l'URL. Vous passez l'identifiant unique de la facture comme variable, ce qui génère un lien de paiement personnalisé pour chaque destinataire. C'est le mécanisme décrit dans l'étape 2 de ce tutoriel.

Le coût par relance WhatsApp est-il justifié par rapport à l'email ?

Pour un message utility en France : 0,0336 € (Whakup 0,0088 € + Meta 0,0248 €). Si une relance WhatsApp évite un cycle de recouvrement de 30 jours supplémentaires sur une facture de plusieurs centaines d'euros, le ROI est évident. L'email peut coûter moins cher à l'envoi, mais son taux d'ouverture sur les relances financières est bien inférieur. Voir le détail tarifaire dans prix de l'API WhatsApp Business 2026.

---

Ce tutoriel couvre l'implémentation complète d'un module de recouvrement WhatsApp. Pour l'accès à l'API sans certification Meta, en marque blanche et avec hébergement EU, Whakup est l'infrastructure adaptée aux éditeurs SaaS qui veulent déployer ce cas d'usage rapidement.