Configurer un Webhook Personnalisé avec Make.com

Cet article contient des liens affiliés vers certains outils mentionnés. Si vous souscrivez via ces liens, SEOmnix peut percevoir une commission, sans coût additionnel pour vous.

Les webhooks sont des outils puissants pour l'automatisation en temps réel, agissant comme des passerelles d'information entre différentes applications. Lorsque vous souhaitez déclencher des flux de travail complexes et personnalisés, configurer un webhook personnalisé avec Make.com devient une compétence essentielle. Cette approche vous permet de connecter n'importe quel service capable d'envoyer des requêtes HTTP à vos scénarios Make.com, ouvrant un monde de possibilités pour l'automatisation sans coder. Que vous soyez un débutant cherchant à comprendre les fondamentaux ou un utilisateur avancé souhaitant sécuriser ses intégrations, ce guide complet vous accompagnera pas à pas. Si vous débutez avec la plateforme, notre Tutoriel Débutant pour Automatiser Sans Coder avec Make.com est un excellent point de départ.

1. Concepts Clés : Qu'est-ce qu'un Webhook avec Make.com ?

Un webhook est un mécanisme permettant à une application d'envoyer des données en temps réel à une autre application dès qu'un événement spécifique se produit. Pensez à lui comme un « appel téléphonique » automatique : lorsqu'un événement (comme la soumission d'un formulaire, la validation d'un paiement ou l'ajout d'un fichier) se produit dans l'application source, celle-ci « appelle » une URL spécifique pour notifier l'application de destination et lui transmettre les informations pertinentes.

Chez Make.com, un webhook joue le rôle de déclencheur instantané. Cela signifie que votre scénario Make.com démarrera immédiatement dès que l'URL du webhook reçoit une requête HTTP (le plus souvent de type POST). C'est ce qui distingue les webhooks des déclencheurs basés sur un sondage (polling), qui vérifient périodiquement si de nouvelles données sont disponibles.

Make.com distingue deux types principaux de webhooks :

Webhooks applicatifs (Instant Triggers) : Ces webhooks sont spécifiquement liés à une application particulière (ex. : Pipedrive, Stripe, Shopify). Ils sont pré-configurés par Make.com et marqués comme « instant » dans l'interface, offrant une intégration prête à l'emploi pour les événements les plus courants de ces applications. Pour les utilisateurs de Shopify, notre Guide Complet pour automatiser son e-commerce Shopify avec Make.com détaille ces intégrations.
Custom Webhooks : Il s'agit d'une URL générique que vous pouvez créer et appeler depuis n'importe quel service ou code personnalisé. C'est l'option la plus flexible, vous permettant de connecter des systèmes propriétaires, des scripts personnalisés (comme Google Apps Script) ou des plateformes qui n'ont pas d'intégration native directe avec Make.com.

2. Création d'un Webhook Personnalisé dans Make.com

La mise en place d'un webhook personnalisé est un processus simple mais essentiel, se déroulant en plusieurs étapes clés.

Étape 1 – Créer le Scénario et le Module Webhooks

Accédez au Scenario Builder de Make.com : Connectez-vous à votre compte Make.com et cliquez sur « Créer un nouveau scénario ».
Ajoutez le module Webhooks : En tant que premier module de votre scénario (le déclencheur), recherchez et sélectionnez le module « Webhooks ».
Choisissez « Custom webhook » : Parmi les options proposées, sélectionnez « Custom webhook ». C'est ce module qui générera l'URL unique pour recevoir vos données.

Étape 2 – Générer l'URL de Webhook

Configurez le Custom Webhook : Dans le module « Custom webhook », cliquez sur le bouton « Add » pour créer un nouveau webhook.
Nommez votre Webhook : Donnez un nom explicite à votre webhook (par exemple, lead-form-submission, stripe-payment-succeeded, pipedrive-deal-won). Un nom clair facilitera la gestion et la maintenance de vos scénarios, surtout si vous en avez plusieurs.
Obtenez l'URL unique : Make.com générera automatiquement une URL unique pour votre webhook, qui ressemblera à ceci : https://hook.eu1.make.com/abc123def456ghi789. Copiez cette URL, car c'est votre « endpoint » que vous devrez configurer dans l'outil source qui enverra les données.

Étape 3 – Connecter la Source d'Événements

C'est l'étape où vous dites à votre application émettrice d'envoyer des données à l'URL générée par Make.com.

Dans votre application source (CRM, plateforme de paiement, formulaire en ligne, script personnalisé, site web, etc.), recherchez la section dédiée aux webhooks ou aux notifications d'événements.
Collez l'URL de votre webhook Make.com dans le champ prévu à cet effet. Configurez l'application pour qu'elle envoie une requête HTTP (généralement POST) à cette URL lors de l'événement désiré.
Exemple avec Google Drive : Un script Google Apps peut être configuré pour surveiller un dossier spécifique dans Google Drive. Lorsqu'un nouveau fichier est ajouté, le script envoie une requête POST à l'URL de votre custom webhook Make.com, transmettant les informations sur le nouveau fichier.

3. Détermination de la Structure des Données (Data Structure)

L'un des avantages majeurs de Make.com est sa capacité à analyser et à gérer automatiquement la structure des données entrantes via votre webhook.

Lors du premier appel reçu par votre webhook, Make.com analyse le corps de la requête HTTP (qui est généralement au format JSON) et génère un schéma de données correspondant. Ce schéma est crucial, car il permet à Make.com de comprendre quels champs de données sont disponibles et de vous les proposer pour le mappage dans les modules suivants de votre scénario (par exemple, pour alimenter un CRM, envoyer un e-mail ou mettre à jour une base de données).

Bonnes pratiques opérationnelles pour la détermination de la structure :

Préparez un événement de test : Avant de tenter de déterminer la structure, assurez-vous d'avoir un événement de test prêt côté source (par exemple, soumettez un formulaire de test, effectuez un paiement de test, ajoutez un fichier de test).
Lancez la détection dans Make.com :
- Dans le module « Custom webhook » de votre scénario Make.com, cliquez sur « Re-determine data structure ».
- Cliquez ensuite sur « Stop » pour que le module soit prêt à écouter.
- Déclenchez l'événement de test depuis votre application source.
- Revenez à Make.com et cliquez sur « Run once » pour que le scénario écoute la requête entrante. Make.com capturera les données, déterminera la structure et vous affichera un message de succès.
Évitez les attentes inutiles : Si vous lancez « Run once » sans déclencher d'événement côté source, Make.com attendra 60 secondes avant de se mettre en pause, vous obligeant à recommencer. Assurez-vous que l'événement de test est prêt à être déclenché immédiatement après avoir mis Make.com en mode d'écoute.

4. Configuration Avancée : Réponse au Webhook (Webhook Response)

Dans certains cas, l'application source qui envoie le webhook attend une réponse spécifique de la part de Make.com pour confirmer la bonne réception ou fournir des informations supplémentaires. C'est courant avec des services comme Stripe, Shopify, ou des APIs personnalisées.

Pour gérer cela :

Ajoutez un module « Webhook response » : À la fin de votre scénario, ajoutez un module « Webhooks » et choisissez l'option « Webhook response ».
Configurez la réponse :
- Status code : Définissez le code de statut HTTP approprié (par exemple, 200 OK pour succès, 201 Created, 400 Bad Request en cas d'erreur). Le code 200 est le plus courant pour indiquer un traitement réussi.
- Headers : Si nécessaire, ajoutez des en-têtes HTTP spécifiques (par exemple, Content-Type: application/json si vous renvoyez du JSON).
- Body : Spécifiez le contenu du corps de la réponse. Il peut s'agir de texte simple, mais le plus souvent, c'est un objet JSON contenant des informations que l'application source attend.
Paramètres avancés du module initial :
- Dans les paramètres du module « Custom webhook » initial, cochez l'option « Get request headers » si vous avez besoin de récupérer les en-têtes de la requête entrante (utile pour la vérification de signature, par exemple).
- Passez le mode de réponse du module initial en « Custom response ». Cela indique à Make.com que la réponse sera gérée par le module « Webhook response » situé plus loin dans le scénario, et non par le déclencheur lui-même.

5. Sécuriser un Webhook Personnalisé Make.com

Un webhook est une porte d'entrée vers vos systèmes. Il est crucial de le sécuriser pour éviter tout accès non autorisé ou toute utilisation abusive. Considérez toujours l'URL de votre webhook comme un secret technique et ne l'exposez jamais publiquement (sur le front-end d'un site, dans une documentation publique non sécurisée, etc.).

Voici trois niveaux de sécurité, du plus simple au plus robuste :

Token dans l'URL (niveau basique)
- Mise en œuvre : Ajoutez un paramètre de requête à l'URL de votre webhook, par exemple : https://hook.eu1.make.com/abc123def456ghi789?token=monSecretUnique.
- Vérification dans Make.com : Utilisez un module Router ou Filter juste après le module Custom Webhook pour vérifier si le token est présent et correspond à la valeur attendue. Si le token est absent ou invalide, le scénario est arrêté ou redirigé vers un chemin d'erreur. Cette méthode est suffisante pour de nombreux cas d'usage internes ou à faible risque.
Vérification de Signature HMAC (niveau avancé)
- Principe : Des services comme Stripe, GitHub ou Shopify signent leurs webhooks en calculant une signature HMAC (Hash-based Message Authentication Code) basée sur le corps de la requête et un secret partagé. Cette signature est envoyée dans les en-têtes de la requête.
- Mise en œuvre dans Make.com : Vous devrez :
  - Récupérer la signature envoyée dans les en-têtes de la requête (en cochant « Get request headers » dans les paramètres du module Webhook).
  - Utiliser un module Tools → Set variable ou Text parser combiné avec des fonctions de hachage (par exemple, sha256, md5) pour reconstituer la signature côté Make.com en utilisant le corps de la requête reçu et votre secret partagé.
  - Comparer la signature calculée avec celle reçue. Si elles ne correspondent pas, le webhook n'est pas authentique et le scénario doit être arrêté.
Restriction IP côté outil source (niveau réseau)
- Principe : Lorsque l'outil émetteur le permet (souvent sur des plateformes B2B ou des APIs plus sophistiquées), vous pouvez configurer des restrictions d'adresses IP. Seules les adresses IP autorisées seront en mesure d'appeler l'URL du webhook.
- Mise en œuvre : Ajoutez l'adresse IP de Make.com à la liste blanche de votre service source. Notez que les adresses IP de Make.com peuvent varier et changer, il est donc essentiel de vérifier leur documentation officielle pour les adresses IP actuelles.

Autres bonnes pratiques de sécurité :

Ne jamais exposer l'URL du webhook publiquement : Évitez de l'intégrer directement dans le code client (JavaScript) de votre site web ou de la partager dans des forums publics sans précautions.
Éviter les données sensibles : Ne transmettez jamais de données hautement sensibles (mots de passe en clair, numéros de carte de crédit complets) directement via un webhook. Utilisez des tokens d'accès, des identifiants uniques ou des méthodes de chiffrement appropriées si des informations sensibles doivent transiter.

6. Intégration HTTP & Webhooks : Combiner les Modules

Bien que le module Webhooks de Make.com soit excellent pour recevoir des données, il est souvent combiné avec le module HTTP pour une flexibilité maximale. Le module HTTP (Make.com) vous permet d'envoyer des requêtes HTTP (GET, POST, PUT, DELETE, etc.) à n'importe quelle API ou service web, complétant ainsi la capacité de réception du module Webhooks. C'est le duo parfait pour gérer des interactions complexes avec des services externes. Pour approfondir la création d'automatisations sans code, consultez notre Guide Complet pour Créer des Automatisations Make.com Sans Coder.

Conclusion

Maîtriser la configuration des webhooks personnalisés avec Make.com est une compétence indispensable pour quiconque souhaite pousser les limites de l'automatisation. En suivant ces étapes, vous pouvez créer des intégrations robustes et sécurisées, transformant des flux de travail manuels en processus automatisés et efficaces. L'approche flexible de Make.com, combinée à ses capacités de sécurité avancées, en fait une plateforme de choix pour connecter pratiquement n'importe quel service. Prêt à transformer vos opérations ? Commencez à automatiser avec Make.com dès aujourd'hui !