Flux de calendrier (ICS)

Pourquoi c’est important

Tout le monde ne souhaite pas accorder un accès OAuth à son calendrier. Les flux de calendrier vous permettent de connecter n’importe quel calendrier pour la détection de conflits en collant simplement une URL. Pas d’OAuth, pas de boîte de dialogue de permissions, pas d’autorisation d’application tierce.

Cela fonctionne avec :

• Google Calendar (personnel ou Workspace)
• Microsoft Outlook / Office 365
• Apple Calendar (iCloud)
• Toute application de calendrier proposant une URL d’export ICS/iCal

Kit interroge votre flux de calendrier toutes les 15 minutes et l’utilise pour masquer les créneaux en conflit lorsque les candidats réservent des entretiens, exactement comme l’intégration Google Calendar.

Ce dont vous avez besoin

• Un compte Kit avec la planification activée
• Une application de calendrier proposant une URL ICS/iCal secrète (la plupart le font)

Ajouter un flux de calendrier

1. Accédez à Intégrations > Flux de calendrier
2. Cliquez sur Ajouter un flux de calendrier
3. Collez l’URL ICS de votre calendrier (doit commencer par https://)
4. Définissez éventuellement un nom d’affichage (Kit le détecte automatiquement depuis le flux)
5. Cliquez sur Ajouter un flux de calendrier

Kit valide l’URL, récupère le flux et commence immédiatement à vérifier les conflits.

Trouver votre URL ICS

Google Calendar

1. Ouvrez Google Calendar et cliquez sur l’icône d’engrenage (Paramètres)
2. Cliquez sur le nom du calendrier dans la barre latérale gauche
3. Faites défiler jusqu’à Adresse secrète au format iCal
4. Copiez l’URL

Important : Utilisez l’adresse secrète, pas l’adresse publique, sauf si votre calendrier est intentionnellement public. L’URL secrète contient un jeton qui accorde un accès en lecture.

Microsoft Outlook / Office 365

1. Ouvrez Outlook sur le web et accédez à Paramètres > Calendrier
2. Cliquez sur Calendriers partagés
3. Sous « Publier un calendrier », sélectionnez le calendrier souhaité
4. Choisissez Peut afficher tous les détails et cliquez sur Publier
5. Copiez le lien ICS (pas le lien HTML)

Apple Calendar (iCloud)

1. Ouvrez l’application Calendrier sur votre Mac
2. Faites un clic droit sur le calendrier que vous souhaitez partager
3. Sélectionnez Partager le calendrier…
4. Cochez Calendrier public
5. Copiez l’URL qui apparaît

Comment ça fonctionne

Aspect	Détail
Fréquence d’interrogation	Toutes les 15 minutes
Données consultées	Uniquement les heures de début/fin et le statut occupé/libre
Données stockées	Uniquement les plages horaires occupées (aucun contenu d’événement)
Plage temporelle	30 prochains jours
Événements récurrents	Automatiquement développés (quotidien, hebdomadaire, mensuel)
Événements sur toute la journée	Bloquent la journée entière

Lorsqu’un candidat consulte les créneaux d’entretien disponibles, Kit soustrait les plages occupées de votre calendrier de votre planning de disponibilité, exactement de la même manière qu’avec Google Calendar.

Intégration Google Calendar vs flux de calendrier

Fonctionnalité	Google Calendar (OAuth)	Flux de calendrier (ICS)
Détection de conflits	Temps réel	Délai de 15 minutes
Invitations d’entretien	Envoyées par e-mail au format .ics (jamais écrites dans votre calendrier)	Envoyées par e-mail au format .ics (jamais écrites dans votre calendrier)
Configuration	Autorisation OAuth	Coller une URL
Compatible avec	Google Calendar uniquement	Tout fournisseur de calendrier
Confidentialité	Nécessite des permissions de calendrier	Basée sur l’URL, aucun accès au compte
Événements sur toute la journée	Pris en charge	Pris en charge
Événements récurrents	Gérés par l’API Google	Développés depuis le flux

Utilisez Google Calendar si vous souhaitez une détection de conflits en temps réel. Aucune des deux options n’écrit dans votre calendrier – les invitations d’entretien sont toujours envoyées par e-mail au format .ics.

Utilisez les flux de calendrier si vous préférez ne pas accorder d’accès OAuth, si vous utilisez un calendrier non Google, ou si vous souhaitez ajouter un calendrier secondaire d’un autre fournisseur.

Vous pouvez utiliser les deux simultanément. Kit fusionne les plages occupées de toutes les sources connectées.

Gérer les flux de calendrier

Modifier un flux

Accédez à Intégrations > Flux de calendrier, trouvez votre flux dans la section Flux de calendrier et cliquez sur l’icône de crayon. Vous pouvez modifier le nom d’affichage et activer ou désactiver la vérification des conflits.

Rafraîchir un flux

Cliquez sur le menu à trois points (⋮) à côté d’un flux et sélectionnez Rafraîchir maintenant. Kit récupère immédiatement la dernière version au lieu d’attendre la prochaine interrogation de 15 minutes.

Supprimer un flux

Cliquez sur le menu à trois points (⋮) et sélectionnez Supprimer le flux. Kit cesse de vérifier ce calendrier pour les conflits. Votre calendrier lui-même n’est pas affecté.

Confidentialité et sécurité

Les flux de calendrier sont conçus dans un souci de confidentialité :

• Aucun contenu d’événement stocké – Kit lit uniquement les heures de début/fin et le statut occupé/libre. Les titres, descriptions, participants et lieux des événements sont supprimés immédiatement après l’analyse.
• Stockage chiffré – L’URL de votre calendrier est chiffrée au repos. Elle n’est jamais journalisée ni exposée dans les réponses API.
• HTTPS uniquement – Kit n’accepte que les URL de calendrier en HTTPS.
• Vous contrôlez l’accès – Pour révoquer l’accès de Kit, régénérez l’URL secrète de votre calendrier dans votre application de calendrier (Google, Outlook, etc.). L’ancienne URL cesse de fonctionner immédiatement.

Révoquer l’accès

Contrairement à OAuth (où vous révoquez depuis Kit ou votre compte Google), l’accès au flux de calendrier est contrôlé par l’URL elle-même :

1. Accédez aux paramètres de votre application de calendrier
2. Trouvez le calendrier publié/partagé
3. Cliquez sur « Réinitialiser » ou « Annuler la publication » pour invalider l’ancienne URL
4. Dans Kit, supprimez l’ancien flux et ajoutez la nouvelle URL si nécessaire

Résolution de problèmes

Le flux ne se met pas à jour

Causes possibles :

1. L’URL du calendrier a été révoquée ou régénérée
2. Votre fournisseur de calendrier est temporairement indisponible
3. Le flux est en pause après des échecs répétés

Solution :

• Vérifiez le statut du flux dans Intégrations > Flux de calendrier
• Cliquez sur Rafraîchir maintenant pour forcer une mise à jour immédiate
• Si l’URL a été régénérée, supprimez l’ancien flux et ajoutez la nouvelle URL

Événements manquants dans la détection de conflits

Causes possibles :

1. L’événement est marqué comme « libre » (transparent) dans votre calendrier
2. L’événement utilise un modèle de récurrence inhabituel que Kit ne peut pas développer
3. L’événement se situe à plus de 30 jours dans le futur

Solution :

• Modifiez l’événement dans votre calendrier et définissez le statut sur « occupé »
• Pour les événements récurrents, vérifiez d’abord qu’ils apparaissent correctement dans votre application de calendrier

Le flux affiche « Erreur » ou « En pause »

Kit met en pause les flux après des échecs de récupération répétés pour éviter les requêtes inutiles.

• Erreur (3+ échecs) : Kit continue d’essayer. Vérifiez que votre URL est valide.
• En pause (échecs prolongés) : Kit a cessé l’interrogation. Supprimez le flux et ajoutez-le à nouveau avec une nouvelle URL.

Checklist rapide

• Accédez à Intégrations > Flux de calendrier
• Cliquez sur Ajouter un flux de calendrier
• Collez l’URL ICS secrète de votre calendrier
• Vérifiez que le flux s’affiche comme « Actif » après quelques minutes
• Testez en consultant une page de réservation candidat et en confirmant que les créneaux en conflit sont masqués
• Ajoutez éventuellement des flux pour d’autres calendriers (personnel, d’équipe, etc.)