Une nouvelle commande depuis une boutique en ligne, un formulaire rempli sur le site, un paiement depuis une passerelle de paiement - voici comment brancher ce type d'événements sur votre système via un webhook, et comment faire sortir des données via une API.
Une boutique en ligne, un site ou une passerelle de paiement fonctionnent généralement comme des systèmes séparés qui ne se connaissent pas - jusqu'à ce que quelqu'un les connecte à la main en recopiant des données. Les webhooks et l'API résolvent exactement ce problème : ils permettent à deux systèmes de s'échanger des données automatiquement, au moment où quelque chose se produit, sans une seule étape manuelle entre les deux.
Deux sens de connexion
Webhook - les données entrent. Un service externe (boutique en ligne, passerelle de paiement, formulaire du site) appelle votre adresse lors d'un événement donné et envoie des données. L'automatisation reçoit le webhook et déclenche les étapes suivantes à partir de là - par exemple, créer un nouvel enregistrement.
API - les données sortent. Dans l'autre sens, grâce à une clé API, un système externe peut aller chercher lui-même dans vos données - par exemple récupérer le statut actuel d'une commande ou écrire un résultat en retour.
La plupart des connexions réelles combinent les deux sens : le site envoie une nouvelle commande vers l'intérieur via un webhook, puis interroge plus tard, via l'API, son statut.
Le webhook reçoit des données de n'importe où et déclenche une automatisation.
La boutique en ligne ou le site appelle le webhook à chaque nouvelle commande, l'automatisation reçoit les données et crée directement l'enregistrement correspondant.
La marche à suivre habituelle pour connecter une boutique en ligne
- Vous créez un webhook dans votre automatisation - vous obtenez une adresse unique à laquelle le système externe envoie les données.
- Vous renseignez cette adresse dans les paramètres de la boutique en ligne, de la passerelle de paiement ou du formulaire, comme destination des notifications d'événement.
- Vous associez les champs des données entrantes (nom, e-mail, lignes de commande) aux colonnes de votre base de données.
- Vous ajoutez les étapes suivantes - création de l'enregistrement, envoi d'une confirmation, attribution à la personne responsable.
Quand une clé API convient mieux qu'un webhook
Un webhook convient pour réagir à un événement ponctuel. Une clé API convient là où vous devez lire ou écrire des données depuis l'extérieur régulièrement ou à la demande - par exemple un outil interne qui vérifie les nouveaux enregistrements une fois par heure, ou un reporting externe qui récupère les chiffres actuels.
Points de vigilance
Vérifier l'origine des données. Un webhook ne devrait accepter des données que d'une source de confiance - cela se gère habituellement avec une clé secrète que l'expéditeur envoie et que l'automatisation vérifie avant de traiter les données.
Données manquantes ou incomplètes. Toutes les requêtes entrantes n'auront pas tous les champs renseignés - l'automatisation devrait avoir une condition pour le cas où une valeur obligatoire manque, plutôt que de créer silencieusement un enregistrement incomplet.
Volume de requêtes. Si la boutique en ligne génère des centaines de commandes par jour, il vaut la peine de prévoir dès le départ que l'automatisation s'exécutera souvent, et d'intégrer un contrôle des doublons.
Quand une connexion via un scénario externe a du sens et quand l'automatisation est mieux placée dans le système, voyez Zapier et Make sont-ils morts ?.
Questions fréquentes sur les webhooks et l'API
Ai-je besoin d'un développeur pour connecter un webhook à ma boutique en ligne ?
Sur la plupart des plateformes e-commerce courantes, il suffit de copier l'adresse du webhook dans les paramètres de notification - l'association des champs et les étapes suivantes se composent visuellement, sans écrire de code.
Que se passe-t-il si le système externe envoie des données dans un format qui ne correspond pas à ma base de données ?
Entre la réception du webhook et la création de l'enregistrement, on peut insérer une étape qui réorganise ou transforme les données dans le bon format avant qu'elles ne soient écrites.
Comment savoir s'il faut utiliser un webhook ou une clé API ?
Utilisez un webhook quand vous voulez réagir à un événement précis (nouvelle commande, paiement). Utilisez une clé API quand vous devez lire ou écrire des données selon les besoins, pas seulement en réaction à un seul événement.