> 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/shade-academy/shade-academy-fr/espaces-de-travail-et-lecteurs/integration-zapier.md).

# Intégration Zapier

L’intégration Zapier de Shade vous permet de connecter votre espace de travail à des milliers d’outils et services externes. Vous pouvez utiliser Shade comme déclencheur — en écoutant des événements tels que des téléchargements ou des transcriptions terminées — ou comme cible d’action, en exécutant des opérations dans Shade en réponse à des événements survenant ailleurs. Cela simplifie la création de workflows automatisés sans كتابة de code.

## Premiers pas

Avant de connecter Shade à Zapier, vous aurez besoin de trois éléments provenant des paramètres de votre espace de travail :

* **Clé d’intégration Zapier** — Disponible dans Paramètres → Pour les développeurs. Cette clé est unique à votre espace de travail.
* **ID de l’application** — Également disponible dans la section Pour les développeurs. Il s’agit de l’ID de votre espace de travail.
* **Clé API** — Générée séparément via Paramètres → Clés API.

Lorsque vous connectez votre compte Shade dans Zapier, il vous sera demandé de saisir ces trois éléments. Une fois la connexion établie, votre espace de travail Shade sera disponible à la fois comme source de déclenchement et comme cible d’action dans l’ensemble de vos Zaps.

## Configuration des webhooks

Le tableau de bord des webhooks (Paramètres → Pour les développeurs) est l’endroit où vous gérez les événements que Shade envoie à des services externes. Depuis cette page, vous pouvez configurer une URL de point de terminaison (comme une URL de webhook Zapier) pour recevoir les événements émis par votre espace de travail.

Des événements sont émis pour les moments clés de votre workflow, par exemple lorsqu’un fichier est téléversé ou lorsqu’une transcription se termine. Chaque événement inclut des métadonnées pertinentes sur l’élément concerné, que les services en aval peuvent utiliser pour effectuer des actions supplémentaires.

## Déclencheurs et actions

Dans Zapier, Shade prend en charge à la fois les déclencheurs et les actions, ce qui vous offre de la flexibilité dans la manière de créer vos workflows.

*Déclencheurs* écoutent les événements dans Shade et lancent un Zap lorsqu’un événement se produit, comme le téléversement d’un nouveau fichier ou l’achèvement d’une transcription.

*Actions* permettent à d’autres applications de déclencher une activité dans Shade, comme la génération d’un lien de partage pour un élément spécifique.

## Exemples de workflows

* **Générer un lien de partage au moment du téléversement :** Lorsqu’un fichier est téléversé dans Shade, générez et partagez automatiquement un lien public, utile pour distribuer des éléments à des parties prenantes externes sans étape manuelle.

<figure><img src="/files/c4b667c29d12a6c3568ea3784a1fc3fbaa3af12e" alt=""><figcaption></figcaption></figure>

* **Envoyer les transcriptions vers un service externe :** Lorsqu’une transcription se termine, transférez le contenu de la transcription vers un autre outil, tel qu’un éditeur de documents, un CRM ou un service de notification.

## Trouver des éléments dans les workflows Zapier

Lorsqu’un fichier est d’abord téléversé dans Shade, son ID d’élément n’est pas immédiatement connu des systèmes externes. Pour faire référence à un élément spécifique dans une action ultérieure, utilisez le **chemin**, qui est inclus dans la charge utile du webhook de téléversement. Le chemin identifie de manière unique l’emplacement de l’élément dans votre drive et peut être utilisé pour rechercher ou agir sur l’élément dans Shade depuis votre Zap. Vous pouvez également utiliser l’ID de l’élément dans une action distincte.

## Points à garder à l'esprit

* Votre clé d’intégration Zapier est propre à votre espace de travail. Si vous gérez plusieurs espaces de travail Shade, chacun aura sa propre clé.
* Les clés API sont gérées séparément de la clé d’intégration et peuvent être générées ou révoquées via Paramètres → Clés API.
* Les points de terminaison des webhooks doivent être configurés dans le tableau de bord des webhooks avant que Shade ne commence à envoyer des événements à un service externe.

Pour plus d’informations sur la configuration des automatisations Zapier, consultez la documentation de Zapier ici : <https://help.zapier.com/hc/en-us/articles/22234847450893-Zaps-quick-start-guide>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/espaces-de-travail-et-lecteurs/integration-zapier.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
