Mankomail

Trouver un créneau Outlook ​

Lit les disponibilités de votre agenda et propose les créneaux libres, dans vos heures ouvrées.

Ce nœud lit les disponibilités Outlook du membre qui exécute le workflow et liste les créneaux libres dans les heures ouvrées. Utilisez-le pour proposer de vrais créneaux dans une réponse rédigée par Rédiger (IA), ou pour réserver directement le premier créneau libre avec Créer un événement Outlook.

Il exige l’accès agenda d’un compte Microsoft, affiché comme la capacité Agenda dans Connexions. Voir Microsoft. Pour Google Agenda, utilisez Agenda — trouver des créneaux.

En bref ​

  • Type : outlook_calendar.find_free · version 1
  • Catégorie : Actions
  • 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 : Microsoft (capacité calendar)
  • Entrées : main
  • Sorties : main

Connexion ​

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

Paramètres ​

credential ​

Compte Microsoft — Le compte dont on utilise l’agenda. Connectez-le depuis Connexions ; le jeton est résolu par le serveur.

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

from ​

À partir de — Date ISO. Laissé vide : maintenant.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : 2026-04-02T00:00:00
  • Expressions : {{ }} accepté

to ​

Jusqu’à — Date ISO. Laissé vide : sept jours après le début.

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 64 caractères au plus
  • Exemple : 2026-04-09T00:00:00
  • Expressions : {{ }} accepté

slotMinutes ​

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

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

workStartHour ​

Début des heures ouvrées — Heure locale du fuseau ci-dessous.

  • Type : Nombre (number)
  • Requis : Non
  • Défaut : 9
  • Nombre entier, de 0 à 23

workEndHour ​

Fin des heures ouvrées

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

includeWeekend ​

Inclure le week-end

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

timeZone ​

Fuseau horaire — Nom IANA (Europe/Paris, America/Montreal). C’est lui qui donne son sens aux heures saisies.

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

maxSlots ​

Nombre de créneaux proposés

  • 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, dans l’ordre chronologique. start et end sont des dates-heures locales dans le « Fuseau horaire » du nœud, sans suffixe de fuseau (2026-04-14T10:00:00) : le format qu’attend « Créer un événement Outlook ».
  • {{ data.<step>.first }} — object { start, end }. Le premier créneau libre, identique à slots.0. Absent quand aucun créneau n’a été trouvé.
  • {{ data.<step>.first.start }} — string. Le début du premier créneau libre, à brancher dans « Créer un événement Outlook » ou à citer dans une réponse.
  • {{ data.<step>.count }} — number. Le nombre de créneaux rendus. 0 quand rien n’est libre dans la fenêtre.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui donne le nombre de créneaux et le premier d’entre eux.

Exemple ​

Un client demande un appel « la semaine prochaine ». Le nœud s’appelle Créneaux :

from: 2026-04-13T00:00:00
to: 2026-04-18T00:00:00
slotMinutes: 30
workStartHour: 9
workEndHour: 18
includeWeekend: false
timeZone: Europe/Paris
maxSlots: 3

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

json
{
  "slots": [
    { "start": "2026-04-13T10:00:00", "end": "2026-04-13T10:30:00" },
    { "start": "2026-04-13T10:30:00", "end": "2026-04-13T11:00:00" },
    { "start": "2026-04-13T11:00:00", "end": "2026-04-13T11:30:00" }
  ],
  "first": { "start": "2026-04-13T10:00:00", "end": "2026-04-13T10:30:00" },
  "count": 3
}

Les heures sont celles de Paris. Une étape Créer un événement Outlook dans le même fuseau peut prendre {{ data.creneaux.first.start }} et {{ data.creneaux.first.end }} tels quels.

Conseils ​

  • Fenêtre. « À partir de » et « Jusqu’à » sont des dates ISO. Sans suffixe de fuseau, elles sont lues dans le « Fuseau horaire » ; avec un suffixe (Z, +02:00), elles sont prises telles quelles. « À partir de » laissé vide vaut maintenant, et un « À partir de » passé est ramené à maintenant : un créneau déjà commencé n’est jamais proposé. « Jusqu’à » laissé vide vaut sept jours après le début. La fenêtre est plafonnée à 62 jours.
  • Heures et jours ouvrés. « Début des heures ouvrées » et « Fin des heures ouvrées » sont des heures locales entières (9 et 18 par défaut) ; un créneau n’est proposé que s’il commence et se termine dans cette plage. La fin doit être après le début, sinon l’étape échoue avec node_invalid_param. Du lundi au vendredi seulement, sauf si « Inclure le week-end » est activé.
  • Ce qui compte comme libre. Seul le temps marqué libre dans Outlook. Le temps provisoire, occupé, absent ou hors du bureau est considéré comme pris.
  • Découpage. Les créneaux durent « Durée d’un créneau » (5 à 480 minutes, 30 par défaut) et sont alignés sur des multiples de cette durée comptés en UTC : avec 30 minutes, ils commencent à l’heure pile ou à la demie. « Nombre de créneaux proposés » est compris entre 1 et 50, 10 par défaut.
  • Agenda. Les disponibilités sont lues dans le planning libre/occupé de la boîte du compte connecté, c’est-à-dire son agenda par défaut : Outlook ne calcule pas de disponibilité pour un agenda secondaire, et le nœud ne propose donc pas d’en choisir un.
  • Fuseau horaire. Nom IANA (Europe/Paris par défaut). Un fuseau inconnu échoue avec microsoft.rejected.
  • Essais. Lire des disponibilités ne change rien : en essai, le nœud interroge réellement Outlook et rend de vrais créneaux.
  • Erreurs. credential.capability_missing : l’agenda Outlook n’est pas connecté pour le membre qui exécute le workflow. microsoft.rejected : fuseau inconnu, fenêtre qui se termine avant de commencer, compte sans adresse, ou agenda qu’Outlook n’a pas pu lire. microsoft.access_denied : reconnectez le compte. microsoft.unavailable est retenté automatiquement. Voir Gestion des erreurs.