MyNotary — événement

Démarre le workflow quand MyNotary signale un événement : une signature terminée, un dossier créé, une notification recommandée. Le corps arrive dans data.mynotary.

Le déclencheur MyNotary — événement démarre le workflow quand MyNotary signale un événement sur l’URL du workflow : une signature terminée, un dossier créé, des recommandés envoyés. L’événement qui compte le plus est signature_completed (« Signature terminée ») : c’est le moment où MyNotary livre les documents signés.

L’URL est celle du workflow, la même que pour Webhook reçu : <PUBLIC_BASE_URL>/hooks/wf/<jeton>. Elle est délivrée à la première publication du workflow et rendue une seule fois ; POST /api/v1/workflows/<id>/webhook en délivre une nouvelle (la précédente cesse de fonctionner). L’abonnement côté MyNotary se crée par l’API, avec la ressource « Webhook » du nœud MyNotary (opération « Créer un webhook », champ « URL de réception ») : aucun écran MyNotary à ouvrir. Le même nœud liste et supprime les abonnements.

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.mynotary · 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 : MyNotary
• Sorties : main

Connexion

Ce nœud exige une connexion MyNotary.

Paramètres

connection

Connexion MyNotary — La connexion MyNotary à 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 MyNotary envoie, c’est-à-dire les événements de tous vos cabinets.

• Type : Plusieurs choix (multiOptions)
• Requis : Non
• Défaut : ["signature_completed"]
• Options :
  • signature_completed — Signature terminée
  • signature_created — Signature lancée
  • signature_cancel — Signature annulée
  • contract_created — Contrat créé
  • contract_deleted — Contrat supprimé
  • operation_created — Dossier créé
  • operation_deleted — Dossier supprimé
  • operation_merged — Dossiers fusionnés
  • legal_record_deleted — Fiche supprimée
  • register_letter_created — Recommandés envoyés
  • register_letter_cancel — Recommandés annulés
  • register_letter_completed — Recommandés terminés

organization

Cabinet concerné — Indicatif : MyNotary envoie les événements de tous vos cabinets sur la même URL. Pour ne traiter qu’un cabinet, comparez data.mynotary.organizationId dans une condition.

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

Sorties

• main — Emprunté par chaque exécution lancée par un événement MyNotary 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.mynotary }} — object. Le corps JSON de l’événement, tel que MyNotary l’a envoyé.
• {{ data.mynotary.eventId }} — string. Le type d’événement, par exemple signature_completed. Malgré son nom, ce n’est pas un identifiant de livraison.
• {{ data.mynotary.organizationId }} — number. Le cabinet auquel appartient l’événement. Comparez-le dans une Condition pour ne traiter qu’un cabinet.
• {{ data.mynotary.contractId }} — number or string. Le contrat concerné, pour les événements de contrat et de signature. Passez-le au nœud MyNotary pour lire le contrat.
• {{ data.mynotary.files.0.signedFileId }} — string. Sur signature_completed : identifiant du premier fichier signé, à télécharger avec le nœud MyNotary.

Example

Classer chaque mandat signé. Ajoutez un déclencheur MyNotary — événement dont events vaut « Signature terminée » (la valeur par défaut). Publiez, puis créez l’abonnement une fois avec un nœud MyNotary : ressource « Webhook », opération « Créer un webhook », « URL de réception » égale à l’URL du workflow.

Quand une signature se termine, une exécution démarre sur le port main. Un nœud MyNotary en aval lit le contrat avec {{ data.mynotary.contractId }} et télécharge {{ data.mynotary.files.0.signedFileId }}.

Tips

• MyNotary envoie tout. Chaque événement de chaque cabinet rattaché à la clé d’API arrive sur la même URL. Le déclencheur ne garde que les événements cochés et écarte les autres avant qu’une exécution n’existe ; rien de coché signifie tous les événements. « Cabinet concerné » est purement indicatif : pour ne traiter qu’un cabinet, comparez {{ data.mynotary.organizationId }} dans une Condition.
• Preuve d’origine. MyNotary ne signe pas ses corps : le jeton de l’URL est la seule preuve. Gardez l’URL secrète.
• Pas de déduplication. MyNotary n’envoie aucun identifiant de livraison : une livraison envoyée deux fois lance deux exécutions. Un workflow qui écrit ailleurs doit s’en protéger (une table des contrats traités, une condition sur un statut).
• Événements manqués. Si une livraison a pu se perdre, un workflow sur Planification qui interroge MyNotary avec le nœud MyNotary rattrape ce que le webhook a manqué.
• Réponses. 202 avec { "executionId" } quand une exécution est créée, 202 sans corps quand l’événement n’est pas l’un de ceux que vous avez cochés, 404 quand le jeton est inconnu ou que le workflow n’est pas publié. 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.
• Un workflow porte au plus un déclencheur MyNotary — événement, et seule la version publiée reçoit les événements.