Webhook
Déclenchez l'exécution d'un workflow lorsqu'un système externe envoie une requête HTTP vers une URL générée par Scrydon.
Le bloc Webhook génère un point de terminaison HTTP unique. Tout service externe capable d'envoyer une requête HTTP POST peut déclencher votre workflow.
Fonctionnement
- Ajoutez un bloc Webhook à votre workflow.
- Une URL de webhook unique est générée pour ce bloc — copiez-la depuis le champ Lien de déclenchement du bloc.
- Configurez votre service externe (GitHub, Stripe, tout système personnalisé) pour envoyer un POST à cette URL.
- Lorsque la requête arrive, le workflow démarre et le corps de la requête, les en-têtes, la méthode et les paramètres de requête sont injectés comme sorties du bloc.
Test en développement
Vous n'avez pas besoin de déployer ou de promouvoir pour tester un webhook. Dans l'environnement Développement modifiable, appeler l'URL de webhook exécute le workflow live/brouillon — exactement ce qui est sur le canvas — afin que vous puissiez itérer et tester de bout en bout pendant la construction.
Lorsque vous promouvez le workflow en Staging ou en Production (environnements en lecture seule), le webhook y exécute le snapshot déployé à la place, et nécessite une version de déploiement active. Chaque environnement possède sa propre URL de webhook. Voir Déclencheurs → Environnements et test pour le modèle complet.
Variables disponibles
Référencez la requête entrante dans les blocs en aval en utilisant le nom du bloc comme préfixe :
| Variable | Description |
|---|---|
<webhook1.payload> | Corps complet de la requête (JSON analysé ou chaîne brute) |
<webhook1.headers> | En-têtes de la requête sous forme d'objet JSON |
<webhook1.method> | Méthode HTTP (POST, PUT, etc.) |
<webhook1.query> | Paramètres de la chaîne de requête sous forme d'objet JSON |
Remplacez webhook1 par le nom que vous avez donné au bloc.
Authentification
Les points de terminaison webhook acceptent les POST non authentifiés par défaut. Pour restreindre l'accès, configurez un secret dans la configuration webhook du bloc. Scrydon vérifiera un en-tête X-Scrydon-Secret sur les requêtes entrantes et rejettera celles qui ne correspondent pas.
curl -X POST "https://app.scrydon.com/api/webhooks/trigger/{path}" \
-H "Content-Type: application/json" \
-H "X-Scrydon-Secret: {your-secret}" \
-d '{"event": "order.created", "orderId": "42"}'Déclencheurs spécifiques aux fournisseurs
Pour les services disposant d'une intégration Scrydon dédiée (GitHub, Microsoft Graph, Atlassian, etc.), préférez le bloc de déclencheur du fournisseur au bloc Webhook générique. Les déclencheurs de fournisseurs analysent et valident automatiquement le payload d'événement et exposent des variables typées.
Voir Fournisseurs pour la liste complète des intégrations avec prise en charge des déclencheurs.
Les blocs Webhook sont en réception uniquement. Ils démarrent le workflow mais ne peuvent pas renvoyer de réponse à l'appelant au-delà d'un accusé de réception HTTP 200 standard. Pour renvoyer des données à un appelant, utilisez le déclencheur Démarrer (API) à la place.