Aller au contenu principal

API WhatsApp pour les outils de marketing automation : FAQ 2026

FAQ complète sur l'API WhatsApp Business pour le marketing automation : déclencheurs, fenêtre de conversation, opt-in, templates, coûts et gestion multi-tenant.

Les éditeurs d'outils de marketing automation qui intègrent l'API WhatsApp Business rencontrent des questions spécifiques à leur contexte : gestion de la fenêtre de 24 heures, opt-in dans des workflows automatisés, sélection des templates selon le type d'action, ou encore scalabilité multi-client. Cette FAQ regroupe les réponses les plus demandées par les CTOs et lead devs d'éditeurs SaaS.

Questions sur les déclencheurs et la logique de workflow

Peut-on déclencher un workflow depuis un message WhatsApp entrant ?

Oui. Chaque message reçu d'un contact déclenche un événement webhook messages sur votre endpoint configuré. Votre moteur d'automation peut consommer cet événement comme un trigger et démarrer ou relancer un workflow associé au numéro expéditeur. Cette logique permet de créer des parcours conversationnels : le contact envoie un mot-clé (par exemple « INFO ») et reçoit automatiquement une séquence d'informations.

Comment gérer la fenêtre de conversation de 24 heures dans les workflows ?

La fenêtre de service de 24 heures s'ouvre à chaque message entrant du contact et se ferme 24 heures après le dernier message reçu. Pendant cette fenêtre, vous pouvez envoyer des messages libres (hors template). En dehors, seuls les templates approuvés sont autorisés.

Dans votre moteur d'automation, stockez le champ last_inbound_whatsapp pour chaque contact et vérifiez-le avant chaque nœud d'envoi. Si la fenêtre est ouverte, vous avez plus de flexibilité sur le contenu. Si elle est fermée, sélectionnez le template approprié.

Les workflows WhatsApp peuvent-ils être entièrement asynchrones ?

Oui, c'est même la recommandation. Placez les appels API WhatsApp dans une file de messages asynchrone (Redis Queue, RabbitMQ, SQS…) pour découpler le moteur d'automation du canal d'envoi. Cela vous permet de gérer les retries, de respecter les rate limits et de ne pas bloquer l'exécution du workflow en cas d'erreur temporaire.

Questions sur les templates et les contenus

Comment intégrer la bibliothèque de templates WhatsApp dans l'interface de mon outil ?

Appelez GET /v19.0/{waba_id}/message_templates?status=APPROVED avec le Bearer token du client. Récupérez la liste des templates approuvés et exposez-la dans votre éditeur de workflow. Mettez à jour cette liste périodiquement (ou via un webhook Meta lors d'un changement de statut) pour que les utilisateurs voient toujours les templates disponibles.

Peut-on proposer à ses clients de créer et soumettre des templates depuis l'outil ?

Oui. L'API Meta permet de créer des templates programmatiquement via POST /v19.0/{waba_id}/message_templates. Vous pouvez intégrer un éditeur de templates dans votre interface, valider la structure côté client avant soumission, puis appeler l'API Meta pour la création et suivre le statut d'approbation.

Quelle catégorie choisir pour les messages d'automation : utility ou marketing ?

La règle est simple : si le message est déclenché par une action ou un comportement du contact (achat, inscription, abandon de panier, inactivité), c'est probablement utility. Si le message contient une promotion ou une offre commerciale non liée à une transaction, c'est marketing.

Type de message automation Catégorie Coût (FR)
Confirmation d'inscription Utility ~0,034 €/msg
Rappel de rendez-vous Utility ~0,034 €/msg
Notification d'expiration Utility ~0,034 €/msg
Relance panier abandonné avec offre Marketing ~0,08 €/msg
Campagne de réengagement Marketing ~0,08 €/msg
Code promo personnalisé Marketing ~0,08 €/msg

Pour une compréhension approfondie des catégories, notre guide sur les catégories de templates WhatsApp détaille les critères de classification Meta et les conséquences tarifaires.

Questions sur l'opt-in et la conformité

Comment collecter l'opt-in WhatsApp dans les workflows d'inscription ?

L'opt-in doit être recueilli avant le premier message WhatsApp initié par la plateforme. Les méthodes conformes :

  • Case à cocher explicite sur le formulaire d'inscription (non pré-cochée)
  • Confirmation par SMS ou email avec lien d'activation du canal WhatsApp
  • Interaction en boutique ou lors d'un événement avec signature

Stockez dans votre base : le consentement booléen, la date, le canal de collecte et la formulation exacte présentée à l'utilisateur. Ces données sont nécessaires en cas de contrôle.

Que se passe-t-il si l'opt-in WhatsApp n'est pas géré correctement ?

Meta surveille les signalements de spam. Si un nombre élevé de contacts bloquent ou signalent les messages d'un numéro, le quality score baisse et le numéro peut être restreint ou suspendu. Pour un éditeur multi-tenant, une mauvaise gestion de l'opt-in chez un client peut impacter d'autres clients sur la même infrastructure si les numéros ne sont pas isolés. Whakup fournit une architecture avec des numéros dédiés par client pour éviter ce risque.

Comment traiter les désabonnements WhatsApp dans les workflows actifs ?

Votre webhook doit détecter les messages de désinscription (réponse « STOP », « Arrêter », ou signalement de spam détecté via le statut failed avec code 131026). Déclenchez immédiatement la mise à jour du flag opt-in dans votre base et retirez le contact de tous les workflows WhatsApp actifs. Confirmez la désinscription par un dernier message si votre outil le permet.

Questions sur la scalabilité et le modèle multi-tenant

Comment gérer plusieurs clients avec des numéros WhatsApp différents dans mon outil ?

Avec Whakup, chaque client de votre outil dispose de son propre phone_number_id et de son propre WABA. Côté éditeur, vous stockez la correspondance client_id → phone_number_id → access_token dans votre base de configuration. Chaque appel API utilise le phone_number_id et le token correspondant au client concerné. L'architecture est conçue pour des centaines de clients sur une seule intégration.

Y a-t-il une limite au nombre de messages envoyés simultanément depuis plusieurs clients ?

L'API Cloud Meta traite les requêtes par numéro, pas par éditeur. Chaque numéro a ses propres limites (1 000 → 10 000 → 100 000 conversations/24h selon le niveau). Le débit global de votre infrastructure d'envoi est donc la somme des limites de chaque numéro. Assurez-vous que vos workers respectent le rate limit par numéro pour éviter les erreurs 130429.

Comment exposer les métriques WhatsApp (livré, lu, cliqué) dans mon dashboard ?

Collectez les événements webhook (sent, delivered, read) et les clics sur boutons CTA (événement button) dans votre base de données d'analytics. Agrégez-les par workflow, par étape et par période. Ces métriques sont disponibles en temps réel via les webhooks Meta et ne nécessitent pas de polling côté API.

Pour une vue complète sur les coûts et la structure tarifaire de l'API en 2026, consultez notre article sur le prix de l'API WhatsApp Business.


Ces réponses couvrent les principales questions techniques posées par les équipes qui intègrent WhatsApp dans un outil de marketing automation. Pour accéder à l'API WhatsApp Business via Whakup et bénéficier du support technique dédié aux éditeurs, contactez notre équipe. Nous fournissons la documentation complète, l'environnement sandbox et l'accompagnement à l'intégration.

#intégration whatsapp#api whatsapp marketing automation#FAQ
Stéphane Haouzi
Stéphane HaouziHead of Growth

Head of Growth chez Whakup, Stéphane pilote la stratégie d'acquisition et les partenariats en Afrique francophone. Expert en marketing digital et expansion marché.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit