Calendly

Vos types de rendez-vous, vos événements planifiés et leurs invités — pour envoyer un lien de prise de rendez-vous ou réagir à une réservation.

Une connexion Calendly permet au nœud Calendly de lister vos types de rendez-vous avec leur lien de réservation, de lister et lire les rendez-vous planifiés avec leurs invités, et d’annuler un rendez-vous. L’usage type : répondre à un e-mail en proposant un lien de prise de rendez-vous.

La connexion porte un jeton d’accès personnel Calendly. Il est chiffré au repos, appliqué par le serveur au moment de l’appel, et n’apparaît jamais dans un workflow.

En bref

• Identifiant : calendly
• Famille : Service
• Configurée par : Un membre (personnelle) ou un administrateur (partagée avec l’organisation)
• Authentification : Clé d’API ou jeton
• Type de credential : service:calendly
• Documentation officielle de l’API : https://developer.calendly.com/api-docs
• URL de base de l’API : https://api.calendly.com
• Limite de débit appliquée par Mankomail : 60 requêtes par minute et par connexion ; jusqu’à 3 tentatives sur un 429 ou un 5xx
• Test de connexion : Oui

Pas à pas

Les mêmes étapes s’affichent dans le formulaire de connexion de l’application.

1. Ouvrez Calendly, puis « Integrations & apps » → « API & webhooks ».
2. Dans « Personal access tokens », cliquez sur « Generate new token » et donnez-lui un nom.
3. Copiez le jeton affiché et collez-le ci-dessous : Calendly ne le montrera plus jamais.

Champs de la connexion

Champ	Nature	Requis	Remarques
Jeton personnel (token)	Secret — jamais réaffiché	Oui	Il donne accès à votre compte Calendly avec vos propres droits.

Avant de commencer

• Le jeton se crée par l’utilisateur Calendly dont les workflows utiliseront l’agenda, depuis Integrations & apps → API & webhooks.
• Le jeton agit avec les droits de cet utilisateur. Chaque liste porte sur lui seul : Lister mes types de rendez-vous rend les types du compte qui possède le jeton, pas ceux de toute l’organisation.
• Chaque personne qui veut ses propres types de rendez-vous dans un workflow crée son propre jeton et sa propre connexion.

Autorisations

Un jeton d’accès personnel Calendly n’a aucun scope à cocher dans Mankomail : la connexion peut ce que le compte peut. Le nœud s’en sert pour :

Action	Appel Calendly
Lire mon compte	GET /users/me — rend aussi le lien de réservation du compte.
Lister mes types de rendez-vous	GET /users/me, puis GET /event_types pour cet utilisateur. Seuls les types actifs sont listés.
Lister les rendez-vous planifiés	GET /users/me, puis GET /scheduled_events pour cet utilisateur, filtrable par statut, période et type de rendez-vous.
Lire un rendez-vous	Le rendez-vous et, avec Inclure les invités, ses invités.
Annuler un rendez-vous	Annule le rendez-vous avec le Motif d’annulation. C’est la seule action qui modifie quelque chose chez Calendly.

Ajouter la connexion

1. Ouvrez Connexions. Dans la section Services tiers, repérez la carte Calendly et cliquez sur Connecter.
2. Donnez un Nom à la connexion — par exemple le nom de la personne — et choisissez la Portée : Personnelle (vous seul la voyez et l’utilisez) ou Organisation (toute l’organisation l’utilise ; seul un administrateur peut la créer).
3. Collez le jeton, puis cliquez sur Créer la connexion.
4. De retour dans la liste, cliquez sur Configurer sur la nouvelle connexion, puis sur Tester la connexion.

Le test appelle GET /users/me. Quand le jeton est valide, il affiche La connexion fonctionne, suivi du nom (ou de l’e-mail) du compte. Un jeton refusé échoue avec « la clé est refusée par le service ».

Dans un nœud, choisissez la connexion dans Connexion Calendly. La liste Type de rendez-vous propose les types actifs du compte, avec leur durée pour distinguer deux homonymes. Elle accepte aussi l’URI d’API d’un type collée telle quelle (https://api.calendly.com/event_types/…) ; l’URL publique d’une page de réservation (https://calendly.com/nom/30min) n’est pas acceptée, car elle ne contient pas l’identifiant d’API.

Pour remplacer le jeton, ouvrez Configurer, collez la nouvelle valeur et enregistrez ; un champ secret laissé vide conserve la valeur en place. Supprimer est refusé tant qu’un workflow publié utilise la connexion.

Webhooks

Mankomail n’a pas de déclencheur Calendly dédié.

Pour démarrer un workflow sur une réservation Calendly, utilisez le déclencheur générique Webhook reçu et déclarez son URL (<PUBLIC_BASE_URL>/hooks/wf/<jeton>) comme abonnement webhook chez Calendly. Dans ce cas, le jeton de l’URL est la seule preuve d’origine : le déclencheur générique ne vérifie pas l’en-tête Calendly-Webhook-Signature, et le corps arrive sous data.webhook.

Erreurs fréquentes

Message ou code	Cause	Que faire
Test : « la clé est refusée par le service » (integration.unauthorized)	Jeton révoqué ou mal copié.	Générez un nouveau jeton dans Calendly et remplacez-le dans Configurer.
Test : « le quota du service est dépassé » (integration.rate_limited)	Calendly a répondu 429.	Le jeton est bon : réessayez dans un moment.
Test : « le service n’a pas répondu » (integration.unavailable)	Panne réseau ou panne de Calendly.	Réessayez.
integration.unauthorized pendant une exécution	401 ou 403.	Remplacez le jeton. Rejouer n’y changera rien.
integration.not_found	404 : l’URI du type ou du rendez-vous n’existe pas pour ce compte.	Vérifiez l’URI et la connexion choisie.
integration.rejected	400 ou 422 : Calendly a refusé la requête (par exemple annuler un rendez-vous déjà annulé, ou une période invalide).	Corrigez le paramétrage du nœud.
integration.rate_limited	429 après les nouvelles tentatives. Mankomail envoie au plus 60 requêtes par minute et par connexion (la limite des offres Calendly les plus basses) et réessaie jusqu’à 3 fois en respectant Retry-After.	Temporaire : le moteur reprend l’étape plus tard.
integration.unavailable	5xx, 409 ou panne réseau, après rejeu.	Temporaire : le moteur reprend l’étape plus tard.
integration.connection_unusable	La connexion a été supprimée, n’est pas active, est hors de votre portée, ou appartient à un autre service.	Choisissez une connexion valide dans le nœud.

Nœuds qui utilisent cette connexion

• Calendly — calendly.api