Transept mit Webhook-Triggern automatisieren

Öffnen Sie einen gespeicherten Workflow im Builder und sehen Sie sich die Trigger-Karte oben an – diejenige mit der Aufschrift Sie führen ihn manuell aus. Es handelt sich um einen Schalter. Manuell ist die Standardeinstellung: Sie klicken selbst auf „Ausführen“. Webhook weist dem Workflow eine private URL zu, an die ein externes System POST-Anfragen sendet, sodass der Durchlauf automatisch startet. Ein Trigger gehört zu einem gespeicherten Workflow. Speichern Sie den Workflow also zuerst – bei einem ungespeicherten Entwurf bleibt die Webhook-Option deaktiviert.

Stellen Sie die Karte auf Webhook um, legen Sie fest, worauf sich die Ausführung bezieht (unten), und speichern Sie. Transept generiert eine geheime URL für diesen einen Workflow und zeigt sie einmalig an – kopieren Sie sie direkt, da nur ein Hash gespeichert wird und die vollständige URL nie wieder angezeigt werden kann. Das Geheimnis befindet sich in der URL und nicht in einem Header, da einfachste Absender keine Header setzen können; behandeln Sie die URL daher wie ein Passwort – jeder, der sie besitzt, kann die Ausführung starten.

Wenn Sie die Karte später erneut öffnen, sehen Sie anstelle der vollständigen URL ein maskiertes Präfix (whk_live_…) sowie die Aktion Rotieren. Das Rotieren generiert eine neue URL und macht die alte sofort nach Ihrer Bestätigung ungültig – so können Sie einen Link ersetzen, der bekannt geworden ist. Sie können den Trigger auch ausschalten, ohne ihn zu löschen, oder ihn ganz entfernen. Die Karte zeigt an, wann er zuletzt ausgelöst wurde.

Zwei Einstellungen legen fest, was der Workflow verarbeitet, wenn die URL aufgerufen wird:

• Ziel – ein von Ihnen benanntes festes Dokument (jede Auslösung bezieht sich auf dieses Dokument und seine Sprachgruppe) oder die im eingehenden Payload genannte Notion-Seite (Transept ordnet diese Ihrem Dokument zu und importiert die Seite, sobald sie das erste Mal erkannt wird).
• Sprachen – alle Sprachversionen (Standard; der Durchlauf verteilt sich als Gruppen-Durchlauf auf alle Sprachen des Ziels) oder nur das eine Dokument.
• Nur aktualisierte Inhalte – standardmäßig aktiviert, da ein automatisierter Durchlauf nur das verarbeiten sollte, was sich seit dem letzten Mal geändert hat, anstatt bei jeder Auslösung das gesamte Dokument neu zu übersetzen. Siehe Nur Geändertes ausführen.

Eine Notion-Datenbank-Automatisierung kann den Trigger über die Aktion Webhook senden aufrufen: Hinterlegen Sie die Trigger-URL in der Aktion. Jedes Mal, wenn die Automatisierung ausgeführt wird, startet Transept den Workflow für die Seite, die die Auslösung verursacht hat. Bevor Sie dies nutzen, sollten Sie zwei Dinge beachten.

Erstens lösen Notion-Automatisierungen bei einer Eigenschaftsänderung (oder einer neuen Seite) aus, nicht allein durch das Bearbeiten des Inhalts – das Ändern des Seitentextes löst also unter Umständen gar nichts aus. Eine verlässliche Methode ist eine Status-Eigenschaft, die von der Automatisierung überwacht wird: Ändern Sie diesen (zum Beispiel auf Bereit für Übersetzung), dient diese Änderung als Signal.

Zweitens nennt ein Notion-Webhook nur die Seite – er überträgt niemals deren Inhalt. Daher liest Transept die Seite über Ihre Notion-Verbindung aus, der zuvor in Notion Zugriff auf die Datenbank gewährt werden muss. Beide Schritte (Notion verbinden und dann die Datenbank für die Integration freigeben) sind im Abschnitt „Notion-Trigger: Transept Zugriff gewähren“ unter Transept mit der API automatisieren beschrieben. Wenn Sie einen dieser Schritte auslassen, wird jede Auslösung mit einem Zugriffsberechtigungsfehler abgelehnt.

Alles, was einen HTTP-POST senden kann, kann den Trigger auslösen – ein Zapier- oder n8n-Schritt, ein CI-Job oder ein curl am Ende eines Builds. Bei einem festen Dokument als Ziel spielt der Body keine Rolle, daher genügt ein leerer POST; nur bei einer Notion-Seite als Ziel wird der Body gelesen, um zu erfahren, welche Seite sich geändert hat. Ein Authorization-Header ist nicht erforderlich – die URL selbst dient als Geheimnis.

Standardmäßig führt eine Auslösung den Workflow für alle Sprachversionen aus. Wenn „Nur aktualisierte Inhalte“ aktiviert ist, werden nur die Blöcke neu übersetzt, deren Quelle sich seit dem letzten Durchlauf geändert hat – so kostet eine kleine Bearbeitung nur eine Handvoll Blöcke statt des gesamten Dokuments. Auf diese Weise gestartete Durchläufe rechnen Wörter genau wie der In-App-Editor ab; reicht das Guthaben für den Durchlauf nicht aus, wird nichts ausgeführt und nichts berechnet.

Ein Schritt, der auf auf Ihre Überprüfung warten eingestellt ist, pausiert weiterhin: Die Auslösung übersetzt bis zu diesem Punkt und hält dann an. Die Sprache erscheint dann im Editor im Panel „Bereit zur Überprüfung“ zur Genehmigung – die Automatisierung überspringt Ihre Prüfschritte nicht. Wenn ein Notion-Seiten-Ziel nicht gelesen werden kann (meistens, weil die Datenbank nicht für die Integration freigegeben wurde), zeigt die Trigger-Karte den letzten Fehler mit Zeitstempel als Hinweis „Notion-Seite konnte nicht gelesen werden“ an, damit Sie sehen können, warum eine Auslösung nichts bewirkt hat.