Notion — événement

Démarre le workflow quand Notion signale un événement : une entrée créée, un statut changé, un commentaire. Le corps arrive dans data.notion. La souscription se crée à la main dans Notion — sinon, préférez « Planification » + « Entrées modifiées depuis… ».

Le déclencheur Notion — événement démarre le workflow quand Notion signale un événement sur l’URL du workflow : une entrée créée, une propriété modifiée, un commentaire ajouté. Il réagit en quelques secondes et ne coûte presque aucune requête, mais il exige une souscription webhook que vous créez à la main dans Notion : Notion n’offre aucune API pour en créer une.

Quand aucune souscription n’existe, utilisez plutôt Entrée Notion modifiée : il vérifie une base à intervalle régulier et ne demande rien côté Notion.

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.

Pour le mettre en place :

1. Ajoutez le déclencheur, choisissez la connexion Notion et les événements, puis publiez. L’URL <PUBLIC_BASE_URL>/hooks/wf/<jeton> est délivrée à la première publication et rendue une seule fois ; POST /api/v1/workflows/<id>/webhook en délivre une nouvelle (la précédente cesse de fonctionner). Notion exige une URL publique en HTTPS.
2. Dans les réglages de votre intégration Notion, créez une souscription webhook pointée sur cette URL.
3. Notion envoie un jeton de vérification une seule fois, à la création de la souscription. Collez-le dans le champ « Jeton de vérification des webhooks » de la connexion Notion : c’est la clé qui vérifie l’en-tête X-Notion-Signature (HMAC-SHA256 du corps brut) de chaque événement.

En bref

• Type : trigger.notion · 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)

events

Événements — Ce qui déclenche ce workflow. Rien de coché = tout ce que Notion envoie, c’est-à-dire les événements de tout l’espace de travail.

• Type : Plusieurs choix (multiOptions)
• Requis : Non
• Défaut : ["page.properties_updated"]
• Options :
  • page.created — Page créée
  • page.properties_updated — Propriétés d’une page modifiées
  • page.content_updated — Contenu d’une page modifié
  • page.moved — Page déplacée
  • page.deleted — Page mise à la corbeille
  • page.undeleted — Page restaurée
  • data_source.content_updated — Entrées d’une base modifiées
  • data_source.schema_updated — Schéma d’une base modifié
  • comment.created — Commentaire ajouté
  • comment.updated — Commentaire modifié
  • comment.deleted — Commentaire supprimé

database

Base concernée — Indicatif : Notion envoie les événements de tout l’espace sur la même URL. Pour n’en traiter qu’une, comparez data.notion.entity.id ou relisez la page dans une condition.

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

Sorties

• main — Emprunté par chaque exécution lancée par un événement Notion 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.notion }} — object. Le corps JSON de l’événement, tel que Notion l’a envoyé. Il porte des identifiants et des métadonnées, jamais le contenu de la page.
• {{ data.notion.type }} — string. L’événement, par exemple page.properties_updated.
• {{ data.notion.id }} — string. L’identifiant de l’événement. Une relivraison porte la même valeur et ne lance pas de seconde exécution.
• {{ data.notion.entity.id }} — string. L’objet concerné (page, base, commentaire). Passez-le au nœud Notion pour lire la page.
• {{ data.notion.workspace_id }} — string. L’espace de travail d’où vient l’événement.
• {{ data.notion.authors }} — array. Qui a fait la modification. {{ data.notion.authors.0.id }} lit le premier auteur : comparez-le au bot de la connexion pour éviter les boucles.

Example

Prévenir le chargé de compte quand un dossier change de statut. Le déclencheur garde events sur « Propriétés d’une page modifiées » (la valeur par défaut). À chaque modification, une exécution démarre sur le port main. Un nœud Notion lit la page {{ data.notion.entity.id }} (ressource « Page », opération « Lire une page »), puis une Condition vérifie le statut avant qu’un nœud Envoyer écrive le mail.

Pour éviter les boucles, lisez d’abord le bot de la connexion avec le nœud Notion (ressource « Utilisateur », opération « Lire le compte de la connexion », qui rend botId), et ajoutez une Condition qui arrête la branche quand {{ data.notion.authors.0.id }} est égal à ce botId.

Tips

• Sans jeton de vérification, rien ne passe. Si le « Jeton de vérification des webhooks » de la connexion est vide ou faux, chaque livraison est refusée en 404 et aucune exécution n’est créée. La raison n’est écrite que dans les journaux du serveur.
• Notion envoie tout l’espace. Chaque événement de l’espace de travail arrive sur la même URL. Seuls les événements cochés lancent une exécution ; rien de coché signifie tous les événements. « Base concernée » est purement indicatif : pour ne traiter qu’une base, comparez {{ data.notion.entity.id }} ou relisez la page dans une Condition.
• Boucles. Un workflow qui écrit dans Notion produit de nouveaux événements, qui relancent le workflow. Le garde-fou décrit dans l’exemple n’est pas facultatif.
• Charge utile légère. Le corps ne contient pas la page : la lire coûte une requête de plus avec le nœud Notion. Prévoyez-la dans votre budget de requêtes.
• Relivraisons. Notion retente les livraisons échouées ; elles portent le même id d’événement et ne lancent pas de seconde exécution.
• Réponses. 202 avec { "executionId" } quand une exécution est créée ; 202 sans corps pour un événement que vous n’avez pas coché ou une livraison déjà traitée ; 404 pour un jeton inconnu, un workflow non publié ou une signature invalide, toujours la même réponse. Les autres règles de l’URL (POST seulement, corps JSON jusqu’à 256 Ko, 300 appels par minute et par IP) sont celles de Webhook reçu.
• Contenu non fiable. Un titre de page ou un commentaire écrit par un tiers est une donnée, jamais une instruction pour un nœud IA.
• Un workflow porte au plus un déclencheur Notion — événement, et seule la version publiée reçoit les événements.