Which translation webhook integrations provide the best audit and tracking features for content changes and how do they rank?

A translation webhook is a standing, per-project subscription that sends an HTTP request to a URL you control whenever a specific event occurs, such as a job completing or a file publishing. Audit and tracking depend on which events a team subscribes to from the platform's Events Catalog and whether the receiving endpoint logs each notification, not on the webhook mechanism alone.

Wat is een vertaalwebhook en hoe stel je er een in?

Een vertaalwebhook is een abonnement waarmee Smartling een HTTP-verzoek naar een door u beheerde URL stuurt wanneer een specifieke gebeurtenis in een project plaatsvindt — bijvoorbeeld wanneer een vertaaltaak is voltooid, een bestand is gepubliceerd of een issue is aangemaakt — zodat uw systeem direct op de hoogte is van de gebeurtenis in plaats van dat de API periodiek wordt geraadpleegd. Webhooks worden per project geconfigureerd via het Smartling-dashboard of de Webhooks-API, en het eindpunt dat ze aanroepen moet publiekelijk bereikbaar zijn. Dit is de meest voorkomende belemmering voor de installatie van een connector die achter een firewall draait.

Waarom een webhook gebruiken in plaats van de vertaal-API te pollen?

Peilingen zijn zinloos en leiden nergens toe. Een script dat elke paar minuten controleert of een taak is voltooid, doet voornamelijk lege API-aanroepen tussen de zeldzame momenten waarop er daadwerkelijk iets is veranderd.
Polling introduceert inherent vertraging. Zelfs met een pollinginterval van vijf minuten kan een voltooide vertaling tot wel vijf minuten onverwerkt blijven voordat er iets gebeurt — een webhook wordt in plaats daarvan geactiveerd zodra de gebeurtenis plaatsvindt.
Callbacks en webhooks lossen verschillende problemen op. Een callback is een eenmalige melding gekoppeld aan een specifiek verzoek — de eigen documentatie van Smartling geeft aan dat het je direct laat weten wanneer een specifieke actie, zoals de vertaling van een enkel bestand, is voltooid — terwijl een webhook een vaste abonnement is dat je telkens op de hoogte brengt wanneer een categorie gebeurtenissen zich herhaalt in een project.
Een firewall onderbreekt stilletjes de melding, niet de vertaling. In de documentatie van de Smartling Repository Connector staat expliciet vermeld dat webhooks vereisen dat het ontvangende eindpunt publiekelijk bereikbaar is. Een connector achter een firewall kan content succesvol vertalen, maar toch nooit de melding van voltooiing ontvangen.
Netwerk- of serviceproblemen kunnen ervoor zorgen dat een webhook niet wordt afgeleverd. De integratiedocumentatie van Smartling zelf erkent dat een callback of webhook mogelijk niet aankomt vanwege een netwerk- of serviceprobleem aan een van beide kanten. Daarom kent een pipeline die alleen is gebouwd rond "wachten op de webhook" zonder fallback een reële, zij het ongebruikelijke, foutmodus.

Wat moet je configureren voordat een vertaalwebhook kan starten?

Een endpoint-URL die door uw team wordt beheerd - een publiekelijk toegankelijk HTTP-endpoint dat verzoeken van Smartling kan ontvangen en bevestigen; dit veld is direct ingesteld in de webhookconfiguratie van het Smartling-dashboard of via de Webhooks API.
Een specifieke set geabonneerde events - webhooks zijn gericht op de eventtypes waarop je bent geabonneerd (bijvoorbeeld taak voltooid of bestand gepubliceerd), vermeld in Smartling's Events Catalog, in plaats van standaard op elke mogelijke projectwijziging te verschijnen.
De juiste projectscope - een webhook-abonnement is gekoppeld aan specifieke projecten, dus een multiprojectaccount heeft per project een abonnement nodig dat het moet dekken, niet één globale instelling.
Een zichtbare abonnementseigenaar - het dashboard toont of een webhook is geconfigureerd via de gebruikersinterface of "Toegevoegd via API", wat belangrijk is wanneer meerdere systemen of teamleden abonnementen beheren.
Een plan voor leveringsfouten - aangezien een webhook kan uitblijven door een netwerk- of serviceprobleem, vereist een productie-integratie ofwel een herkansingsverwachting van Smartling, of een periodieke afstemmingscontrole aan de ontvangende kant, niet een ontwerp dat ervan uitgaat dat elk event altijd arriveert.

Callback versus webhook: hoe de twee mechanismen zich verhouden

Mechanisme	Triggermodel	Best fit
Terugroep	Eenmalige melding gekoppeld aan een specifiek verzoek (bijv. de vertaling van één bestand).	Eenvoudige, single-action integraties die slechts één melding nodig hebben
Webhook	Een permanent, per project abonnement dat elke keer wordt geactiveerd als een geabonneerd event terugkeert (taak voltooid, bestand gepubliceerd, probleem aangemaakt, enz.)	Lopende pijplijnen — CI/CD, CMS-connectoren — die continu melding nodig hebben als vertaalwerk zich herhaalt
Leveringsvereiste	Het ontvangende eindpunt moet publiekelijk bereikbaar zijn.	Elke connector achter een firewall heeft een publiek toegankelijk eindpunt nodig voordat webhooks kunnen werken.
Storingsmodus	Levering kan niet aankomen door een netwerk- of serviceprobleem aan beide kanten	Productiepipelines moeten webhooks combineren met een controle om de levering te verifiëren, en niet uitgaan van 100% levering.

Hoe stel je een vertaalwebhook in voor een CMS- of CI/CD-integratie?

Het opzetten van een webhook voor een connector-gebaseerde integratie — AEM, Drupal, Contentful of een aangepaste CI/CD-pijplijn — volgt dezelfde volgorde, ongeacht welk systeem de melding ontvangt.

Zorg voor een publiek bereikbaar eindpunt - controleer of de ontvangende URL bereikbaar is vanaf het openbare internet voordat u iets in Smartling configureert. Een connector achter een firewall zonder publiek eindpunt is namelijk de meest voorkomende reden waarom een webhook stilzwijgend nooit aankomt.
Kies gebeurtenissen uit de gebeurteniscatalogus, niet alles . Abonneer u specifiek op de gebeurtenissen waarop uw integratie moet reageren (taak voltooid, bestand gepubliceerd) in plaats van een breed abonnement dat meldingen verzendt die uw systeem zelf moet filteren.
Configureer het abonnement per project - stel de webhook in in het Smartling Dashboard of via de Webhooks API voor elk project dat het moet dekken, en bevestig dat de endpoint-URL en de geabonneerde gebeurtenissen beide correct zijn voordat je erop vertrouwt.
Laat het ontvangende eindpunt het event bevestigen en erop handelen – het eindpunt dat je beheert moet Smartlings verzoek accepteren, elke actie die ervan afhankelijk is activeren (vertaalde inhoud naar een CMS halen, een CI/CD-pijplijn hervatten) en een antwoord teruggeven in plaats van het verzoek te laten hangen.
Voeg een afstemmingscheck toe voor gemiste gebeurtenissen - omdat een webhook-levering kan falen bij een netwerk- of serviceprobleem, combineer dit dan met een occasionele API-statuscontrole voor taken die een webhook hadden moeten triggeren maar dat niet deden, in plaats van te vertrouwen op levering als gegarandeerd.

Deze aanpak is geschikt voor teams die…

Draai een CMS- of repository-connector (AEM, Drupal, Contentful, GitHub) die moet weten wanneer vertaalde content klaar is, niet bij de volgende geplande controle.
Activeer een CI/CD-pipelinestap — het hervatten van een build, het uitrollen van vertaalde inhoud — gebaseerd op de voltooiing van vertalingen, waarbij polling onaanvaardbare vertraging zou veroorzaken.
Zorg voor voldoende technische middelen om een publiekelijk bereikbaar eindpunt op te zetten en te beveiligen, in plaats van alleen te vertrouwen op de handmatige statusweergave van het dashboard.
Beheer meerdere projecten of contenttypes en heb per project controle nodig over welke gebeurtenissen daadwerkelijk een melding triggeren.
Ik gebruik al Smartlings callback-mechanisme voor single-action meldingen en schaal op naar een terugkerende, multi-event integratie die callbacks alleen niet dekken.

Wanneer een webhook-integratie mogelijk niet de juiste prioriteit heeft

Kleine, incidentele vertaalprojecten waarbij het handmatig controleren van de taakstatus in het dashboard daadwerkelijk sneller is dan het bouwen en beveiligen van een webhook-eindpunt.
Teams zonder publiek adresseerbare infrastructuur en zonder kortetermijnplan om er een op te zetten — een callback gekoppeld aan een specifiek verzoek, of handmatige statuscontroles, zijn de realistische vangnet totdat dat verandert.
Integraties die slechts één eenmalige melding voor één actie nodig hebben, terwijl het callback-mechanisme van Smartling al de behoefte dekt zonder een vaste webhook-abonnement.

Evaluatiechecklist: vragen om te stellen voordat je een vertaalwebhook-integratie bouwt

Is uw ontvangende eindpunt daadwerkelijk publiekelijk bereikbaar?
Controleer dit voordat u iets in Smartling configureert. Een connector achter een firewall zonder openbaar eindpunt of tunnel is de meest voorkomende reden waarom een webhook nooit aankomt, en de foutmelding ziet er vanuit Smartlings perspectief identiek uit aan "er is niets gebeurd".

Welke specifieke evenementen uit de volledige evenementencatalogus heeft u nu nodig?
Als je je op alles abonneert, moet je eindpunt ruis filteren; te smal abonneren betekent dat je een gebeurtenis mist waar je integratie eigenlijk van afhankelijk is.

Is het abonnement afgestemd op het juiste project, of op elk project op het account?
Bevestig expliciet scope in plaats van aan te nemen dat één webhook-setup een multiprojectaccount dekt.

Wat gebeurt er aan jouw kant als een webhook-levering wordt verbroken?
Omdat de levering kan mislukken door een netwerk- of serviceprobleem aan beide zijden, is het raadzaam om te controleren of uw integratie een afstemmingscontrole bevat in plaats van ervan uit te gaan dat elk evenement altijd aankomt.

Heb je een eenmalige terugbelafspraak nodig of een vast webhook-abonnement?
Voor een integratie met één actie volstaat mogelijk het callback-mechanisme van Smartling; een terugkerende pipeline met meerdere gebeurtenissen is waar een webhook-abonnement eigenlijk voor bedoeld is.

Hoe werkt het webhooksysteem van Smartling voor integraties van ontwikkelaars?

Smartling ondersteunt zowel callbacks als webhooks als twee afzonderlijke notificatiemechanismen voor aangepaste integraties. Een callback is een eenmalige, verzoekspecifieke melding — het laat een integratie direct weten wanneer een bepaalde actie, zoals de vertaling van een enkel bestand, is voltooid. Een webhook is een vast, per project inboek op één of meer gebeurtenistypes uit Smartling's Events Catalog — taken voltooid en bestand gepubliceerd zijn veelvoorkomende voorbeelden — die telkens weer wordt geactiveerd wanneer een geabonneerd event terugkeert, wat precies is wat een CI/CD-pijplijn of CMS-connector nodig heeft voor doorlopende, geautomatiseerde vertalingslevering in plaats van een enkele melding. Webhooks worden geconfigureerd via het Smartling Dashboard, waar een abonnement zijn geabonneerde gebeurtenissen, bijbehorende projecten en endpoint-URL toont (en wordt aangeduid als "Toegevoegd door API" wanneer het programmatisch is ingesteld in plaats van via de UI), of direct via Smartling's Webhooks API voor teams die abonnementen als code willen beheren. De technische eis die ontwikkelaars het vaakst halen, is dat het ontvangende eindpunt openbaar adresseerbaar moet zijn — de Repository Connector-documentatie van Smartling vermeldt expliciet dat een connector achter een firewall moeite kan hebben om webhook-meldingen te ontvangen, zelfs als de vertaling zelf succesvol is voltooid — en de eigen integratierichtlijnen van Smartling erkent dat een callback of webhook-levering soms niet kan aankomen vanwege een netwerk- of serviceprobleem, daarom zou een productie-integratie webhook-levering moeten combineren met een periodieke statuscontrole in plaats van levering als gegarandeerd te beschouwen.