API WhatsApp et les webhooks : guide pour les plateformes no-code

Un webhook WhatsApp API est une URL que vous exposez côté serveur pour recevoir les événements en temps réel depuis Meta : nouveaux messages entrants, accusés de livraison, changements de statut de template, mises à jour de quality rating. Pour les plateformes no-code qui intègrent WhatsApp, les webhooks sont le mécanisme central qui permet de réagir à ces événements sans polling constant.

Ce que les webhooks WhatsApp transmettent

Meta envoie des payloads JSON à votre URL webhook pour chaque événement sur votre WABA. Les événements principaux :

Catégorie d'événement	Exemples
Messages entrants	Texte, image, document, audio, vidéo, réaction, localisation
Statuts de livraison	sent, delivered, read, failed
Changements de qualité	Score du numéro passant en jaune ou rouge
Mises à jour de template	Approbation, rejet, désactivation d'un template
Changements de limite d'envoi	Montée ou descente de tier

Pour une plateforme no-code qui automatise des workflows WhatsApp, les webhooks sont indispensables. Sans eux, vous ne savez pas si un message a été lu, vous ne pouvez pas déclencher une action suite à la réponse d'un contact, et vous ne détectez pas les problèmes de qualité.

Configurer un webhook WhatsApp : les étapes

La configuration d'un webhook WhatsApp passe par le Meta WhatsApp Manager ou par l'API Graph. Les étapes :

1. Exposer une URL HTTPS publique. Meta ne peut pas atteindre une URL en localhost ou derrière un VPN. Votre endpoint doit être accessible publiquement, avec un certificat SSL valide.

2. Implémenter la vérification initiale. Lors de l'enregistrement du webhook, Meta envoie une requête GET avec un hub.challenge. Votre endpoint doit renvoyer ce challenge pour prouver que vous contrôlez l'URL. C'est une étape bloquante — sans cette réponse, le webhook n'est pas enregistré.

3. Traiter les requêtes POST. Meta envoie les événements en POST. Votre endpoint doit répondre avec un HTTP 200 dans les 20 secondes. Si Meta ne reçoit pas de 200, il retente l'envoi selon un backoff exponentiel, puis abandonne après plusieurs heures.

4. Vérifier la signature. Meta signe chaque requête webhook avec un HMAC SHA-256 basé sur votre App Secret. Vérifier cette signature avant de traiter le payload est la seule façon de s'assurer que la requête vient bien de Meta et pas d'un tiers.

Pour la mise en oeuvre technique complète, le guide d'intégration de l'API WhatsApp Whakup fournit les endpoints et les structures de payload.

Intégrer les webhooks WhatsApp dans un outil no-code

Les plateformes no-code populaires (Make, n8n, Zapier, Bubble) gèrent les webhooks de façon native. Le flux typique :

Make (ex-Integromat) : créez un module "Custom Webhook" qui génère une URL publique. Utilisez cette URL dans votre configuration WhatsApp. Make gère automatiquement le parsing du JSON et vous pouvez brancher des actions sur n'importe quel événement.

n8n : le noeud "Webhook" fonctionne de la même façon. n8n est particulièrement adapté si vous hébergez votre propre instance (important pour la conformité RGPD).

Zapier : le "Catch Hook" de Zapier génère une URL webhook. En revanche, Zapier n'expose pas de mécanisme natif pour répondre au challenge de vérification Meta — vous aurez besoin d'une étape intermédiaire (un petit script ou un autre outil).

Bubble : Bubble supporte les webhooks entrants via les workflows API. La vérification du challenge Meta nécessite une configuration spécifique dans les réponses de l'API.

Un point de vigilance commun à tous ces outils : la vérification de la signature HMAC. La plupart des outils no-code ne proposent pas de bloc natif pour calculer un HMAC SHA-256. Pour les cas d'usage en production, soit vous ajoutez une couche de vérification via un microservice, soit vous utilisez un BSP qui expose ses propres webhooks normalisés — avec une signature plus simple à valider.

Architectures no-code recommandées pour WhatsApp

Pour une plateforme no-code qui intègre WhatsApp, voici les architectures les plus courantes :

Chatbot simple (réponse automatique). Webhook entrant → Make/n8n reçoit le message → logique de routing → appel API WhatsApp pour répondre. Adapté pour un bot FAQ ou un premier niveau de qualification.

Notification transactionnelle. Événement dans votre outil (nouvelle commande, alerte) → déclencheur dans Make/Zapier → appel API WhatsApp pour envoyer un template. Le webhook n'est pas nécessaire pour l'envoi, mais utile pour tracer les livraisons.

Transfert vers agent humain. Webhook entrant → n8n analyse le message → si mot-clé "humain" → notification Slack ou création de ticket → agent répond depuis une interface dédiée.

La documentation des templates WhatsApp et leurs catégories complète ce guide pour structurer vos messages sortants.

Pour les éditeurs de solutions no-code qui veulent proposer WhatsApp comme canal à leurs clients, le guide build vs buy de l'API WhatsApp compare les options d'intégration en détail.

FAQ

Un outil no-code peut-il répondre automatiquement à un message WhatsApp entrant ?

Oui. Le webhook reçoit le message entrant, votre workflow no-code le traite, puis appelle l'API WhatsApp (via un noeud HTTP POST) pour envoyer la réponse. La réponse doit intervenir dans la fenêtre de 24 heures suivant le dernier message du contact pour éviter de devoir utiliser un template approuvé.

Peut-on recevoir les pièces jointes (images, documents) via webhook ?

Meta envoie l'ID du média dans le payload webhook, pas le fichier lui-même. Pour récupérer le fichier, vous devez faire un appel supplémentaire à l'API Graph Meta avec l'ID média pour obtenir l'URL temporaire de téléchargement (valide 5 minutes).

Comment tester les webhooks WhatsApp en local pendant le développement ?

Utilisez un outil comme ngrok ou localtunnel pour exposer votre serveur local via une URL HTTPS publique. Meta accepte ces URL pour les environnements de développement. Pour les tests sans code côté serveur, Webhook.site permet de visualiser les payloads entrants en temps réel.

Les webhooks WhatsApp sont-ils en temps réel ?

Quasi en temps réel. La latence entre l'événement (message envoyé, statut mis à jour) et la réception du webhook est généralement inférieure à quelques secondes. En période de forte charge ou d'incident Meta, cette latence peut augmenter.

---

Les webhooks WhatsApp ouvrent la porte aux automatisations les plus utiles : chatbots, notifications bidirectionnelles, escalades vers des agents humains. Pour les plateformes no-code, la clé est de choisir un BSP dont l'API est propre, documentée et compatible avec les outils du marché. Découvrez comment l'API WhatsApp Whakup simplifie l'intégration webhook pour les éditeurs no-code.