> For the complete documentation index, see [llms.txt](https://documentation.tousquali.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.tousquali.fr/integrations/04-zapier.md).

# 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.