Passer au contenu principal

Intégration Calendly - Guide de configuration

Connectez votre compte Calendly à Goodweek pour gérer les liens de planification, les événements et les disponibilités directement depuis votre espace de travail IA.

A
Écrit par Antoine Stempien

Connectez votre compte Calendly à Goodweek pour gérer les liens de planification, les événements et les disponibilités directement depuis votre espace de travail IA.

ℹ️ Note sur la gouvernance

Goodweek ne dépassera jamais les niveaux d'accès accordés à l'utilisateur au sein de Calendly, garantissant ainsi l'alignement avec les politiques de gouvernance de votre organisation. Les résultats et les fonctionnalités disponibles peuvent varier selon les autorisations spécifiques et l'accès authentifié de chaque utilisateur.

📋 Prérequis

Avant qu'un utilisateur puisse voir et connecter l'intégration Calendly, l'administrateur de votre organisation doit d'abord l'activer depuis le Panneau d'administration Goodweek, sous l'onglet Intégrations.

Configuration administrateur

L'intégration Calendly utilise OAuth 2.0 et ne nécessite aucune approbation au niveau administrateur au sein de Calendly avant que les utilisateurs puissent se connecter.

⚠️ Si votre compte Calendly est connecté à Microsoft 365 / Outlook

Si les utilisateurs de votre organisation utilisent Calendly avec l'authentification unique Microsoft 365 ou ont leur calendrier Outlook connecté à Calendly, ils peuvent voir un message « Approbation requise » ou « Consentement de l'administrateur requis » pendant le processus de connexion. Cela est dû au fait que Microsoft Entra ID exige le consentement de l'administrateur pour les autorisations Microsoft Graph demandées par Calendly (en particulier Calendars.ReadWrite.shared), et n'est pas lié à Goodweek ou à Composio.

Pour résoudre ce problème, un administrateur global Microsoft 365 doit accorder le consentement de l'administrateur à l'échelle du tenant pour l'application Calendly dans Microsoft Entra :

  1. Accédez au centre d'administration Microsoft Entra à l'adresse entra.microsoft.com.

  2. Accédez à Applications d'entreprise → recherchez « Calendly ».

  3. Ouvrez l'application Calendly → Autorisations → Accorder le consentement de l'administrateur pour [votre organisation].

  4. Assurez-vous que « Consentement au nom de votre organisation » est sélectionné avant de confirmer.

Connexion de l'utilisateur

  1. Dans Goodweek, accédez à Intégrations.

  2. Trouvez Calendly et cliquez sur Connecter.

  3. Vous serez redirigé vers Calendly, où il vous sera demandé de vous connecter et d'autoriser l'accès.

  4. Cliquez sur Autoriser pour accorder l'accès et revenir à Goodweek.

Remarques importantes

  • Chaque utilisateur doit connecter son propre compte individuellement.

  • Goodweek ne peut accéder qu'aux types d'événements, aux événements programmés et aux disponibilités Calendly que votre compte utilisateur individuel est autorisé à consulter.

  • Si votre organisation utilise Calendly Teams, les données au niveau de l'équipe ne sont accessibles que si votre rôle Calendly inclut les autorisations appropriées.

  • Vous pouvez révoquer l'accès de Goodweek à tout moment depuis Calendly → Intégrations → Applications connectées → Composio → Supprimer.


Outils disponibles

Outil

Description

Type

List Event Types

Répertorie tous les types d'événements associés à un utilisateur ou une organisation spécifiques dans Calendly.

Lecture

Get Event Type

Récupère les détails d'un type d'événement Calendly spécifique par son UUID.

Lecture

Get Event Type Availability

Récupère les horaires de disponibilité configurés pour un type d'événement spécifique.

Lecture

List Event Type Available Times

Récupère les créneaux horaires disponibles pour un type d'événement dans une plage horaire spécifiée.

Lecture

Create Event Type

Crée un nouveau type d'événement individuel dans Calendly.

Écriture

Update Event Type

Met à jour les paramètres d'un type d'événement individuel existant.

Écriture

List Scheduled Events

Récupère une liste d'événements programmés Calendly pour un utilisateur ou une organisation avec des filtres optionnels.

Lecture

Get Event

Récupère un événement programmé Calendly spécifique par son UUID.

Lecture

List Event Invitees

Récupère une liste d'invités pour un événement spécifique avec des filtres optionnels de statut et d'e-mail.

Lecture

Get Event Invitee

Récupère des informations détaillées sur un invité spécifique d'un événement.

Lecture

Create Scheduling Link

Crée un lien de planification qui peut être utilisé pour réserver un événement.

Écriture

Create Single Use Scheduling Link

Crée un lien de planification à usage unique pour un type d'événement, qui expire après une réservation.

Écriture

Create Share

Crée un lien de partage personnalisable et à usage unique pour un type d'événement Calendly, avec des remplacements de paramètres optionnels.

Écriture

Get User

Récupère des informations détaillées sur un utilisateur Calendly existant.

Lecture

Get User Availability Schedule

Récupère l'horaire de disponibilité d'un utilisateur par son UUID.

Lecture

List User Availability Schedules

Récupère tous les horaires de disponibilité d'un utilisateur Calendly spécifique.

Lecture

List User Busy Times

Récupère les créneaux horaires occupés d'un utilisateur à partir de calendriers internes et externes pendant une durée maximale de 7 jours.

Lecture

Get Organization

Récupère des informations sur une organisation Calendly spécifique.

Lecture

List Organization Memberships

Récupère une liste des adhésions à l'organisation.

Lecture

List Routing Forms

Récupère les formulaires de routage d'une organisation spécifiée.

Lecture

List Routing Form Submissions

Répertorie toutes les soumissions associées à un formulaire de routage spécifique.

Lecture

Mark Invitee as No-Show

Marque un invité comme absent à un événement programmé.

Lecture

Cancel Scheduled Event

Annule un événement programmé Calendly en créant un enregistrement d'annulation.

⚠️ Destructif

Delete Invitee Data

Supprime définitivement toutes les données des invités associées aux adresses e-mail spécifiées des événements passés de l'organisation, à des fins de confidentialité des données.

⚠️ Destructif

Cas d'usage

  • Consultez votre agenda et vos prochaines réunions. Récupérez une liste de vos événements programmés dans Calendly et de leurs invités directement depuis Goodweek pour consulter votre calendrier sans changer d'application.

  • Trouvez des créneaux disponibles avant de proposer une réunion. Interrogez les créneaux disponibles pour un type d'événement spécifique afin d'identifier les créneaux libres avant de contacter un client ou un collègue pour planifier une réunion.

  • Générez des liens de planification à la demande. Créez des liens de planification à usage unique ou standard pour un type d'événement spécifique directement depuis une conversation Goodweek, prêts à être partagés avec un contact.

  • Consultez les soumissions de formulaires de routage. Accédez aux réponses des formulaires de routage Calendly pour comprendre comment les demandes de réunion entrantes sont orientées au sein de votre équipe.


Dépannage

« Approbation requise » ou « Consentement de l'administrateur requis » lors de la connexion

Cela est dû au fait que Microsoft Entra exige le consentement de l'administrateur pour les autorisations Microsoft 365 demandées par Calendly. Un administrateur global Microsoft 365 doit accorder le consentement comme décrit dans la section de configuration administrateur ci-dessus.

La connexion fonctionnait auparavant mais affiche désormais « Approbation requise »

Calendly a récemment ajouté le champ d'application Microsoft Graph Calendars.ReadWrite.shared. L'administrateur devra peut-être accorder à nouveau le consentement pour inclure ce nouveau champ d'application. Suivez les étapes de la section d'avertissement ci-dessus.

Intégration non visible dans Goodweek

Assurez-vous que l'administrateur de votre organisation a activé l'intégration Calendly depuis le Panneau d'administration Goodweek, sous l'onglet Intégrations.

Références

Avez-vous trouvé la réponse à votre question ?