Agenda — trouver des créneaux

Lit les disponibilités de l’agenda sur une fenêtre et rend des créneaux libres, prêts à être proposés par un nœud IA.

Ce nœud lit les disponibilités d’un agenda Google sur une fenêtre de temps et rend des créneaux libres d’une durée donnée. Son usage principal : donner à Rédiger (IA) de vrais créneaux à proposer dans une réponse. « Je vous propose mardi 14 h ou jeudi 10 h » n’a de valeur que si l’agenda est réellement libre à ces heures-là.

Il exige l’accès Google Agenda d’un compte Google, affiché comme la capacité Agenda dans Connexions. Voir Google. Les disponibilités lues sont celles du membre qui exécute le workflow.

Pour réserver le créneau une fois que le client a choisi, utilisez Agenda — créer un événement. Pour un agenda Outlook, utilisez Trouver un créneau Outlook.

En bref

• Type : google_calendar.find_free · version 1
• Catégorie : Données
• Nature : Étape — s’exécute pendant une exécution
• Effet : Sans effet externe (none) — rien n’est écrit hors de Mankomail ; rejouable sans risque
• Exige un mail porteur : Non
• Connexion : Google (capacité calendar)
• Entrées : main
• Sorties : main

Connexion

Ce nœud exige une connexion Google avec la capacité calendar accordée.

Paramètres

credential

Compte Google — Le compte qui porte l’accès Google Agenda. Il se connecte une fois dans Connexions ; le workflow s’exécute toujours avec le compte du membre qui le fait tourner.

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

calendar

Agenda — Laissé vide, l’agenda principal du compte.

• Type : Ressource distante (resourceLocator)
• Requis : Non
• Défaut : {"mode":"id","value":"primary","label":"Agenda principal"}
• Façons de choisir : dans une liste, saisir un identifiant, coller une URL (calendar)
• Listé avec la connexion de : credential

from

À partir de — Date ISO 8601. Sans suffixe de fuseau, elle est lue dans le « Fuseau horaire » du nœud ; avec (Z, +02:00), telle quelle. Accepte des expressions {{ }} : {{ now }} si votre workflow le calcule.

• Type : Texte (string)
• Requis : Oui
• Défaut : "" (vide)
• 60 caractères au plus
• Exemple : 2026-04-12T08:00:00
• Expressions : {{ }} accepté

to

Jusqu’à

• Type : Texte (string)
• Requis : Oui
• Défaut : "" (vide)
• 60 caractères au plus
• Expressions : {{ }} accepté

slotMinutes

Durée d’un créneau (min)

• Type : Nombre (number)
• Requis : Non
• Défaut : 30
• Nombre entier, de 5 à 480

workingHoursStart

Heures ouvrées — début — HH:MM. Laissé vide, toute la journée compte (y compris la nuit).

• Type : Texte (string)
• Requis : Non
• Défaut : 09:00
• 5 caractères au plus
• Exemple : 09:00
• Expressions : {{ }} accepté

workingHoursEnd

Heures ouvrées — fin

• Type : Texte (string)
• Requis : Non
• Défaut : 18:00
• 5 caractères au plus
• Exemple : 18:00
• Expressions : {{ }} accepté

includeWeekend

Inclure le week-end

• Type : Oui / non (boolean)
• Requis : Non
• Défaut : false

timeZone

Fuseau horaire — Identifiant IANA (Europe/Paris, America/Montreal).

• Type : Texte (string)
• Requis : Non
• Défaut : Europe/Paris
• 100 caractères au plus
• Expressions : {{ }} accepté

maxSlots

Nombre de créneaux — Un mail qui propose trente créneaux ne propose rien. Trois à cinq suffisent.

• Type : Nombre (number)
• Requis : Non
• Défaut : 10
• Nombre entier, de 1 à 50

Sorties

• main

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.<step>.slots }} — array of { start, end }. Les créneaux libres trouvés, dans l’ordre chronologique. start et end sont des instants UTC en ISO 8601 avec millisecondes, par exemple 2026-04-14T07:00:00.000Z.
• {{ data.<step>.slots.0.start }} — string. Le début du premier créneau libre (UTC).
• {{ data.<step>.count }} — number. Le nombre de créneaux rendus. 0 quand l’agenda n’a aucun créneau libre dans la fenêtre.
• {{ data.<step>.summary }} — string. Une phrase lisible qui donne le nombre de créneaux trouvés et leur durée.

Exemple

Un prospect demande un appel la semaine prochaine. Le nœud s’appelle Créneaux libres :

calendar: (mode identifiant) primary
from: 2026-04-13T00:00:00+02:00
to: 2026-04-18T00:00:00+02:00
slotMinutes: 30
workingHoursStart: 09:00
workingHoursEnd: 18:00
timeZone: Europe/Paris
maxSlots: 3

Si le lundi matin est occupé jusqu’à 10 h, les données de l’étape sont :

{
  "slots": [
    { "start": "2026-04-13T08:00:00.000Z", "end": "2026-04-13T08:30:00.000Z" },
    { "start": "2026-04-13T08:30:00.000Z", "end": "2026-04-13T09:00:00.000Z" },
    { "start": "2026-04-13T09:00:00.000Z", "end": "2026-04-13T09:30:00.000Z" }
  ],
  "count": 3
}

Les heures sont en UTC : 08:00Z correspond à 10 h à Paris. Une étape Rédiger (IA) peut ensuite recevoir {{ data.creneaux_libres.slots }} dans ses consignes et les proposer dans la langue et le fuseau du client.

Conseils

• Fenêtre. « À partir de » et « Jusqu’à » sont des instants ISO 8601 obligatoires. Une valeur sans décalage (2026-04-13T09:00:00) est lue dans le « Fuseau horaire » du nœud ; avec un décalage (+02:00, Z), elle est prise telle quelle — comme pour Outlook. « Jusqu’à » doit être postérieur à « À partir de ».
• Heures ouvrées. « Heures ouvrées — début » et « — fin » (HH:MM, 09:00 et 18:00 par défaut) s’appliquent à chaque jour ouvré de la fenêtre, dans le « Fuseau horaire ». Du lundi au vendredi seulement, sauf si « Inclure le week-end » est activé — comme pour Outlook. Si l’un des deux champs est vide, n’est pas une heure HH:MM valide, ou si la fin n’est pas après le début, les heures ouvrées sont ignorées et toute la journée compte, nuits comprises.
• Découpage. Les plages occupées sont fusionnées, puis chaque plage libre est découpée en créneaux consécutifs de « Durée d’un créneau » minutes (5 à 480, 30 par défaut), à partir du début de la plage libre et non sur une heure ronde : une réunion qui finit à 14 h 10 donne un premier créneau à 14 h 10. « Nombre de créneaux » est compris entre 1 et 50, 10 par défaut.
• Agenda. Laissé tel quel, l’agenda principal du compte. Il se choisit dans la liste, se saisit par identifiant ou se colle sous forme d’URL Google Agenda portant cid ou src.
• Essais. Lire des disponibilités ne change rien : en essai, le nœud interroge réellement Google Agenda et rend de vrais créneaux libres.
• Erreurs. credential.capability_missing : Google Agenda n’est pas connecté pour le membre qui exécute le workflow. google.bad_locator : « À partir de » ou « Jusqu’à » n’est pas une date lisible, ou « Jusqu’à » n’est pas postérieur. google.not_found : l’agenda n’existe pas ou le compte ne le voit pas. Un « À partir de » ou un « Jusqu’à » vide échoue avec node_invalid_param. google.unavailable est retenté automatiquement. Voir Gestion des erreurs.