|
| 1 | +--- |
| 2 | +title: Webhook |
| 3 | +--- |
| 4 | + |
| 5 | +import { Callout } from 'fumadocs-ui/components/callout' |
| 6 | +import { Image } from '@/components/ui/image' |
| 7 | + |
| 8 | +Le bloc Webhook envoie des requêtes HTTP POST vers des points de terminaison webhook externes avec des en-têtes webhook automatiques et une signature HMAC optionnelle. |
| 9 | + |
| 10 | +<div className="flex justify-center"> |
| 11 | + <Image |
| 12 | + src="/static/blocks/webhook.png" |
| 13 | + alt="Bloc Webhook" |
| 14 | + width={500} |
| 15 | + height={400} |
| 16 | + className="my-6" |
| 17 | + /> |
| 18 | +</div> |
| 19 | + |
| 20 | +## Configuration |
| 21 | + |
| 22 | +### URL du webhook |
| 23 | + |
| 24 | +Le point de terminaison de destination pour votre requête webhook. Prend en charge les URL statiques et les valeurs dynamiques provenant d'autres blocs. |
| 25 | + |
| 26 | +### Charge utile |
| 27 | + |
| 28 | +Données JSON à envoyer dans le corps de la requête. Utilisez la baguette IA pour générer des charges utiles ou référencer des variables de workflow : |
| 29 | + |
| 30 | +```json |
| 31 | +{ |
| 32 | + "event": "workflow.completed", |
| 33 | + "data": { |
| 34 | + "result": "<agent.content>", |
| 35 | + "timestamp": "<function.result>" |
| 36 | + } |
| 37 | +} |
| 38 | +``` |
| 39 | + |
| 40 | +### Secret de signature |
| 41 | + |
| 42 | +Secret optionnel pour la signature HMAC-SHA256 de la charge utile. Lorsqu'il est fourni, ajoute un en-tête `X-Webhook-Signature` : |
| 43 | + |
| 44 | +``` |
| 45 | +X-Webhook-Signature: t=1704067200000,v1=5d41402abc4b2a76b9719d911017c592... |
| 46 | +``` |
| 47 | + |
| 48 | +Pour vérifier les signatures, calculez `HMAC-SHA256(secret, "${timestamp}.${body}")` et comparez avec la valeur `v1`. |
| 49 | + |
| 50 | +### En-têtes supplémentaires |
| 51 | + |
| 52 | +En-têtes personnalisés clé-valeur à inclure avec la requête. Ceux-ci remplacent tous les en-têtes automatiques portant le même nom. |
| 53 | + |
| 54 | +## En-têtes automatiques |
| 55 | + |
| 56 | +Chaque requête inclut automatiquement ces en-têtes : |
| 57 | + |
| 58 | +| En-tête | Description | |
| 59 | +|--------|-------------| |
| 60 | +| `Content-Type` | `application/json` | |
| 61 | +| `X-Webhook-Timestamp` | Horodatage Unix en millisecondes | |
| 62 | +| `X-Delivery-ID` | UUID unique pour cette livraison | |
| 63 | +| `Idempotency-Key` | Identique à `X-Delivery-ID` pour la déduplication | |
| 64 | + |
| 65 | +## Sorties |
| 66 | + |
| 67 | +| Sortie | Type | Description | |
| 68 | +|--------|------|-------------| |
| 69 | +| `data` | json | Corps de la réponse du point de terminaison | |
| 70 | +| `status` | number | Code de statut HTTP | |
| 71 | +| `headers` | object | En-têtes de réponse | |
| 72 | + |
| 73 | +## Exemples de cas d'usage |
| 74 | + |
| 75 | +**Notifier des services externes** - Envoyer les résultats du workflow vers Slack, Discord ou des points de terminaison personnalisés |
| 76 | + |
| 77 | +``` |
| 78 | +Agent → Function (format) → Webhook (notify) |
| 79 | +``` |
| 80 | + |
| 81 | +**Déclencher des workflows externes** - Démarrer des processus dans d'autres systèmes lorsque des conditions sont remplies |
| 82 | + |
| 83 | +``` |
| 84 | +Condition (check) → Webhook (trigger) → Response |
| 85 | +``` |
| 86 | + |
| 87 | +<Callout> |
| 88 | +Le bloc Webhook utilise toujours POST. Pour d'autres méthodes HTTP ou plus de contrôle, utilisez le [bloc API](/blocks/api). |
| 89 | +</Callout> |
0 commit comments