Mankomail

Entrée Notion modifiée ​

Démarre le workflow quand une entrée d’une base Notion est créée ou modifiée, en vérifiant à intervalle régulier. L’entrée arrive dans data.notion, sans mail déclencheur. Aucune souscription à créer dans Notion.

Le déclencheur Entrée Notion modifiée vérifie une base Notion à intervalle régulier et lance une exécution pour chaque entrée créée ou modifiée depuis la vérification précédente. Rien n’est à configurer dans Notion en dehors du partage de la base avec la connexion : aucune souscription webhook. L’entrée arrive sous data.notion, sous la même forme que l’opération « Entrées créées ou modifiées depuis… » du nœud Notion.

Préférez Notion — événement si vous pouvez créer une souscription webhook dans Notion : il réagit en quelques secondes au lieu d’attendre la vérification suivante.

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, et l’éditeur les signale par une erreur bloquante. Envoyer reste utilisable si vous choisissez la boîte d’envoi sur le nœud.

En bref ​

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

Connexion ​

Ce nœud exige une connexion Notion.

Paramètres ​

connection ​

Connexion Notion — La connexion Notion à 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)

database ​

Base de données — Celle que vous voyez dans Notion. Vous pouvez aussi coller son URL.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (notion.database)
  • Listé avec la connexion de : connection

dataSource ​

Source de données — Le schéma appartient à la source, pas à la base. La plupart des bases n’en ont qu’une.

  • Type : Ressource distante (resourceLocator)
  • Requis : Oui
  • Façons de choisir : dans une liste, saisir un identifiant (notion.dataSource)
  • Listé à l’intérieur de : database
  • Listé avec la connexion de : connection

changeType ​

Déclencher sur

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : any
  • Options :
    • any — Une entrée créée ou modifiée
    • created — Une entrée nouvelle : Les créations seulement, d’après la date de création de la page.
    • edited — Une entrée modifiée seulement : Écarte ce qui vient d’être créé : une création ne compte pas deux fois.

everyMinutes ​

Vérifier toutes les (minutes) — Chaque vérification consomme une requête. Notion n’a pas de quota mensuel, mais l’intégration est partagée par tous les workflows de l’espace.

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

Sorties ​

  • main — Emprunté une fois par entrée nouvelle ou modifiée trouvée lors d’une vérification : chaque entrée lance sa propre exécution.

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.notion.pageId }} — string. Identifiant de l’entrée (la page Notion). data.notion.id porte la même valeur.
  • {{ data.notion.title }} — string. Le titre de l’entrée, en texte brut.
  • {{ data.notion.properties }} — object. Les propriétés de l’entrée en valeurs simples, indexées par nom de propriété : texte, nombre, true/false, nom d’option ; les listes deviennent un texte séparé par des virgules ; une plage de dates s’écrit début..fin. {{ data.notion.properties.Statut }} lit la propriété Statut.
  • {{ data.notion.url }} — string. Lien vers l’entrée dans Notion.
  • {{ data.notion.changedAt }} — string. L’instant qui a fait compter l’entrée : son heure de création quand le déclencheur ne surveille que les nouvelles entrées, sa dernière modification sinon. ISO 8601.
  • {{ data.notion.createdTime }} — string. Heure de création de l’entrée, ISO 8601. data.notion.lastEditedTime porte sa dernière modification.
  • {{ data.notion.inTrash }} — boolean. true quand l’entrée est dans la corbeille.
  • {{ data.notion.dataSourceId }} — string. Identifiant de la source de données vérifiée.

Example ​

Une équipe consigne les demandes entrantes dans une base Notion avec une propriété Statut et une propriété Email. Pour envoyer un accusé de réception à chaque ajout, réglez :

database       Demandes
dataSource     Demandes
changeType     created
everyMinutes   15

Toutes les 15 minutes, chaque nouvelle entrée lance une exécution sur le port main. Un nœud Envoyer écrit à {{ data.notion.properties.Email }} avec l’objet Demande reçue : {{ data.notion.title }} et un lien vers {{ data.notion.url }}.

Tips ​

  • Ce qui compte. « Une entrée créée ou modifiée » suit l’heure de dernière modification. « Une entrée nouvelle » suit l’heure de création. « Une entrée modifiée seulement » écarte les entrées jamais modifiées depuis leur création : une création ne compte pas deux fois.
  • Position de départ. À la publication, le déclencheur part « de maintenant » : les entrées existantes ne sont pas rejouées. Republier conserve la position déjà atteinte, et une entrée modifiée pendant une vérification n’est pas sautée.
  • Rythme. Entre 5 et 1 440 minutes, 15 par défaut. L’instance peut imposer un plancher plus élevé (INTEGRATION_POLL_MIN_MINUTES, voir les variables d’environnement). Chaque vérification coûte une requête ; Notion n’a pas de quota mensuel, mais la limite de débit de l’intégration est partagée par tous les workflows qui l’utilisent.
  • Volume. Une vérification ramène au plus 100 entrées ; le reste attend la vérification suivante et n’est pas perdu.
  • Pas de doublon. Une exécution est identifiée par l’entrée et l’instant qui l’a fait compter : vérifier deux fois la même modification ne lance jamais une seconde exécution. Une entrée modifiée à nouveau plus tard en lance une nouvelle.
  • Boucles. Un workflow qui modifie la base qu’il surveille se redéclenche. Notion n’indique pas ici qui a modifié une entrée : posez une propriété depuis le workflow (« Traité le », un statut) et arrêtez la branche par une Condition quand elle est déjà remplie.
  • Noms de propriétés. Les chemins {{ }} n’acceptent que des noms faits de lettres non accentuées, de chiffres, de _ et de $, sans chiffre en tête. Une propriété nommée Date limite ou Échéance ne peut pas être lue par {{ data.notion.properties.… }} ; donnez de tels noms aux propriétés dont vous avez besoin.
  • Partage. La connexion ne voit que les bases partagées avec elle dans Notion (menu « ··· », « Connections »). Une base non partagée ne peut pas être vérifiée.
  • Erreurs. Une erreur temporaire laisse la position inchangée et la vérification suivante réessaie. Une erreur définitive (connexion révoquée, base non partagée ou supprimée, source de données manquante) vous envoie une notification, une seule par panne.
  • Pause. Un workflow en pause garde son armement mais cesse de vérifier ; le reprendre ne demande pas de republier.
  • Tester. Tester depuis ce déclencheur dans l’éditeur interroge réellement Notion et exécute le brouillon, en essai, sur l’entrée modifiée le plus récemment. L’essai ne déplace jamais la position (voir Essais).