Transept mit Webhook-Triggern automatisieren

Öffnen Sie einen gespeicherten Workflow im Builder und sehen Sie sich oben die Trigger-Karte an – diejenige mit der Aufschrift You run it manually. Es handelt sich um einen Umschalter. Manual ist die Standardeinstellung: Sie klicken selbst auf „Run“. Webhook weist dem Workflow eine private URL zu, an die ein externes System POST-Anfragen sendet, sodass der Durchlauf von selbst 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 Auslösung bezieht (siehe unten), und speichern Sie. Transept generiert eine geheime URL für diesen spezifischen 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 steckt in der URL und nicht in einem Header, da einfachste Absendersysteme keine Header setzen können; behandeln Sie die URL also wie ein Passwort – jeder, der sie besitzt, kann den Durchlauf starten.

Wenn Sie die Karte später wieder öffnen, sehen Sie anstelle der vollständigen URL ein maskiertes Präfix (whk_live_…) sowie die Aktion Rotate. Das Rotieren generiert eine neue URL und macht die alte sofort nach Ihrer Bestätigung ungültig – so können Sie einen Link unschädlich machen, der versehentlich 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:

• Target – ein von Ihnen benanntes festgelegtes Dokument (jede Auslösung bezieht sich auf dieses Dokument und seine Sprachgruppe) oder die in der eingehenden Payload genannte Notion-Seite (Transept ordnet diese Ihrem Dokument zu und importiert die Seite, sobald sie zum ersten Mal erkannt wird).
• Languages – alle Sprachversionen (Standardeinstellung; der Durchlauf wird als Gruppendurchlauf auf jede Sprache des Ziels ausgeweitet) oder nur das eine Dokument.
• Only updated content – standardmäßig aktiviert, da ein automatisierter Durchlauf nur die Änderungen seit dem letzten Mal verarbeiten sollte, 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: Richten Sie die Aktion auf die Trigger-URL aus, und jedes Mal, wenn die Automatisierung startet, führt Transept den Workflow für die auslösende Seite aus. Bevor Sie sich darauf verlassen, sollten Sie zwei Dinge beachten.

Erstens lösen Notion-Automatisierungen bei einer Eigenschaftsänderung (oder einer neuen Seite) aus, nicht allein durch die Bearbeitung des Inhalts – das Ändern des Seitentextes löst also unter Umständen gar nichts aus. Ein verlässliches Muster ist eine Status-Eigenschaft, die von der Automatisierung überwacht wird: Ändern Sie diese (etwa auf Ready to translate), und diese Änderung dient als Signal.

Zweitens nennt ein Notion-Webhook lediglich die Seite – er überträgt niemals deren Inhalt. Transept liest die Seite daher über Ihre Notion-Verbindung aus, der innerhalb von Notion Zugriff auf die Datenbank gewährt werden muss. Beide Schritte (Notion verbinden und die Datenbank für die Integration freigeben) sind im Abschnitt „Notion-Trigger: Transept Zugriff gewähren“ unter Transept mit der API automatisieren beschrieben. Wird einer der Schritte ausgelassen, wird jede Auslösung mit einem Zugriffsfehler abgewiesen.

Jedes System, das einen HTTP-POST-Request senden kann, kann den Trigger auslösen – sei es ein Zapier- oder n8n-Schritt, ein CI-Job oder ein curl-Befehl am Ende eines Builds. Bei einem festgelegten Dokument als Ziel spielt der Body keine Rolle, sodass ein leerer POST-Request genügt; nur bei einer Notion-Seite als Ziel wird der Body ausgelesen, um zu erfahren, welche Seite sich geändert hat. Ein Authorization-Header ist nicht erforderlich – die gesamte URL ist das Geheimnis.

Standardmäßig führt eine Auslösung den Workflow für alle Sprachversionen aus. Ist dabei „Only updated content“ aktiviert, werden nur die Blöcke neu übersetzt, deren Quelltext sich seit dem letzten Durchlauf geändert hat – so kostet eine kleine Änderung nur eine Handvoll Blöcke statt des gesamten Dokuments. Auf diese Weise gestartete Durchläufe rechnen Wörter exakt wie der In-App-Editor ab. Reicht das Guthaben nicht aus, wird nichts versendet und nichts berechnet.

Ein Schritt, der auf wait for your review eingestellt ist, pausiert weiterhin: Die Auslösung übersetzt bis zu diesem Prüfpunkt und hält dann an, und die Sprache erscheint im Bereich „Bereit zur Überprüfung“ des Editors zur Freigabe – die Automatisierung überspringt also Ihre Prüfschritte nicht. Und wenn ein Notion-Seite-Ziel nicht gelesen werden kann (meist, 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, warum eine Auslösung keine Wirkung hatte.

Ja. Stellen Sie das Ziel des Triggers auf „the request body is the content“ ein. Alles, was Sie per POST an die URL senden, wird zum Dokument: reines Markdown, HTML oder Klartext (senden Sie den passenden Content-Type) oder JSON wie {"content": "…", "content_type": "markdown"}. Legen Sie pro Trigger fest, ob jede Übermittlung ein neues Dokument erstellt oder ein festgelegtes Dokument aktualisiert – bei einer Aktualisierung wird der Inhalt abgeglichen, sodass nur die geänderten Blöcke neu übersetzt werden. Auf diese Weise übertragen E-Mail-Plattformen, Zapier/n8n-Schritte oder Skripte Vorlagen oder Artikel direkt in einen Übersetzungs-Workflow, ganz ohne manuellen Upload. Erneute Zustellversuche werden 24 Stunden lang dedupliziert; für eine präzise Steuerung geben Sie eine external_id im JSON an (Ihre Nachrichten-ID). Body-Größe bis zu 10 MB.