# Intégration Zapier

## Vue d'ensemble

**Zapier** est une plateforme d'automatisation qui te permet de connecter TousQuali à des milliers d'autres outils **sans écrire de code**. TousQuali dispose d'une application officielle dans le catalogue Zapier.

* 🔗 Connecte TousQuali à +7 000 applications (Google Sheets, Slack, HubSpot, Notion, Mailchimp...)
* 🤖 Crée des automatisations (appelées "Zaps") en quelques clics
* ⏰ Exécution automatique en continu
* 🆓 Plan gratuit disponible pour commencer

## Prérequis

Avant de commencer, assure-toi d'avoir :

* ✅ Un compte TousQuali avec un abonnement actif
* ✅ Ta **clé API** TousQuali (voir [Générer ta clé API](/integrations/02-cle-api.md))
* ✅ Un compte Zapier (gratuit sur [zapier.com](https://zapier.com))

***

## Étape 1 : Crée un nouveau Zap

1. Connecte-toi à **Zapier**
2. Clique sur **"Create"** puis **"Zaps"**
3. Dans le champ de recherche d'application, tape **"TousQuali"**
4. Sélectionne l'application **TousQuali**

***

## Étape 2 : Configure la connexion

Lors de la première utilisation, Zapier te demande de connecter ton compte TousQuali :

1. Clique sur **"Sign in"** à côté de TousQuali
2. Colle ta **clé API** dans le champ prévu
3. Clique sur **"Yes, Continue"**

Zapier vérifie automatiquement que ta clé est valide.

> 💡 **Astuce** : Tu n'as besoin de configurer la connexion qu'une seule fois. Elle sera réutilisée pour tous tes Zaps.

***

## Étape 3 : Choisis une action

L'application TousQuali propose les actions suivantes :

### Actions disponibles

| Action                        | Description                            |
| ----------------------------- | -------------------------------------- |
| **Lister les formations**     | Récupère la liste de tes formations    |
| **Obtenir une formation**     | Récupère les détails d'une formation   |
| **Lister les sessions**       | Récupère la liste de tes sessions      |
| **Obtenir une session**       | Récupère les détails d'une session     |
| **Lister les inscriptions**   | Récupère les inscrit·es à tes sessions |
| **Obtenir une inscription**   | Récupère les détails d'une inscription |
| **Lister les lieux**          | Récupère tes lieux de formation        |
| **Obtenir un lieu**           | Récupère les détails d'un lieu         |
| **Lister les clients**        | Récupère les clients de tes sessions   |
| **Lister les formateur·ices** | Récupère les formateur·ices assigné·es |

Chaque action propose des **filtres** pour affiner tes recherches (par nom, statut, dates, etc.).

***

## Exemples de Zaps

### 📊 Synchroniser tes inscriptions dans Google Sheets

**Zap** : Récupère régulièrement les inscriptions et ajoute-les dans un tableur.

1. **Trigger** : Schedule (toutes les heures)
2. **Action 1** : TousQuali → Lister les inscriptions
3. **Action 2** : Google Sheets → Ajouter une ligne

### 📬 Notification Slack pour les nouvelles inscriptions

**Zap** : Reçois un message Slack quand de nouvelles inscriptions arrivent.

1. **Trigger** : Schedule (toutes les 15 minutes)
2. **Action 1** : TousQuali → Lister les inscriptions (filtre par date récente)
3. **Action 2** : Slack → Envoyer un message dans un canal

### 📋 Export hebdomadaire des sessions

**Zap** : Chaque lundi, exporte les sessions de la semaine.

1. **Trigger** : Schedule (chaque lundi à 8h)
2. **Action 1** : TousQuali → Lister les sessions (filtre par dates)
3. **Action 2** : Google Sheets → Mettre à jour une feuille

### 🔄 Synchronisation avec ton CRM

**Zap** : Synchronise les données de tes inscrit·es avec HubSpot ou Notion.

1. **Trigger** : Schedule (toutes les heures)
2. **Action 1** : TousQuali → Lister les inscriptions
3. **Action 2** : HubSpot/Notion → Créer ou mettre à jour un contact

***

## Bonnes pratiques

* 🧪 **Teste d'abord** : Utilise le bouton "Test" à chaque étape pour vérifier que tout fonctionne
* 🔍 **Utilise les filtres** : Filtre tes requêtes pour ne récupérer que les données pertinentes
* ⏰ **Choisis le bon intervalle** : Un intervalle de 15 minutes à 1 heure est suffisant dans la plupart des cas
* 📊 **Surveille tes Zaps** : Vérifie régulièrement l'historique dans le "Zap History" pour détecter les erreurs

## Questions fréquentes

**Q : Zapier est-il gratuit ?** R : Zapier propose un plan gratuit avec 100 tâches par mois. Des plans payants sont disponibles pour plus de volume.

**Q : Quelle est la différence entre un Trigger et une Action ?** R : Un **Trigger** est l'événement qui déclenche ton Zap (ex : toutes les heures). Une **Action** est ce qui se passe ensuite (ex : récupérer des données TousQuali, ajouter une ligne dans Google Sheets).

**Q : Mes Zaps s'arrêtent si je régénère ma clé API ?** R : Oui. Si tu régénères ta clé, tu devras mettre à jour la connexion dans Zapier avec la nouvelle clé.

**Q : Combien de requêtes puis-je faire par jour ?** R : L'API n'impose pas de limite stricte, mais nous te recommandons de rester raisonnable (quelques centaines de requêtes par jour maximum) pour garantir la qualité du service pour tou·tes.


---

# Agent Instructions: 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:

```
GET https://documentation.tousquali.fr/integrations/04-zapier.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.