# Templates de Workflows Google Calendar
Ce répertoire contient des templates réutilisables pour les workflows Google Calendar dans n8n. Ces templates sont conçus pour être facilement intégrés dans vos projets et sont particulièrement adaptés pour les systèmes de réservation qui seront consommés par des applications NextJS.
## Templates disponibles
### 1. Création d'événements
- Fichier: `event-creation.json`
- Description: Workflow pour créer des événements dans Google Calendar avec validation des entrées et gestion des erreurs.
- Fonctionnalités:
- Validation des formats de date/heure
- Gestion des fuseaux horaires
- Vérification des conflits
- Gestion des erreurs d'API
- Rafraîchissement automatique des tokens OAuth
### 2. Vérification de disponibilité
- Fichier: `availability-check.json`
- Description: Workflow pour vérifier la disponibilité d'une plage horaire dans Google Calendar.
- Fonctionnalités:
- Recherche d'événements sur une plage de dates
- Calcul des créneaux disponibles
- Mise en cache des résultats pour optimiser les performances
- Gestion des fuseaux horaires
### 3. Gestion des notifications
- Fichier: `event-notifications.json`
- Description: Workflow pour envoyer des notifications avant et après les événements Google Calendar.
- Fonctionnalités:
- Notifications par email, SMS ou webhook
- Rappels programmables (15 min, 1 heure, 24 heures avant l'événement)
- Personnalisation des messages avec formatage HTML
- Gestion des erreurs d'envoi et de récupération d'événements
- Marquage des notifications envoyées pour éviter les doublons
### 4. Gestion des annulations/modifications
- Fichier: `event-modifications.json`
- Description: Workflow pour gérer les annulations et modifications d'événements dans Google Calendar.
- Fonctionnalités:
- Détection automatique des événements annulés
- Détection des modifications d'événements
- Analyse des changements apportés (date/heure, lieu, description, participants)
- Notifications par email aux participants avec formatage HTML
- Notifications par webhook pour intégration avec d'autres systèmes
- Marquage des notifications envoyées pour éviter les doublons
## Utilisation
Pour utiliser ces templates:
1. Importez le fichier JSON dans votre instance n8n
2. Configurez les credentials Google Calendar OAuth2
3. Personnalisez les paramètres selon vos besoins
4. Activez le workflow
## Intégration avec NextJS
Ces templates sont conçus pour être facilement consommés par une API NextJS. Chaque template expose des webhooks avec une documentation OpenAPI complète.
## Validation
Tous ces templates sont conformes aux bonnes pratiques validées par le `CalendarIntegrationValidator` du serveur MCP n8n. Ils respectent les limites de quota de l'API Google Calendar et implémentent les mécanismes de rafraîchissement des tokens OAuth.
## Bonnes pratiques implémentées
- **Gestion des erreurs**: Tous les templates incluent une gestion robuste des erreurs d'API
- **Rafraîchissement OAuth**: Détection et gestion automatique des erreurs d'authentification
- **Gestion des quotas**: Respect des limites d'API Google Calendar
- **Validation des entrées**: Vérification des formats de date/heure et autres paramètres
- **Documentation**: Chaque template inclut une documentation complète dans ses métadonnées
- **Modularité**: Les workflows sont conçus pour être facilement intégrés dans d'autres workflows
- **Performance**: Utilisation de mise en cache et d'optimisations pour réduire les appels API