Mankomail

Ligne Airtable modifiée ​

Démarre le workflow quand une ligne d’une table Airtable est créée ou modifiée. Ce qui a changé arrive dans data.airtable, sans mail déclencheur.

Le déclencheur Ligne Airtable modifiée vérifie une table Airtable à intervalle régulier et lance une exécution pour chaque ligne créée ou modifiée depuis la vérification précédente. Utilisez-le pour réagir à une échéance qui bouge, un statut qui change ou une nouvelle entrée dans une table de suivi. Rien n’est à configurer côté Airtable en dehors d’un champ de date : aucun webhook, un accès en lecture suffit.

Il exige un champ « Date de dernière modification » (ou « Date de création » si vous ne surveillez que les nouvelles lignes) dans la table : c’est lui qui dit ce qui a bougé. Si la table n’en a pas, créez-le dans Airtable ; aucune API ne peut le remplacer.

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 écrire dans Airtable en retour, utilisez le nœud Airtable.

En bref ​

  • Type : trigger.airtable · 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 : Airtable
  • Sorties : main

Connexion ​

Ce nœud exige une connexion Airtable.

Paramètres ​

connection ​

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

base ​

Base

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

table ​

Table

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

event ​

Déclencher sur

  • Type : Un choix (options)
  • Requis : Oui
  • Défaut : modified
  • Options :
    • modified — Une ligne modifiée : Toute modification, création comprise. Exige un champ « Date de dernière modification ».
    • created — Une ligne nouvelle : Les créations seulement. Exige un champ « Date de création ».

triggerField ​

Champ de date — Le champ « Date de dernière modification » (ou « Date de création ») de la table — c’est lui qui dit ce qui a bougé. À créer dans Airtable s’il n’existe pas : aucune API ne peut le remplacer.

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

view ​

Vue — Facultative : ne surveiller que les lignes visibles dans cette vue — « les dossiers ouverts », « les relances à faire ».

  • Type : Ressource distante (resourceLocator)
  • Requis : Non
  • Façons de choisir : dans une liste, saisir un identifiant, coller une URL (airtable.view)
  • Listé à l’intérieur de : table
  • Listé avec la connexion de : connection

formula ​

Filtre supplémentaire — Une formule Airtable, combinée en et avec la date : {Statut} = "Clôturé". Laissez vide pour surveiller toute la table.

  • Type : Texte long (text)
  • Requis : Non
  • Défaut : "" (vide)
  • 4000 caractères au plus
  • Exemple : {Statut} = "Clôturé"
  • Expressions : {{ }} refusé

everyMinutes ​

Vérifier toutes les (minutes) — Chaque vérification consomme un appel d’API. ⚠️ Le plan gratuit d’Airtable est plafonné à 1 000 appels par mois : quinze minutes sont un compromis prudent.

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

Sorties ​

  • main — Emprunté une fois par ligne nouvelle ou modifiée trouvée lors d’une vérification : chaque ligne 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.airtable.recordId }} — string. Identifiant de la ligne (rec…).
  • {{ data.airtable.fields }} — object. Les champs de la ligne tels qu’Airtable les rend, indexés par nom de champ. {{ data.airtable.fields.Statut }} lit le champ Statut.
  • {{ data.airtable.changedAt }} — string. Valeur, pour cette ligne, du champ de date choisi sur le nœud : l’heure de sa dernière modification (ou de sa création).
  • {{ data.airtable.baseId }} — string. Identifiant de la base, tel que choisi sur le nœud.
  • {{ data.airtable.tableId }} — string. Identifiant de la table, tel que choisi sur le nœud.

Example ​

Un cabinet suit ses dossiers dans une table Airtable avec un champ Statut et un champ « Date de dernière modification » nommé Modifie. Pour écrire au client quand un dossier est clôturé, réglez :

event          modified
triggerField   Modifie
formula        {Statut} = "Clôturé"
everyMinutes   15

Toutes les 15 minutes, chaque ligne modifiée dont le statut vaut « Clôturé » lance une exécution sur le port main. Un nœud Envoyer peut écrire à {{ data.airtable.fields.Email }} et citer {{ data.airtable.recordId }}.

Tips ​

  • Position de départ. À la publication, le déclencheur part « de maintenant » : les lignes existantes ne sont pas rejouées. Republier conserve la position déjà atteinte.
  • 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) ; le nœud ne peut que ralentir les vérifications. Chaque vérification est un appel à l’API Airtable et compte dans votre forfait Airtable.
  • Volume. Une vérification ramène au plus 100 lignes. Le reste attend la vérification suivante et n’est pas perdu.
  • Pas de doublon. Une exécution est identifiée par la ligne et son heure de modification : vérifier deux fois la même modification ne lance jamais une seconde exécution. Une ligne modifiée à nouveau plus tard en lance une nouvelle.
  • Filtres. La vue et la formule sont facultatives et se combinent à la date par un ET : seules les lignes visibles dans la vue et satisfaisant la formule comptent.
  • Erreurs. Une erreur temporaire (limite de débit, Airtable indisponible, réseau) laisse la position inchangée et la vérification suivante réessaie. Une erreur définitive (connexion révoquée, table supprimée, réglages incomplets) vous envoie une notification, une seule par panne.
  • Noms de champs. Les chemins {{ }} n’acceptent que des noms faits de lettres non accentuées, de chiffres, de _ et de $, sans chiffre en tête. Un champ nommé Date limite ou Échéance ne peut pas être lu par {{ data.airtable.fields.… }} ; donnez de tels noms aux champs dont vous avez besoin.
  • Les suppressions ne sont pas détectées, et l’ancienne valeur d’une cellule n’est pas disponible.
  • 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 Airtable et exécute le brouillon, en essai, sur la ligne la plus récente trouvée. L’essai ne déplace jamais la position : ce qu’il montre sera quand même traité par les vraies vérifications (voir Essais).