Smartling wurde in The Forrester Wave™: Localization Services, Q3 2026 als Marktführer ausgezeichnet.
Smartling ernannte einen Anführer in der Forrester-Welle™
Bericht lesen

Was ist ein Übersetzungs-Webhook und wie richtet man ihn ein?

Ein Translation Webhook ist ein Abonnement, das Smartling veranlasst, eine HTTP-Anfrage an eine von Ihnen kontrollierte URL zu senden, sobald ein bestimmtes Ereignis in einem Projekt eintritt – beispielsweise der Abschluss eines Übersetzungsauftrags, die Veröffentlichung einer Datei oder die Erstellung eines Problems –, sodass Ihr System in dem Moment davon erfährt, anstatt die API nach einem Zeitplan abzufragen. Webhooks werden pro Projekt über das Smartling Dashboard oder die Webhooks API konfiguriert, und der aufgerufene Endpunkt muss öffentlich erreichbar sein. Dies ist das häufigste Hindernis bei der Einrichtung eines Connectors, der hinter einer Firewall läuft.

Zuletzt überprüft: 4. September 2026

Warum einen Webhook verwenden, anstatt die Übersetzungs-API abzufragen?

  • Umfragen verschwenden Anrufe für nichts. Ein Skript, das alle paar Minuten prüft, ob ein Job erledigt ist, führt zwischen den seltenen Momenten, in denen sich tatsächlich etwas geändert hat, meist leere API-Aufrufe ab.
  • Polling führt systembedingt zu Latenz. Selbst ein Abfrageintervall von fünf Minuten bedeutet, dass eine abgeschlossene Übersetzung bis zu fünf Minuten lang unbearbeitet bleiben kann, bevor etwas davon bemerkt wird – stattdessen wird ein Webhook ausgelöst, sobald das Ereignis eintritt.
  • Rückrufe und Webhooks lösen verschiedene Probleme. Ein Rückruf ist eine einmalige Benachrichtigung, die an eine bestimmte Anfrage gebunden ist – in Smartlings eigener Dokumentation wird es so formuliert, dass man sofort informiert wird, wenn eine bestimmte Aktion, wie die Übersetzung einer einzelnen Datei, abgeschlossen ist – während ein Webhook ein dauerhaftes Abonnement ist, das dich jedes Mal benachrichtigt, wenn eine Kategorie von Ereignissen in einem Projekt auftritt.
  • Eine Firewall unterbricht stillschweigend die Benachrichtigung, nicht die Übersetzung. In der Dokumentation des Smartling Repository Connectors wird ausdrücklich darauf hingewiesen, dass Webhooks einen öffentlich erreichbaren Empfangsendpunkt erfordern – ein Connector, der sich hinter einer Firewall befindet, kann Inhalte zwar erfolgreich übersetzen, aber dennoch niemals die Abschlussbenachrichtigung erhalten.
  • Netzwerk- oder Serviceprobleme können zum Ausfall einer Webhook-Zustellung führen. In der Integrationsdokumentation von Smartling wird selbst darauf hingewiesen, dass ein Callback oder Webhook aufgrund eines Netzwerk- oder Serviceproblems auf einer der beiden Seiten nicht ankommen kann. Deshalb weist eine Pipeline, die ausschließlich auf „Warten auf den Webhook“ basiert und keine Ausweichlösung besitzt, einen realen, wenn auch seltenen Fehlermodus auf.

Was musst du konfigurieren, bevor ein Übersetzungs-Webhook ausgelöst wird?

  • Eine Endpunkt-URL, die Ihr Team kontrolliert – ein öffentlich adressierbarer HTTP-Endpunkt, der Smartlings Anfrage empfangen und bestätigen kann; dies ist das Feld, das direkt in der Webhook-Konfiguration des Smartling-Dashboards oder über die Webhooks-API gesetzt wird.
  • Eine bestimmte Gruppe abonnierter Events – Webhooks – sind auf die Eventtypen zugeschnitten, die du abonniert hast (zum Beispiel Job abgeschlossen oder Datei veröffentlicht), die im Smartling-Eventkatalog aufgeführt sind, anstatt standardmäßig jede mögliche Projektänderung auszulösen.
  • Der richtige Projektumfang – ein Webhook-Abonnement ist an bestimmte Projekte gebunden, daher benötigt ein Multi-Projekt-Konto ein Abonnement, das pro Projekt konfiguriert ist, nicht eine globale Einstellung.
  • Ein sichtbarer Abonnementinhaber – das Dashboard zeigt an, ob ein Webhook über die Benutzeroberfläche konfiguriert oder per API hinzugefügt wurde. Dies ist wichtig, wenn mehrere Systeme oder Teammitglieder Abonnements verwalten.
  • Ein Plan für Zustellungsfehler – da ein Webhook aufgrund eines Netzwerk- oder Serviceproblems nicht ankommen kann, benötigt eine Produktionsintegration entweder eine Wiederholungserwartung von Smartling-Seite oder eine regelmäßige Abgleichprüfung auf der Empfängerseite, nicht ein Design, das davon ausgeht, dass jedes Ereignis immer ankommt.

Callback vs. Webhook: Wie sich die beiden Mechanismen vergleichen

Mechanismus Abzugsmodell Best fit
RückrufEinmalige Benachrichtigung im Zusammenhang mit einer bestimmten Anfrage (z. B. der Übersetzung einer einzelnen Datei)Einfache, Single-Action-Integrationen, die nur eine Benachrichtigung benötigen
WebhookStehendes, pro-Projekt-Abonnement, das jedes Mal ausgelöst wird, wenn ein abonniertes Ereignis wiederkehrt (Job abgeschlossen, Datei veröffentlicht, Problem erstellt usw.).Laufende Pipelines – CI/CD, CMS-Konnektoren – die bei wiederkehrenden Übersetzungsarbeiten kontinuierliche Benachrichtigungen benötigen.
LieferanforderungDer empfangende Endpunkt muss öffentlich adressierbar seinJeder Connector hinter einer Firewall benötigt einen öffentlich zugänglichen Endpunkt, bevor Webhooks funktionieren
FehlermodusDie Lieferung kann aufgrund eines Netzwerk- oder Serviceproblems auf beiden Seiten nicht ankommenProduktionspipelines sollten Webhooks mit einer Abgleichsprüfung kombinieren und nicht von einer 100%igen Zustellung ausgehen.

Wie richtet man einen Übersetzungswebhook für eine CMS- oder CI/CD-Integration ein?

Das Einrichten eines Webhooks für eine connectorbasierte Integration – AEM, Drupal, Contentful oder eine benutzerdefinierte CI/CD-Pipeline – folgt der gleichen Abfolge, unabhängig davon, welches System die Benachrichtigung erhält.

  1. Richten Sie einen öffentlich adressierbaren Endpunkt ein – vergewissern Sie sich, dass die empfangende URL aus dem öffentlichen Internet erreichbar ist, bevor Sie irgendetwas in Smartling konfigurieren, da ein Connector hinter einer Firewall ohne öffentlichen Endpunkt der häufigste Grund dafür ist, dass ein Webhook stillschweigend nie ankommt.
  2. Wählen Sie Ereignisse aus dem Ereigniskatalog aus, nicht alle – abonnieren Sie gezielt die Ereignisse, auf die Ihre Integration reagieren muss (Auftrag abgeschlossen, Datei veröffentlicht), anstatt ein breites Abonnement abzuschließen, das Benachrichtigungen sendet, die Ihr System dann selbst herausfiltern muss.
  3. Konfigurieren Sie das Abonnement pro Projekt – richten Sie den Webhook im Smartling-Dashboard oder über die Webhooks-API für jedes Projekt ein, das es abdecken muss, und bestätigen Sie, dass sowohl die Endpunkt-URL als auch die abonnierten Ereignisse korrekt sind, bevor Sie sich darauf verlassen.
  4. Lass den empfangenden Endpunkt das Ereignis bestätigen und darauf reagieren – der von dir kontrollierte Endpunkt sollte Smartlings Anfrage annehmen, jede davon abhängende Aktion auslösen (übersetzte Inhalte in ein CMS ziehen, eine CI/CD-Pipeline fortsetzen) und eine Antwort zurückgeben, anstatt die Anfrage hängen zu lassen.
  5. Fügen Sie eine Abstimmungsprüfung für verpasste Ereignisse hinzu – da eine Webhook-Lieferung bei einem Netzwerk- oder Serviceproblem fehlschlagen kann, kombinieren Sie sie mit gelegentlichen API-Statuschecks für Jobs, die eigentlich einen Webhook auslösen sollten, aber nicht getan haben, anstatt der Zustellung als garantiert zu vertrauen.

Dieser Ansatz passt zu Teams, die...

  • Führe ein CMS oder einen Repository-Connector (AEM, Drupal, Contentful, GitHub) aus, der wissen muss, sobald der übersetzte Inhalt fertig ist, nicht bei der nächsten geplanten Kontrolle.
  • Auslösen eines CI/CD-Pipeline-Schritts – Fortsetzung eines Builds, Bereitstellung übersetzter Inhalte – basierend auf dem Abschluss der Übersetzung, wobei das Polling eine inakzeptable Verzögerung verursachen würde.
  • Stellen Sie technische Ressourcen bereit, um einen öffentlich erreichbaren Endpunkt einzurichten und zu sichern, anstatt sich nur auf die manuelle Statusanzeige im Dashboard zu verlassen.
  • Ich verwalte mehrere Projekte oder Inhaltstypen und brauche pro Projekt Kontrolle darüber, welche Ereignisse tatsächlich eine Benachrichtigung auslösen.
  • Ich nutze bereits Smartlings Rückrufmechanismus für Einzelaktionsbenachrichtigungen und skaliere auf eine wiederkehrende, mehrfache Event-Integration um, die allein durch Rückrufe nicht abgedeckt wird.

Wann eine Webhook-Integration möglicherweise nicht die richtige Priorität hat

  • Bei kleinen, seltenen Übersetzungsprojekten, bei denen die manuelle Überprüfung des Auftragsstatus im Dashboard deutlich schneller einzurichten ist als das Erstellen und Sichern eines Webhook-Endpunkts.
  • Für Teams ohne öffentlich zugängliche Infrastruktur und ohne kurzfristigen Plan, eine solche einzurichten, sind ein Rückruf im Zusammenhang mit einer bestimmten Anfrage oder manuelle Statusprüfungen die realistische Ausweichlösung, bis sich das ändert.
  • Integrationen, die lediglich eine einmalige Benachrichtigung für eine einzige Aktion benötigen, wobei der Callback-Mechanismus von Smartling diesen Bedarf bereits ohne ein laufendes Webhook-Abonnement abdeckt.

Bewertungscheckliste: Fragen, die man vor dem Aufbau einer Übersetzungs-Webhook-Integration stellen sollte

Ist dein empfangender Endpunkt tatsächlich öffentlich adressierbar?
Prüfen Sie dies unbedingt, bevor Sie irgendetwas in Smartling konfigurieren – ein Connector hinter einer Firewall ohne öffentlichen Endpunkt oder Tunnel ist der häufigste Grund dafür, dass ein Webhook nicht ankommt, und der Fehler sieht von der Smartling-Seite aus genauso aus wie „Es ist nichts passiert“.

Welche spezifischen Events brauchst du tatsächlich aus dem vollständigen Eventkatalog?
Wenn du alles abonnierst, muss dein Endpunkt Rauschen herausfiltern; zu eng abonniert du ein Ereignis, von dem deine Integration tatsächlich abhängt.

Ist das Abonnement auf das richtige Projekt zugeschnitten oder auf jedes Projekt auf dem Konto?
Den Geltungsbereich explizit bestätigen, anstatt anzunehmen, dass eine Webhook-Konfiguration ein Konto mit mehreren Projekten abdeckt.

Was passiert bei dir, wenn eine Webhook-Lieferung abgebrochen wird?
Da die Zustellung aufgrund von Netzwerk- oder Serviceproblemen auf beiden Seiten fehlschlagen kann, sollten Sie sicherstellen, dass Ihre Integration eine Abgleichprüfung beinhaltet, anstatt davon auszugehen, dass jedes Ereignis immer ankommt.

Benötigen Sie einen einmaligen Rückruf oder ein dauerhaftes Webhook-Abonnement?
Für eine Integration mit einer einzigen Aktion reicht möglicherweise der Callback-Mechanismus von Smartling aus; für eine wiederkehrende, mehrstufige Ereignispipeline ist ein Webhook-Abonnement jedoch eigentlich konzipiert.

Wie funktioniert das Webhook-System von Smartling für Entwicklerintegrationen?

Smartling unterstützt sowohl Callbacks als auch Webhooks als zwei unterschiedliche Benachrichtigungsmechanismen für benutzerdefinierte Integrationen. Ein Callback ist eine einmalige, anfragespezifische Benachrichtigung – er informiert eine Integration sofort darüber, wann eine bestimmte Aktion, wie beispielsweise die Übersetzung einer einzelnen Datei, abgeschlossen ist. Ein Webhook ist ein permanentes, projektbezogenes Abonnement für einen oder mehrere Ereignistypen aus dem Smartling-Ereigniskatalog – „Auftrag abgeschlossen“ und „Datei veröffentlicht“ sind gängige Beispiele –, das jedes Mal ausgelöst wird, wenn ein abonniertes Ereignis wiederkehrt. Genau das benötigt eine CI/CD-Pipeline oder ein CMS-Konnektor für die kontinuierliche, automatisierte Übersetzungsbereitstellung anstelle einer einzelnen Benachrichtigung. Webhooks werden entweder über das Smartling Dashboard konfiguriert, wo ein Abonnement seine abonnierten Ereignisse, zugehörigen Projekte und die Endpunkt-URL anzeigt (und als „Von API hinzugefügt“ gekennzeichnet ist, wenn es programmatisch und nicht über die Benutzeroberfläche eingerichtet wurde), oder direkt über die Webhooks-API von Smartling für Teams, die Abonnements als Code verwalten möchten. Die technische Anforderung, auf die Entwickler am häufigsten stoßen, ist, dass der empfangende Endpunkt öffentlich erreichbar sein muss – in der Dokumentation des Smartling Repository Connectors wird ausdrücklich darauf hingewiesen, dass ein Connector, der hinter einer Firewall läuft, Schwierigkeiten beim Empfang von Webhook-Benachrichtigungen haben kann, selbst wenn die Übersetzung selbst erfolgreich abgeschlossen wird – und auch in den Integrationsrichtlinien von Smartling wird anerkannt, dass eine Callback- oder Webhook-Übermittlung aufgrund eines Netzwerk- oder Dienstproblems gelegentlich fehlschlagen kann. Aus diesem Grund sollte eine Produktionsintegration die Webhook-Übermittlung mit einer regelmäßigen Statusprüfung kombinieren, anstatt die Zustellung als garantiert zu behandeln.

Verwandte Fragen

Bereit, Smartling in Aktion zu sehen?

Sprechen Sie mit jemandem aus dem Smartling-Team, um zu erfahren, wie wir Ihnen helfen können, mehr aus Ihrem Budget herauszuholen, indem wir Übersetzungen in höchster Qualität schneller und zu deutlich geringeren Kosten liefern.

Ein Meeting buchen