3.5Webhooks & intégrations sur mesure
L'essentiel en 30 secondes
- Le webhook déclenche en temps réel : une URL fournie par votre scénario ; dès qu'un service y envoie des données, le scénario démarre instantanément.
- Le module HTTP appelle tout : requête GET/POST (URL, méthode, en-têtes, corps) vers n'importe quelle API, réponse souvent en JSON à mapper.
- Les secrets restent secrets : clé d'API via les connexions chiffrées de l'outil, jamais en clair — et webhook testé avant de construire la suite.
Mini-cas filé — Lina relie son outil métier sans connecteur
Lina, chargée de digitalisation à Oran, utilise un outil métier sans connecteur prêt à l'emploi : impossible à brancher en standard. Elle crée un scénario déclenché par webhook, colle l'URL fournie dans les réglages de notifications de l'outil, puis envoie un appel de test dont elle observe la structure. Dans l'autre sens, elle ajoute un module HTTP qui appelle l'API du service (avec la clé stockée dans la connexion chiffrée), récupère la réponse et mappe ses champs vers la base. Le no-code devient sans limite.
Dernier épisode du fil Lina — du choix de l'outil aux intégrations sur mesure : l'automatisation avancée de bout en bout.
1. Le webhook, déclencheur universel
Quand une application n'a pas de connecteur tout prêt, on passe par les webhooks et les appels d'API. Un webhook est une URL que votre scénario fournit : dès qu'un autre service envoie des données à cette URL (validation d'un paiement, d'un formulaire, d'un événement sur mesure), le scénario se déclenche instantanément avec ces données. C'est le déclencheur universel, en temps réel.
Le principe à comprendre : « une adresse qui, quand on lui parle, réveille mon automatisation ». Pas besoin de coder : on colle l'URL dans les réglages « webhook / notifications » de l'autre service, on envoie un appel de test, et on observe la structure reçue pour le mapping.
2. Le module HTTP et la discipline des secrets
Dans l'autre sens, le module HTTP permet d'appeler n'importe quelle API : envoyer une requête (GET, POST…) à un service, avec ses paramètres et son authentification, et récupérer la réponse (souvent en JSON) pour la suite du scénario. Comprendre les bases (URL, méthode, en-têtes, corps, JSON) ouvre l'accès à des milliers de services même sans connecteur officiel.
Discipline non négociable : la clé d'API est un mot de passe — connexions chiffrées de l'outil, droits minimaux, régénération si elle a pu fuiter, jamais en clair dans le scénario ni sur une capture partagée. Webhooks (entrée) + appels HTTP (sortie) rendent le no-code réellement sans limite : c'est aussi le pont vers l'IA et les intégrations sur mesure du niveau 4.
🔎 Exemple concret — Recevoir par webhook, puis appeler une API
Lina branche l'inbranchable, dans les deux sens.
Déclencheur : Webhook (URL fournie par le scénario)
→ le service y envoie des données (JSON) à chaque événement
Module HTTP : appeler une API (GET/POST, en-têtes, clé chiffrée)
→ récupérer la réponse JSON, mapper vers l'action suivante.Lecture : entrée temps réel d'un côté, sortie sur mesure de l'autre.
Leçon : tester la réception du webhook avant de construire la suite.
Vocabulaire de la section
- Webhook
- URL fournie par votre scénario ; recevoir des données dessus le déclenche instantanément (déclencheur universel, temps réel).
Exemple simple : L'URL que Lina colle dans les notifications de son outil métier.
Ce que ce n'est pas : une vérification périodique avec délai (polling).
Réflexe : envoyer un appel de test et observer la structure reçue.
- API
- Interface permettant à deux logiciels de communiquer : on envoie une requête, on reçoit une réponse (souvent en JSON).
Exemple simple : L'API de l'outil métier que Lina interroge via HTTP.
Ce que ce n'est pas : un connecteur prêt à l'emploi déjà intégré.
Réflexe : lire la documentation de l'API avant le premier appel.
- Requête HTTP
- Appel à une API (méthode GET/POST…, URL, en-têtes, corps) pour lire ou envoyer des données.
Exemple simple : L'appel paramétré de Lina vers le service externe.
Ce que ce n'est pas : un simple déclencheur par formulaire.
Réflexe : vérifier méthode, URL et en-têtes avant d'envoyer.
- JSON
- Format texte standard d'échange de données structurées (paires clé/valeur, listes) renvoyé par la plupart des API.
Exemple simple : La réponse reçue par Lina, mappée champ par champ.
Ce que ce n'est pas : un document mis en forme pour impression.
Réflexe : mapper chaque clé JSON vers le bon champ cible.
- Authentification (API key/token)
- Mécanisme prouvant votre identité auprès d'une API (clé, jeton), à transmettre dans la requête et à garder secret.
Exemple simple : La clé de Lina stockée dans la connexion chiffrée de l'outil.
Ce que ce n'est pas : une clé collée en clair dans le scénario partagé.
Réflexe : secret chiffré + droits minimaux + régénération en cas de doute.
En pratique — Déclencher par webhook et appeler une API
- Créez un scénario déclenché par un webhook : copiez l'URL fournie et configurez un service pour lui envoyer des données.
- Envoyez un premier appel de test et observez les données reçues (structure JSON) dans le scénario.
- Ajoutez un module HTTP pour appeler une API externe (méthode, URL, en-têtes, clé via la connexion chiffrée).
- Récupérez la réponse JSON et mappez ses champs vers l'action suivante ; testez de bout en bout.
Script prêt à dire — brancher un outil sans connecteur (30 s)
« Cet outil n'a pas de connecteur, donc je passe en sur-mesure. Un : je crée un déclencheur webhook, je colle son URL dans les notifications de l'outil et j'envoie un appel de test. Deux : j'ajoute un module HTTP pour appeler son API, clé dans la connexion chiffrée, et je mappe la réponse JSON vers notre base. Je teste de bout en bout avant d'activer. »
À dire avant de brancher ; ne jamais coller de vraie clé dans une démo partagée.
Modèle copier-coller — payload webhook (exemple factice)
// PAYLOAD REÇU SUR LE WEBHOOK — données et URL factices (exemple pédagogique)
// URL factice : https://exemple-fictif.test/crochet/abc123 (ne pas utiliser telle quelle)
{
"evenement": "demande_recue",
"contact": { "nom": "Exemple Fictif", "objet": "DEVIS" },
"articles": [ { "nom": "Article A", "montant": 1200 } ]
}
// MAPPING → base : nom → Contact, objet → Titre, articles → itérateur (3.4)TPE / indépendant
Un webhook suffit à relier un formulaire ou un outil simple en temps réel, sans changer d'abonnement.
PME à Oran
Lina relie son outil métier au suivi interne : webhook en entrée, HTTP en sortie, secrets chiffrés.
Équipe digitale
Documenter chaque intégration sur mesure (URL, méthode, mapping JSON) pour la maintenir sans dépendre d'une personne.
Débutant
S'exercer d'abord avec le webhook seul : recevoir un appel de test et observer les données avant tout appel HTTP.
✓ Bonnes pratiques
- Utiliser un webhook pour un déclenchement temps réel universel.
- Appeler les API manquantes via le module HTTP (JSON).
- Stocker les clés d'API de façon chiffrée (connexions intégrées).
✗ Pièges fréquents
- Mettre une clé d'API en clair dans le scénario.
- Oublier l'authentification/les en-têtes dans une requête HTTP.
- Ne pas tester la réception du webhook avant de construire la suite.
Points clés à retenir
- Un webhook est une URL qui déclenche le scénario instantanément quand un service lui envoie des données.
- Le module HTTP appelle n'importe quelle API (GET/POST, en-têtes, corps) et récupère la réponse.
- Les données transitent souvent en JSON (clé/valeur, listes) à mapper vers la suite.
- Webhooks + appels HTTP donnent accès aux services sans connecteur officiel — le no-code sans limite.
Défi 48h — appliquez demain
Créez 1 scénario webhook, envoyez un appel de test et observez la structure JSON reçue.
- Je sais ce qu'est un webhook temps réel.
- Je sais appeler une API via HTTP + JSON.
- Mes clés sont en connexion chiffrée, jamais en clair.
Questions fréquentes
Un webhook, est-ce compliqué ? Faut-il coder ?
Non, pas besoin de coder. Concrètement, l'outil vous donne une URL ; il suffit d'indiquer cette URL dans l'autre service (dans ses réglages « webhook » / « notifications ») pour qu'il y envoie des données à chaque événement. Votre scénario les reçoit et se déclenche. La seule chose à comprendre est le principe : « une adresse qui, quand on lui parle, réveille mon automatisation ». Les données arrivent en JSON, que l'outil affiche de façon lisible pour le mapping. C'est souvent plus simple et plus instantané qu'un connecteur classique, et ça marche avec presque tout service capable d'envoyer un webhook.
Où mettre ma clé d'API pour appeler un service en toute sécurité ?
Jamais en clair dans le corps visible du scénario ni dans un champ partagé. Les bons réflexes : utiliser les connexions/authentifications intégrées de l'outil (qui stockent le secret de façon chiffrée), ou des variables d'environnement/coffres à secrets quand c'est disponible (particulièrement avec n8n, niveau 4). Une clé d'API est un mot de passe : quiconque l'obtient peut agir en votre nom et consommer vos quotas. On la garde secrète, on la régénère si elle a fuité, et on limite ses droits au minimum nécessaire. La sécurité des secrets est détaillée en section 4.5.
Que permet un webhook ?