> 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/01-introduction.md).

# Introduction

## Vue d'ensemble

TousQuali te permet de connecter ton organisme de formation à tes autres outils grâce à son **API** et ses intégrations avec des plateformes d'automatisation.

* 🔗 Connecte TousQuali à tes outils existants (CRM, tableur, site web...)
* 🤖 Automatise des tâches répétitives avec Zapier
* 📊 Récupère tes données (formations, sessions, inscriptions) en temps réel
* 🔒 Accès sécurisé par clé API personnelle

## C'est quoi une API ?

Une **API** (Interface de Programmation), c'est un pont entre TousQuali et tes autres outils. Concrètement, ça permet à un logiciel externe de **lire tes données** TousQuali de manière automatique et sécurisée.

> 💡 **Pas besoin d'être développeur·euse !** Grâce aux plateformes comme Zapier, tu peux créer des automatisations sans écrire une seule ligne de code.

## Cas d'usage concrets

### 📋 Synchronisation avec ton CRM

Récupère automatiquement la liste de tes inscrit·es pour l'ajouter dans ton CRM (HubSpot, Notion, Google Sheets...).

### 📊 Tableaux de bord personnalisés

Crée des rapports sur mesure en récupérant tes données de sessions et de formations dans Google Sheets ou Excel.

### 🌐 Affichage sur ton site web

Affiche automatiquement ton catalogue de formations ou tes prochaines sessions sur ton site internet.

### 📬 Notifications personnalisées

Envoie des alertes sur Slack ou par email quand une nouvelle inscription arrive.

### 🔄 Synchronisation comptable

Synchronise tes données de facturation avec ton logiciel de comptabilité.

## Ce dont tu as besoin

Pour commencer à utiliser les intégrations TousQuali :

1. **Un compte TousQuali actif** avec un abonnement en cours
2. **Ta clé API** (générée depuis les paramètres de ton compte)
3. **Un outil d'automatisation** (Zapier...) ou un·e développeur·euse pour une intégration sur mesure

## Données disponibles

L'API te donne accès en **lecture** aux données suivantes :

| Donnée             | Description                                           |
| ------------------ | ----------------------------------------------------- |
| **Formations**     | Catalogue de tes formations (nom, statut...)          |
| **Sessions**       | Tes sessions planifiées (dates, format, lieu...)      |
| **Inscriptions**   | Les inscrit·es à tes sessions (nom, email, statut...) |
| **Lieux**          | Tes lieux de formation                                |
| **Clients**        | Les entreprises clientes de tes sessions              |
| **Formateur·ices** | Les intervenant·es assigné·es à tes sessions          |

> ⚠️ **Lecture seule** : L'API permet uniquement de **consulter** tes données. Il n'est pas possible de créer ou modifier des données via l'API.

## Questions fréquentes

**Q : Faut-il des compétences techniques pour utiliser les intégrations ?** R : Non ! Avec Zapier, tu peux créer des automatisations en quelques clics, sans aucune compétence technique. Si tu souhaites une intégration plus poussée, un·e développeur·euse pourra utiliser l'API directement.

**Q : L'accès à l'API est-il inclus dans mon abonnement ?** R : Oui, l'API est accessible avec ton abonnement TousQuali, sans surcoût.

**Q : Mes données sont-elles sécurisées ?** R : Absolument. L'accès à l'API nécessite une **clé API personnelle** qui n'expose que les données de **ton** organisme. Aucun accès aux données d'autres organismes n'est possible.

**Q : Puis-je créer ou modifier des données via l'API ?** R : Non, l'API est en lecture seule pour le moment. Tu peux consulter tes formations, sessions et inscriptions, mais pas les créer ou les modifier.