Webhook, API, workflow : le guide pour les non-techniciens
Explication simple et concrète des termes techniques de l'automatisation : webhook, API, workflow, trigger. Avec des analogies du quotidien.
Webhook, API, workflow : le guide pour les non-techniciens
Quand on parle d'automatisation, les termes techniques fusent : webhook, API, workflow, trigger, endpoint... Si vous n'êtes pas développeur, c'est normal de décrocher. Cet article traduit tout cela en français compréhensible.
Le workflow : votre chaîne de montage numérique
Un workflow, c'est une suite d'actions qui s'enchaînent automatiquement. Pensez à une chaîne de montage dans une usine : chaque poste réalise une opération, puis passe le résultat au poste suivant.
Exemple concret : un client remplit un formulaire sur votre site. Le workflow prend le relais :
- Il récupère les informations du formulaire
- Il crée une fiche dans votre CRM
- Il envoie un email de confirmation au client
- Il notifie le commercial concerné sur Slack
Tout cela se passe en quelques secondes, sans intervention humaine. C'est un workflow d'automatisation.
L'API : le serveur du restaurant
Une API (Interface de Programmation d'Application), c'est comme un serveur dans un restaurant. Vous (le client) ne pouvez pas aller en cuisine préparer votre plat vous-même. Vous passez commande au serveur, qui transmet à la cuisine, et vous rapporte le résultat.
De la même façon, quand n8n veut récupérer vos emails Gmail, il ne va pas fouiller directement dans les serveurs de Google. Il passe par l'API Gmail : il fait une demande formatée, Gmail lui renvoie les données demandées.
Chaque service en ligne (Google, Microsoft, Slack, votre logiciel métier) propose son API. C'est ce qui permet à tous les outils de notre catalogue de communiquer entre eux sans que vous ayez à faire le lien manuellement.
Le webhook : la sonnette de porte
Un webhook, c'est une notification instantanée envoyée d'un service à un autre quand quelque chose se passe.
Imaginez une sonnette de porte. Quand quelqu'un appuie dessus, vous êtes immédiatement prévenu. Vous n'avez pas besoin de vérifier toutes les 5 minutes si quelqu'un est à la porte.
Un webhook fonctionne pareil : quand un client soumet un formulaire, le formulaire "appuie sur la sonnette" de votre workflow n8n. Le workflow démarre instantanément. Sans webhook, il faudrait vérifier régulièrement si un nouveau formulaire a été soumis, ce qui est lent et inefficace.
Le trigger : le déclencheur
Le trigger, c'est l'événement qui lance votre workflow. C'est le premier domino de la chaîne. Il existe plusieurs types :
- Webhook trigger : un événement externe déclenche le workflow (formulaire soumis, paiement reçu)
- Schedule trigger : le workflow se lance à heure fixe (tous les lundis à 9h, tous les premiers du mois)
- Email trigger : un email reçu dans une boîte spécifique lance le traitement
- Manual trigger : vous appuyez sur un bouton pour lancer le workflow
Comment tout cela fonctionne ensemble
Prenons un exemple complet, celui d'un artisan qui reçoit des demandes de devis :
- Trigger : un prospect remplit le formulaire de contact sur le site web
- Webhook : le formulaire envoie instantanément les données au workflow n8n
- API Google Sheets : n8n utilise l'API pour enregistrer la demande dans un tableur
- API Gmail : n8n utilise l'API pour envoyer un accusé de réception personnalisé
- API SMS : n8n notifie l'artisan sur son téléphone par SMS
Le tout se passe en moins de 10 secondes. L'artisan est sur son chantier, il reçoit la notification, le prospect a son accusé de réception. Personne n'a eu besoin de toucher un ordinateur.
Pas besoin de coder
C'est le point essentiel. Dans n8n, tous ces concepts (API, webhook, trigger) sont représentés par des blocs visuels que vous connectez entre eux, dans le cadre de notre méthode en 4 étapes. Vous n'écrivez pas de code. Vous configurez des paramètres dans des formulaires. n8n est plus accessible qu'on ne le pense, grâce à son interface visuelle. Pas besoin d'être développeur, mais comptez quelques heures de prise en main. La technique est masquée, le résultat est concret.
Questions fréquentes
Qu'est-ce qu'une API, expliqué simplement ?
Une API est le guichet par lequel un logiciel accepte de parler à un autre. Elle définit ce qu'on a le droit de lui demander et sous quelle forme : lire une liste de clients, créer une facture, mettre à jour un statut. Sans API, deux logiciels ne peuvent échanger que par des moyens manuels, comme un export de fichier qu'un humain réimporte ailleurs. C'est pour cette raison que la première question à poser sur un logiciel métier, avant tout projet d'automatisation, est de savoir s'il expose une API documentée.
Quelle différence entre une API et un webhook ?
Le sens de l'initiative. Avec une API, c'est vous qui allez demander l'information : vous interrogez régulièrement le logiciel pour savoir si quelque chose a changé. Avec un webhook, c'est le logiciel qui vous prévient au moment où l'événement se produit. Le webhook est donc plus immédiat et plus économe, puisqu'il n'y a aucune interrogation à vide. En pratique, on utilise les deux : le webhook pour réagir à un événement, l'API pour aller chercher les détails.
Qu'est-ce qu'un workflow d'automatisation ?
C'est la suite d'étapes qui se déclenche automatiquement à partir d'un événement : recevoir un email, atteindre une date, voir un formulaire rempli. Chaque étape fait une chose (lire, filtrer, transformer, écrire, notifier) et passe le résultat à la suivante. L'intérêt du modèle est qu'il rend le processus visible : on voit la chaîne complète, on sait où elle s'arrête quand elle échoue, et on peut la modifier étape par étape sans tout reconstruire.
Un webhook est-il dangereux pour la sécurité ?
Un webhook est une adresse accessible depuis internet, donc c'est effectivement un point d'entrée à protéger. Trois précautions suffisent dans la plupart des cas : utiliser une adresse imprévisible plutôt qu'un chemin devinable, vérifier une signature ou un jeton partagé pour s'assurer que l'appel vient bien de l'expéditeur attendu, et valider systématiquement le contenu reçu avant de l'utiliser. Un webhook laissé sans aucune de ces protections revient à laisser une porte ouverte sur vos systèmes.
Faut-il être technicien pour comprendre ces notions ?
Non, et il est utile de ne pas déléguer complètement cette compréhension. Vous n'avez pas besoin de savoir écrire une requête, mais savoir ce qu'est une API vous permet de poser la bonne question à un éditeur de logiciel avant de l'acheter, et d'évaluer si une automatisation est réaliste ou non. C'est une compétence de dirigeant plus que de technicien : elle sert à arbitrer, pas à construire.
Ce sujet vous concerne ?
30 minutes en visio pour identifier les zones où l'automatisation peut faire gagner du temps à vos équipes BTP ou immobilier. Sans engagement.
Identifier mes gains potentiels (30 min)Gratuit · Sans engagement · 30 min en visio