Associer une destination à un AgentHook
Associer une destination à un AgentHook
Comment lier une destination webhook à un AgentHook pour automatiser l'envoi des outputs au sein d'un projet
Reliez les outputs de vos Agents à une destination (webhook ou email) lors de la création ou de la modification d’un AgentHook — étape par étape, bonnes pratiques et pièges à éviter.
Intro Ce guide explique comment associer une destination à un AgentHook depuis l’interface : lors de la création d’un hook, lors de son édition, comment créer une nouvelle destination et la sélectionner, comment tester la destination et comprendre les conséquences liées au scope par projet. Les destinations (webhooks) sont toujours liées à un projet : vous ne verrez que les destinations créées pour le projet courant.
Associer une destination lors de la création d’un AgentHook
1. Ouvrir le dialogue de création d’un AgentHook
Dans la zone de configuration des Hooks (ou via le bouton “Nouveau Hook”), cliquez sur “Nouveau Agent Hook” pour ouvrir la fenêtre de création. Vous arriverez sur une modale avec les sections “Hook” puis “Destination”.
2. Choisir le type de Hook (Git ou CRON)
Sélectionnez le type : “Git” pour déclenchements sur événements (push, pull request) ou “CRON” pour exécutions planifiées. Le type influence les champs affichés (fréquence, prochaine exécution, etc.). Ce choix n’empêche pas d’associer une destination.
3. Aller à la section Destination
Descendez jusqu’à la section “Destination”. Vous verrez deux modes : “Webhook” et “Email” (boutons radio).
4. Sélectionner le mode 'Webhook' ou 'Email'
- Si vous choisissez “Webhook”, un sélecteur affichera la liste des destinations disponibles pour ce projet.
- Si vous choisissez “Email”, un champ texte vous permettra d’entrer une ou plusieurs adresses (séparées par des virgules).
5. Choisir une destination webhook existante
Si “Webhook” est sélectionné, ouvrez la liste déroulante et cliquez sur la destination souhaitée. La liste ne montre que les destinations appartenant au projet courant.
6. Créer une nouvelle destination si nécessaire
Si la destination souhaitée n’existe pas, cliquez sur le bouton “+” à côté du sélecteur pour ouvrir le formulaire de création d’une nouvelle destination. Une fois créée, la nouvelle destination est automatiquement sélectionnée dans le sélecteur.
7. Vérifier les paramètres et sauvegarder
Revoyez le reste des paramètres du Hook (filtres d’entrée, fréquence, prochaine exécution, etc.). Cliquez sur “Save” pour enregistrer le hook avec la destination liée.
Astuce — Sélection automatique après création
Lorsque vous ajoutez une nouvelle destination depuis le bouton “+”, la destination fraîchement créée est automatiquement sélectionnée pour votre hook. Pas besoin de rouvrir la liste.
Modifier un AgentHook pour changer sa destination
1. Ouvrir l’AgentHook existant
Depuis la liste des Hooks, éditez le hook concerné (bouton “Edit” ou icône crayon) pour ouvrir la modale d’édition.
2. Localiser la section Destination
Descendez jusqu’à la section “Destination”. Vous verrez le mode actuel (Webhook ou Email) et la destination active.
3. Changer de mode si besoin
- Passer de “Email” à “Webhook” : renseignez la destination webhook et vérifiez que les adresses email seront bien ignorées.
- Passer de “Webhook” à “Email” : entrez les adresses email (séparées par des virgules); la destination webhook sera dissociée.
4. Choisir une destination différente
Ouvrez la liste des destinations et sélectionnez une autre destination présente dans le projet. Si la destination choisie a des informations d’authentification ou un secret, vérifiez-les avant d’enregistrer.
5. Sauvegarder et contrôler
Enregistrez les modifications. La prochaine exécution du hook enverra les outputs vers la nouvelle destination.
Astuce — Historique et changements
Le changement de destination affecte les envois futurs. Les sorties déjà générées restent enregistrées dans les journaux du projet et ne sont pas ré-expédiées automatiquement vers l’ancienne ou la nouvelle destination.
Attention — Destinations limitées au projet courant
Les destinations listées sont spécifiques au projet : si vous ne voyez pas une destination que vous utilisez dans un autre projet, créez-la dans le projet actuel ou copiez ses paramètres. Ne supposez pas qu’une destination globale soit disponible automatiquement.
Créer une nouvelle destination et l’associer immédiatement
1. Ouvrir le formulaire de création depuis le Hook
Dans la modale de Hook, cliquez sur “+” à côté du sélecteur de destinations pour ouvrir le formulaire “Nouvelle destination”.
2. Remplir les informations de destination
Renseignez : nom, URL de destination, méthode (POST/PUT), en-têtes personnalisés, secret de signature (si nécessaire), et modèle de payload. Veillez à entrer correctement les éléments d’authentification.
3. Tester la destination
Utilisez le bouton “Test” pour envoyer un exemple. L’interface propose souvent de télécharger un fichier de test montrant la requête envoyée et la réponse. Cela vous permet de vérifier la compatibilité sans déclencher le Hook.
4. Sauvegarder la destination
Enregistrez la destination. Elle sera répertoriée et sélectionnée automatiquement dans le sélecteur du Hook.
5. Finaliser le Hook
Retournez au Hook (si la modale n’a pas fermé automatiquement), vérifiez la sélection et sauvegardez le Hook pour prendre en compte la nouvelle destination.
Astuce — Testez avec un payload représentatif
Pour réduire les erreurs, testez la destination avec un exemple de payload proche de ce que l’Agent renverra (même structure). Le test vous montrera headers, signature et corps exacts.
Bonnes pratiques pour la sélection et la maintenance des destinations
1. Documenter la destination
Donnez un nom explicite à la destination (ex. “Notion – Release Notes”, “Webhook CI — Prod”) et documentez son usage dans le projet.
2. Vérifier les secrets et en-têtes
Assurez-vous que la destination a le bon secret de signature et les en-têtes requis pour l’authentification côté récepteur.
3. Gérer les changements d’URL
Si l’URL d’un service cible change, mettez-la à jour dans la destination pour éviter les erreurs d’envoi. Après modification, relancez un test.
4. Nettoyer les destinations inutilisées
Supprimez les destinations obsolètes pour éviter des choix accidentels dans la liste et clarifier les options disponibles.
- L’option “Webhook” envoie les outputs structurés (payload) vers l’URL sélectionnée.
- Seules les destinations créées pour le projet sont listées.
- Les adresses email sont ignorées quand ce mode est actif.
- Si la destination est supprimée après association, les envois futurs échoueront jusqu’à ce que vous sélectionniez une nouvelle destination.
Avant : Hook sans destination
- Aucun envoi automatique.
- Utilisable pour tests manuels.
Après : Hook avec destination
- Envois automatiques vers la destination choisie (webhook ou email) lors des exécutions.
- Les informations d’authentification et le modèle de payload de la destination sont appliqués automatiquement.
:::callout{type=“warning” title=“Piège courant — oublier le fuseau/heure serveur”}> Lorsque vous planifiez une exécution (CRON), tenez compte de l’heure du serveur affichée dans l’interface. Une mauvaise compréhension du fuseau peut entraîner des exécutions à l’heure inattendue. :::
:::callout{type=“warning” title=“Piège courant — destination supprimée ou modifiée”}> Si vous supprimez ou modifiez substantiellement une destination après l’avoir associée, les envois échoueront ou seront mal interprétés. Après une modification majeure, réalisez un test d’envoi. :::
Frequently Asked Questions
Prêt à automatiser vos outputs ?
Créez ou éditez un AgentHook et associez-lui une destination pour recevoir automatiquement les résultats. N’oubliez pas de tester la destination avant de la mettre en production.