Calendly — événement

Démarre le workflow quand Calendly signale un rendez-vous réservé, annulé ou une absence. Le corps signé arrive dans data.calendly.

Le déclencheur Calendly — événement démarre le workflow quand Calendly signale un événement sur l’URL du workflow, en temps réel : un rendez-vous réservé (invitee.created), annulé (invitee.canceled), une absence signalée ou retirée, un formulaire de routage envoyé.

Comme les autres déclencheurs par webhook signé :

• L’origine est prouvée. Calendly signe chaque corps (en-tête Calendly-Webhook-Signature, t=…,v1=…, HMAC-SHA256 de <t>.<corps brut>). La signature est vérifiée avec la « Clé de signature des webhooks » de la connexion Calendly avant toute écriture, et une livraison de plus de trois minutes est refusée.
• Le tri a lieu d’abord. Seuls les événements cochés lancent une exécution ; les autres sont acquittés et écartés.

L’exécution n’a pas de mail porteur : les nœuds qui agissent sur le mail déclencheur (répondre dans le fil, Classer, Marquer) ne peuvent pas suivre ce déclencheur. Envoyer reste utilisable si vous choisissez la boîte d’envoi sur le nœud.

Pour le mettre en place :

1. Ajoutez le déclencheur, choisissez la connexion Calendly et les événements, puis publiez. L’URL <PUBLIC_BASE_URL>/hooks/wf/<jeton> est délivrée à la première publication et n’est rendue qu’une fois.
2. Créez l’abonnement côté Calendly avec cette URL et une clé de signature de votre choix : POST /webhook_subscriptions par le nœud Calendly (requête libre), avec url, events, organization, scope et signing_key.
3. Collez la même clé dans le champ « Clé de signature des webhooks » de la connexion Calendly.

En bref

• Type : trigger.calendly · version 1
• Catégorie : Déclencheurs
• Nature : Déclencheur — lance une exécution
• Effet : Sans effet externe (none) — rien n’est écrit hors de Loop & Roll ; rejouable sans risque
• Exige un mail porteur : Non
• Connexion : Calendly
• Sorties : main

Les ports de « Calendly — événement » : ce qui entre à gauche, ce qui sort à droite

Connexion

Ce nœud exige une connexion Calendly.

Paramètres

connection

Connexion Calendly — La connexion Calendly à employer. Elle se crée une fois dans Connexions ; sa clé n’apparaît jamais dans le workflow.

• Type : Connexion (credential)
• Requis : Oui
• Défaut : "" (vide)

events

Événements — Ce qui déclenche ce workflow. Rien de coché = tout ce que Calendly envoie sur cette URL. Une annulation arrive avec data.calendly.payload.rescheduled à vrai quand c’est un report.

• Type : Plusieurs choix (multiOptions)
• Requis : Non
• Défaut : ["invitee.created","invitee.canceled"]
• Options :
  • invitee.created — Rendez-vous réservé
  • invitee.canceled — Rendez-vous annulé
  • invitee_no_show.created — Invité absent signalé
  • invitee_no_show.deleted — Absence annulée
  • routing_form_submission.created — Formulaire de routage soumis

Sorties

• main — Emprunté par chaque exécution née d’un événement Calendly dont la signature est valide et qui a passé le filtre d’événements.

Données produites

Ce que ce nœud ajoute aux données de l’exécution, et comment le lire dans une expression. <step> désigne la clé de l’étape : le nom du nœud ramené à un identifiant (voir Données et expressions).

• {{ data.calendly }} — object. Le corps JSON de l’événement, tel que Calendly l’a envoyé et signé.
• {{ data.calendly.event }} — string. L’événement, par exemple invitee.created (réservé) ou invitee.canceled (annulé).
• {{ data.calendly.payload.email }} — string. L’adresse de l’invité.
• {{ data.calendly.payload.name }} — string. Le nom de l’invité.
• {{ data.calendly.payload.scheduled_event.start_time }} — string. Le début du rendez-vous (ISO 8601, UTC).
• {{ data.calendly.payload.rescheduled }} — boolean. Sur une annulation : true quand c’est un report (un nouvel invitee.created suit).

Exemple

Quand un prospect réserve une visite, l’ajouter à la Table de suivi et confirmer par mail. Le déclencheur coche « Rendez-vous réservé ». À chaque réservation, un nœud Table — ajouter ou mettre à jour écrit {{ data.calendly.payload.email }} et {{ data.calendly.payload.scheduled_event.start_time }}, puis Envoyer écrit à l’invité.

Conseils

• Sans la clé de signature, rien ne passe. Si la clé de la connexion est vide ou fausse, chaque livraison est refusée en 404 et aucune exécution n’est créée.
• Un report est une annulation plus une réservation. Testez {{ data.calendly.payload.rescheduled }} dans une Condition pour les distinguer.
• Pas d’identifiant de livraison. Calendly n’en envoie pas : une livraison que Calendly répète peut lancer une seconde exécution. Rendez les étapes suivantes idempotentes (une Table dont la clé est l’invité, par exemple).
• Contenu non fiable. Le corps vient de l’extérieur : traitez son texte comme une donnée, jamais comme une instruction pour un nœud d’IA.
• Un workflow a au plus un déclencheur Calendly — événement, et seule la version publiée reçoit les événements.