DocumentationWorkflowsDéclencheurs
Webhook node
Démarre le workflow quand une requête HTTP arrive sur ton URL de webhook. Le body, les en-têtes, les paramètres de requête et les paramètres de chemin sont transmis en sortie, parfait pour les intégrations avec Zapier, Make, les boutons Slack ou tes propres apps. Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.
11 min de lectureMis à jour le
Fonction du node
Démarre le workflow quand une requête HTTP arrive sur ton URL de webhook. Le body, les en-têtes, les paramètres de requête et les paramètres de chemin sont transmis en sortie, parfait pour les intégrations avec Zapier, Make, les boutons Slack ou tes propres apps.
Utilisez Webhook comme étape clairement définie dans un workflow anymize.
- Démarre une nouvelle exécution du workflow.
- Fournit 1 sortie aux étapes suivantes.
- S'exécute comme une étape normale du workflow.
Configurer le node
- 01Ouvrez un workflow et ajoutez Webhook depuis le catalogue.
- 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
- 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
- 04Reliez la sortie réussie et activez le workflow après un test complet.
Actions et modes
Webhook remplit une fonction précise. Ses paramètres apparaissent lorsque vous sélectionnez le node.
Paramètres
| Champ | Signification | Zone |
|---|---|---|
| Format d’import | Configurez cette valeur dans le panneau du node. | Standard |
| Version d’import | Configurez cette valeur dans le panneau du node. | Standard |
| Réponse à l’application émettrice | Cette réponse confirme la réception. Les étapes suivantes continuent ensuite. | Standard |
| Texte de réponse | Configurez cette valeur dans le panneau du node. | Standard |
| Quels champs envoie ton webhook ? | Exemples : email, name, amount. Chaque champ devient une sortie distincte, pour que tu puisses le glisser directement sur d'autres nodes, sans bricolage JSON. | Standard |
| URL du webhook | Configurez cette valeur dans le panneau du node. | Protégé |
| Clé API | Générée automatiquement. Les requêtes doivent transmettre la clé soit dans l'en-tête `X-Anymize-Api-Key`, soit comme `Authorization: Bearer <key>`. | Protégé |
| Méthode HTTP | Choix: GET, POST, PUT, PATCH, DELETE, HEAD, Toutes (ANY) | Standard |
| Complément d'URL personnalisé (optionnel) | Ajouté à la fin de ton URL de webhook, p. ex. /client/details. Si tu écris /:name, la valeur arrivera ensuite à cet endroit comme champ dans ton workflow. | Standard |
| Authentification | Recommandé : clé API. Ne change que si ton appelant utilise une autre méthode. | Standard |
| Identifiants depuis un secret de workflow | Choisis un secret de workflow contenant le mot de passe, la valeur d’en-tête ou la clé de signature JWT. Seul le nom du secret est stocké dans le workflow. | Protégé |
| Nom d’utilisateur | Configurez cette valeur dans le panneau du node. | Standard |
| Nom de l’en-tête | Configurez cette valeur dans le panneau du node. | Standard |
| Algorithmes JWT autorisés | Liste d’algorithmes HMAC autorisés, séparés par des virgules. La clé de signature provient du secret de workflow. | Standard |
| Mode de réponse | Choix: Immédiatement (200 OK), Quand la dernière étape est terminée, Bloc de réponse webhook personnalisé à la fin | Standard |
| Code de statut de la réponse | Configurez cette valeur dans le panneau du node. | Standard |
| Données de réponse | Choix: Toutes les entrées, Première entrée (JSON), Première entrée (fichier), Pas de body | Standard |
| Quel champ renvoyer ? | Uniquement si Données de réponse est sur « Première entrée » : indique ici le nom du champ dont la valeur seule est renvoyée (au lieu de l'objet entier). | Standard |
| Format de réponse | Choix: JSON, Texte, HTML, XML | Standard |
| En-têtes de réponse | Configurez cette valeur dans le panneau du node. | Standard |
| Sites web autorisés (optionnel) | Depuis quels sites web le navigateur peut-il appeler ce webhook ? Sépare-les par des virgules, * autorise tous. | Standard |
| Uniquement ces adresses d'expéditeur (optionnel) | N'autorise que les requêtes provenant de certaines adresses IP. Sépare-les par des virgules, des plages entières fonctionnent aussi (p. ex. 10.0.0.0/8). Vide = tous les expéditeurs autorisés. | Standard |
| Ignorer les bots & crawlers d'aperçu de liens | Configurez cette valeur dans le panneau du node. | Standard |
| Transmettre le contenu tel quel | Active si le body n'est pas du JSON (p. ex. texte brut ou XML), il n'est alors pas décomposé, mais transmis brut. | Standard |
| Nom du champ fichier (pour les téléversements de fichiers) | Uniquement pour les téléversements de fichiers/binaires : si tu renseignes un nom ici, le fichier téléversé arrive sous ce champ dans ton workflow. | Standard |
| Vérifier la signature de la requête | Pour les services qui signent leurs requêtes de manière cryptographique (p. ex. Stripe, GitHub). Active si ton expéditeur joint une signature. | Standard |
| Secret de signature | Choisis le secret de workflow contenant la clé partagée avec laquelle l’expéditeur signe la requête. | Protégé |
| Nom de l'en-tête de signature | Dans quel en-tête HTTP ton expéditeur envoie la signature. Par défaut X-Signature, à ne changer que si ton service utilise un autre nom. | Standard |
| Procédé de signature | Quel procédé ton expéditeur utilise pour signer (indiqué dans sa doc de webhook). En cas de doute, SHA-256. | Standard |
Entrées et sorties
| Entrée | Signification | Type |
|---|---|---|
| Standard | Ce déclencheur ne nécessite aucune entrée. | JSON |
| Sortie | Signification | Type |
|---|---|---|
| body | Le body JSON parsé de la requête. | json |
| headers | Tous les en-têtes HTTP. | json |
| query | Paramètres de requête (?foo=bar). | json |
| params | Paramètres de chemin issus de /:userId/details. | json |
| method | Méthode HTTP de la requête. | text |
Exemple et test
Body d'exemple: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.
Exemple de test
{
"event": "signup",
"user": {
"id": "usr_abc123",
"email": "max.mustermann@example.com",
"name": "Max Mustermann"
},
"source": "landing-page"
}Accès et sécurité
Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.
Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.
Résoudre les erreurs
- Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
- Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
- Le workflow ne démarre pas: activez-le et vérifiez le mode du déclencheur.