> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/guides/guides-fr/automatisations/connectez-shade-a-dautres-outils-avec-des-webhooks.md). # Connectez Shade à d'autres outils avec des webhooks Lancez des automatisations Shade depuis n’importe quel outil avec un webhook, et envoyez des données de Shade vers n’importe quelle API avec une requête HTTP. **Résultat :** des connexions bidirectionnelles entre Shade et le reste de votre pile. Votre outil de projet peut lancer une automatisation Shade, et Shade peut lui renvoyer des mises à jour, sans écrire votre propre service. **À qui cela s'adresse :** des producteurs soucieux des opérations et des membres d'équipe techniques qui connectent Shade à un outil de suivi de projet, un CMS, Slack ou un outil interne. Si vous préférez écrire du code, consultez les [guides pour les développeurs](/guides/guides-fr/guides-pour-les-developpeurs.md) . **Temps :** environ 20 minutes par connexion. ## Avant de commencer * Créer [Votre première automatisation](/guides/guides-fr/automatisations/votre-premiere-automatisation.md) d'abord si vous n'avez pas utilisé l'éditeur d'automatisation. * Gardez la documentation de l'autre outil ouverte. Vous aurez besoin soit de ses paramètres de webhook sortant, soit du point de terminaison API que vous souhaitez appeler. ## Partie 1 : démarrer une automatisation depuis un autre outil Cet exemple crée un dossier de projet chaque fois qu'un nouveau projet est créé dans votre outil de suivi. {% stepper %} {% step %} ### Ajouter un déclencheur Webhook reçu Créez une automatisation et choisissez **Webhook reçu**. Shade affiche une URL de webhook pour cette automatisation. Laissez **Exiger l'authentification** activé. Shade génère un **jeton d'authentification**, et les requêtes entrantes doivent l'envoyer comme jeton Bearer. {% endstep %} {% step %} ### Pointez l'autre outil vers celui-ci Dans les paramètres de webhook sortant ou d'automatisation de l'autre outil, collez l'URL et ajoutez un `Authorization` en-tête avec la valeur `Bearer` suivi du jeton. Faites-lui envoyer un corps JSON, par exemple : ```json { "project_name": "ACME Spring Campaign" } ``` {% endstep %} {% step %} ### Utilisez la charge utile dans vos étapes Ajoutez **Créer un dossier**. Dans **Chemin**, saisissez `Projects/`, puis saisissez `{` et choisissez `project_name` à partir du **corps de la requête**. Choisissez un **modèle de dossier** pour créer la structure standard à l'intérieur du nouveau dossier. Envoyez une requête de test depuis l'autre outil avant de terminer cette étape. Les champs de la charge utile sont plus faciles à sélectionner une fois que Shade en a vu une réelle. {% endstep %} {% step %} ### Enregistrer et activer Cliquez sur **Enregistrer**, puis **Activer**, puis créez un projet de test dans l'autre outil. {% endstep %} {% endstepper %} ## Partie 2 : envoyer des données de Shade vers un autre outil Cet exemple publie un message vers un webhook entrant Slack chaque fois qu'un commentaire est résolu. {% stepper %} {% step %} ### Choisissez l'événement Shade Créez une automatisation et choisissez l'événement qui compte, ici **Commentaire résolu**. {% endstep %} {% step %} ### Ajouter l'action Envoyer une requête HTTP * **Méthode :** POST * **URL :** le point de terminaison de l'autre outil, ici votre URL de webhook entrant Slack * **En-têtes :** ce que l'API exige, par exemple un `Authorization` en-tête avec une clé API * **Corps :** JSON, avec des variables du déclencheur. Pour Slack : ```json { "text": "Un commentaire a été résolu sur ASSET_NAME" } ``` Remplacez `ASSET_NAME` par une variable : supprimez-le, saisissez `{`, puis choisissez le nom de l'asset dans le déclencheur. Insérez les autres valeurs des étapes précédentes de la même façon. {% endstep %} {% step %} ### Utilisez la réponse si nécessaire La réponse à la requête est disponible pour les étapes suivantes. Par exemple, vous pouvez stocker un ID renvoyé par l'autre outil dans un champ de métadonnées Shade avec **Mettre à jour les métadonnées de l'asset**. {% endstep %} {% endstepper %} {% hint style="info" %} Une réponse autre que 2xx de l'autre outil n'arrête pas l'automatisation à elle seule. Si les étapes suivantes dépendent de la réussite de la requête, ajoutez un **Si / Sinon** sur la **statut** sortie. {% endhint %} ## Variantes * **Connecteur sans code :** si l'autre outil est sur Zapier, vous n'aurez peut-être pas besoin de webhooks du tout. Voir [Intégration Zapier](https://academy.shade.inc/workspaces-and-drives/zapier-integration). * **Abonnements aux événements pour les développeurs :** pour recevoir les événements Shade dans votre propre service, consultez [Webhooks](https://academy.shade.inc/developers/webhooks). ## Guides associés * [Créer un dossier pour chaque nouveau projet](/guides/guides-fr/objets-personnalises-et-metadonnees/creez-un-dossier-pour-chaque-nouveau-projet.md) * [Utiliser le MCP de Shade avec Claude ou Cursor](/guides/guides-fr/recherche-ia-et-archives/utiliser-le-mcp-de-shade-avec-claude-ou-cursor.md) * [guides pour les développeurs](/guides/guides-fr/guides-pour-les-developpeurs.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://academy.shade.inc/guides/guides-fr/automatisations/connectez-shade-a-dautres-outils-avec-des-webhooks.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.