Mankomail

Agenda — créer un événement ​

Pose un rendez-vous dans Google Agenda. Une nouvelle tentative de l’étape ne crée pas de doublon : l’identifiant est dérivé de l’étape.

Ce nœud crée un événement dans un agenda Google : un rendez-vous confirmé par mail, une échéance extraite d’un document, un créneau de rappel. Il peut inviter des participants et, par défaut, ne leur écrit pas.

Il exige l’accès Google Agenda d’un compte Google, affiché comme la capacité Agenda dans Connexions. Voir Google. L’événement est créé avec le compte du membre qui exécute le workflow.

Pour proposer des créneaux libres avant d’en réserver un, utilisez Agenda — trouver des créneaux. Pour un agenda Outlook, utilisez Créer un événement Outlook.

En bref ​

  • Type : google_calendar.create_event · version 1
  • Catégorie : Actions
  • Nature : Étape — s’exécute pendant une exécution
  • Effet : Écrit à l’extérieur (external_write) — écrit hors de Mankomail ; décrit au lieu d’être fait pendant un essai
  • 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

title ​

Titre

  • Type : Texte (string)
  • Requis : Oui
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Exemple : Point projet — {{ email.from.name }}
  • Expressions : {{ }} accepté

allDay ​

Journée entière — Activé, « Début » et « Fin » sont des dates (2026-04-12) et la fin est exclusive, comme chez Google.

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

start ​

Début — Instant ISO 8601 (2026-04-12T14:00:00), ou une date seule en journée entière. Accepte des expressions {{ }} : {{ data.extract_1.date }}.

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

end ​

Fin

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

timeZone ​

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

  • Type : Texte (string)
  • Requis : Non
  • Défaut : Europe/Paris
  • 100 caractères au plus
  • Affiché quand : allDay ne vaut pas true
  • Expressions : {{ }} accepté

location ​

Lieu

  • Type : Texte (string)
  • Requis : Non
  • Défaut : "" (vide)
  • 500 caractères au plus
  • Exemple : Visioconférence
  • Expressions : {{ }} accepté

description ​

Description

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 10000 caractères au plus
  • Expressions : {{ }} accepté

attendees ​

Invités — Une adresse par ligne. Accepte des expressions {{ }} : {{ email.from.email }}.

  • Type : Liste d’éléments (collection)
  • Requis : Non
  • Défaut : []
  • Au plus 30 éléments
  • Chaque élément a :
    • email — Adresse
      • Type : Texte (string)
      • Requis : Non
      • Défaut : "" (vide)
      • 320 caractères au plus

sendUpdates ​

Prévenir les invités

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : none
  • Options :
    • none — Non : L’événement apparaît dans leur agenda sans mail d’invitation.
    • all — Oui, envoyer les invitations : Google envoie le mail d’invitation à chaque invité.
  • Affiché quand : attendees compte au moins 1

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>.event }} — object { id, htmlLink?, start, end }. L’événement créé, ou retrouvé lors d’une nouvelle tentative. id est l’identifiant de l’événement Google Agenda, htmlLink le lien qui l’ouvre dans Google Agenda, start et end les bornes telles que Google les a enregistrées (une date pour une journée entière).
  • {{ data.<step>.event.htmlLink }} — string. Le lien Google Agenda de l’événement, à citer dans une réponse. Absent en essai.
  • {{ data.<step>.created }} — boolean. true quand l’événement a été créé par cette tentative, false quand une nouvelle tentative a retrouvé l’événement créé par une tentative précédente de la même étape.
  • {{ data.<step>.simulated }} — boolean. true en essai : rien n’a été créé, l’identifiant commence par simulated- et start/end reprennent les valeurs saisies.
  • {{ data.<step>.summary }} — string. Une phrase lisible qui donne le titre de l’événement, son début et le nombre d’invités.

Exemple ​

Un client confirme un rendez-vous par mail ; une étape Extraire nommée Extraire lit la date et l’heure convenues. Le nœud s’appelle Poser le rendez-vous :

calendar: (mode identifiant) primary
title: Point projet — {{ email.from.name }}
allDay: false
start: {{ data.extraire.debut }}
end: {{ data.extraire.fin }}
timeZone: Europe/Paris
location: Visioconférence
attendees:
  - email: {{ email.from.email }}
sendUpdates: none

Avec start résolu en 2026-04-14T14:00:00 et end en 2026-04-14T15:00:00, les données de l’étape sont :

json
{
  "event": {
    "id": "k3v9q0m1…",
    "htmlLink": "https://www.google.com/calendar/event?eid=…",
    "start": "2026-04-14T14:00:00+02:00",
    "end": "2026-04-14T15:00:00+02:00"
  },
  "created": true,
  "simulated": false
}

Le client figure sur l’événement mais ne reçoit aucun mail d’invitation, car « Prévenir les invités » est sur « Non ».

Conseils ​

  • Pas de doublon à la nouvelle tentative. L’identifiant de l’événement est dérivé de l’étape. Si l’étape est retentée après un incident, Google répond que cet identifiant existe déjà, et le nœud rend l’événement existant avec created: false au lieu d’en créer un second. Deux exécutions différentes (deux mails) créent bien deux événements.
  • Invitations. « Prévenir les invités » apparaît dès qu’il y a au moins un invité et vaut « Non » par défaut : l’événement apparaît dans l’agenda des invités sans mail d’invitation. Choisissez « Oui, envoyer les invitations » pour que Google écrive à chaque invité.
  • Dates et heures. Sans « Journée entière », « Début » et « Fin » sont des dates-heures ISO 8601 (2026-04-14T14:00:00) lues dans le « Fuseau horaire » (nom IANA, Europe/Paris par défaut). Avec « Journée entière », ce sont des dates (2026-04-14) et la fin est exclusive, comme Google l’attend : un événement d’un jour le 14 avril se termine le 2026-04-15. Le champ « Fuseau horaire » est masqué pour une journée entière.
  • Agenda. Laissé tel quel, l’agenda principal du compte (primary). La liste ne propose que les agendas où le compte peut écrire. Vous pouvez aussi saisir un identifiant d’agenda ou coller une URL Google Agenda qui porte l’agenda dans son paramètre cid ou src.
  • Invités. Jusqu’à 30 adresses, une par ligne ; les doublons sont écartés. Une entrée qui n’est pas une adresse mail (par exemple une expression non résolue) fait échouer l’étape avec node_invalid_param plutôt que de n’inviter personne en silence. Un « Titre », un « Début » ou une « Fin » résolus à vide échouent aussi avec node_invalid_param.
  • Essais. En essai, rien n’est créé et personne n’est prévenu : l’étape rend un identifiant qui commence par simulated-, sans htmlLink, et start/end tels que saisis.
  • Erreurs. credential.capability_missing : Google Agenda n’est pas connecté pour le membre qui exécute le workflow. google.insufficient_permissions ou google.auth_failed : reconnectez le compte. google.not_found : l’agenda n’existe pas ou le compte ne le voit pas. google.rejected : Google a refusé l’événement (par exemple une date illisible). google.bad_locator : la valeur d’agenda collée est illisible. google.unavailable est retenté automatiquement. Voir Gestion des erreurs.