Automatiser Transept avec des déclencheurs par webhook

Ouvrez un flux de travail enregistré dans le constructeur et regardez la carte de déclenchement en haut — celle qui indique Vous l'exécutez manuellement. C'est un commutateur. Manuel est l'option par défaut : vous appuyez vous-même sur Exécuter. Webhook fournit au flux de travail une URL privée vers laquelle un système externe envoie une requête POST, permettant ainsi à l'exécution de démarrer automatiquement. Un déclencheur est associé à un flux de travail enregistré. Enregistrez donc d'abord votre flux — l'option Webhook reste désactivée sur un brouillon non enregistré.

Passez la carte sur Webhook, définissez sur quoi porte le déclenchement (ci-dessous), puis enregistrez. Transept génère une URL secrète pour ce Workflow spécifique et ne l'affiche qu'une seule fois — copiez-la à ce moment-là, car seule une empreinte (hash) est stockée et l'URL complète ne pourra plus jamais être affichée. Le secret réside dans l'URL plutôt que dans un en-tête, car les expéditeurs les plus simples ne peuvent pas configurer d'en-têtes ; traitez donc l'URL comme un mot de passe — quiconque la possède peut lancer l'exécution.

Rouvrez la carte plus tard et vous verrez un préfixe masqué (whk_live_…) à la place de l'URL complète, ainsi qu'une action Renouveler. Le renouvellement génère une nouvelle URL et invalide l'ancienne dès que vous confirmez, ce qui permet de révoquer un lien qui a fuité. Vous pouvez également désactiver le déclencheur sans le supprimer, ou le supprimer purement et simplement. La carte indique la date de son dernier déclenchement.

Deux paramètres déterminent les éléments affectés par le Workflow lors de l'appel de l'URL :

• Cible — un document fixe que vous désignez (chaque déclenchement cible ce document et son groupe de langues), ou la page Notion indiquée dans la charge utile entrante (Transept l'associe à votre document, en l'important la première fois qu'il la détecte).
• Langues — toutes les versions linguistiques (par défaut ; l'exécution se déploie sur chaque langue de la cible sous forme d'exécution groupée), ou seulement ce document.
• Contenu mis à jour uniquement — activé par défaut, car une exécution automatisée ne doit traiter que ce qui a changé depuis la dernière fois, sans retraduire l'intégralité du document à chaque déclenchement. Voir Exécuter uniquement ce qui a changé.

Une automatisation de base de données Notion peut appeler le déclencheur via son action Envoyer un webhook : dirigez l'action vers l'URL de déclenchement et, à chaque exécution de l'automatisation, Transept lancera le Workflow sur la page concernée. Il y a deux points importants à connaître avant de vous en servir.

Premièrement, les automatisations Notion se déclenchent lors d'un changement de propriété (ou de la création d'une page), et non lors d'une simple modification du corps de la page — modifier le texte d'une page peut donc ne rien déclencher du tout. La méthode la plus fiable consiste à utiliser une propriété de Statut surveillée par l'automatisation : modifiez-la (par exemple, pour la passer sur Prêt pour la traduction) et ce changement servira de signal.

Deuxièmement, un webhook Notion ne transmet que le nom de la page — il ne contient jamais son contenu. Transept lit donc la page via votre connexion Notion, laquelle doit avoir accès à la base de données dans Notion. Ces deux étapes (connecter Notion, puis partager la base de données avec l'intégration) sont détaillées dans la section « Déclencheurs Notion : donner accès à Transept » de la page Automatiser Transept avec l'API. Si vous omettez l'une ou l'autre de ces étapes, chaque déclenchement sera rejeté avec une erreur d'accès.

Tout ce qui peut envoyer une requête HTTP POST peut activer le déclencheur — une étape Zapier ou n8n, une tâche CI ou une commande curl à la fin d'un build. Pour une cible de type document fixe, le corps n'a pas d'importance, un POST vide suffit donc ; seule une cible page Notion lit le corps pour identifier la page modifiée. Aucun en-tête Authorization n'est requis — le secret réside dans l'URL complète.

Par défaut, un déclenchement exécute le Workflow sur toutes les versions linguistiques et — avec l'option « Contenu mis à jour uniquement » activée — ne retraduit que les blocs dont la source a changé depuis la dernière exécution. Ainsi, une modification mineure ne coûte que quelques blocs, et non l'intégralité du document. Les exécutions lancées de cette manière facturent les mots exactement comme l'éditeur intégré, et si le solde est insuffisant pour couvrir l'exécution, rien n'est envoyé et rien n'est facturé.

Une étape configurée pour attendre votre révision reste tout de même en attente : le déclenchement traduit jusqu'à ce point de contrôle puis s'interrompt, et la langue apparaît dans le panneau « Prêt pour révision » de l'éditeur pour que vous puissiez l'approuver — l'automatisation ne saute pas vos étapes de révision. De plus, lorsqu'une cible page Notion ne peut pas être lue (généralement parce que la base de données n'a pas été partagée avec l'intégration), la carte du déclencheur affiche le dernier échec sous forme de note horodatée « impossible de lire la page Notion », afin que vous puissiez voir pourquoi un déclenchement n'a rien donné.