.svg)
.svg)
.svg)
%201Q26_%20GRC%202029.png?width=600&name=(CTA)%201Q26_%20GRC%202029.png)
.svg)
.svg)
¿Qué es un webhook de traducción y cómo se configura?
Un webhook de traducción es una subscripción que hace que Smartling envíe una solicitud HTTP a una URL que usted controla cada vez que ocurre un evento específico en un proyecto (la finalización de un trabajo de traducción, la publicación de un archivo, la creación de una incidencia), de modo que su sistema se entera en el momento en que sucede, en lugar de consultar la API periódicamente. Los webhooks se configuran por proyecto a través del panel de control de Smartling o la API de webhooks, y el punto final al que llaman debe ser accesible públicamente, lo cual es el obstáculo de configuración más común para un conector que se ejecuta detrás de un firewall.
Última revisión: 4 de septiembre de 2026
¿Por qué usar un webhook en vez de consultar la API de traducción?
- Las encuestas desperdician llamadas sin fundamento. Un script que comprueba si un trabajo se completó cada pocos minutos hace llamadas a la API mayormente vacías entre los raros momentos en que algo realmente cambió.
- El sondeo agrega latencia por diseño. Incluso un intervalo de sondeo de cinco minutos significa que una traducción completada puede permanecer sin procesar hasta cinco minutos antes de que alguien lo detecte; en su lugar, un webhook se activa en el momento en que ocurre el evento.
- Las funciones de devolución de llamada y los webhooks resuelven problemas diferentes. Una devolución de llamada es una notificación única vinculada a una solicitud específica; la propia documentación de Smartling la describe como una forma de avisarle inmediatamente cuando finaliza una acción específica, como la traducción de un solo archivo. Por otro lado, un webhook es una subscripción permanente que le notifica cada vez que se repite una categoría de evento en un proyecto.
- Un firewall interrumpe silenciosamente la notificación, no la traducción. La documentación del conector del repositorio de Smartling deja claro que los webhooks requieren que el punto final receptor sea accesible públicamente; un conector que se encuentre detrás de un firewall puede traducir el contenido correctamente y aun así no recibir nunca la notificación de finalización.
- Los problemas de red o de servicio pueden provocar la interrupción de la entrega de un webhook. La propia documentación de integración de Smartling reconoce que una devolución de llamada o un webhook pueden no llegar debido a un problema de red o de servicio en cualquiera de los extremos, razón por la cual una canalización construida únicamente en torno a "esperar el webhook" sin un mecanismo de reservación tiene un modo de fallo real, aunque poco común.
¿Qué necesitas configurar antes de que se active un webhook de traducción?
- Una URL de punto final que controla tu equipo : un punto final HTTP accesible públicamente que puede recibir y confirmar la solicitud de Smartling; este es el campo que se configura directamente en la configuración de webhook del panel de control de Smartling o a través de la API de webhooks.
- Un conjunto específico de eventos suscritos (los webhooks) están limitados a los tipos de eventos a los que te suscribes (por ejemplo, trabajo completado o archivo publicado), que aparecen en el catálogo de eventos de Smartling, en lugar de activar con cada posible cambio del proyecto de forma predeterminada.
- El alcance adecuado del proyecto : una subscripción a un webhook está vinculada a proyectos específicos, por lo que una cuenta multiproyecto necesita una subscripción configurada para cada proyecto que deba cubrir, no una configuración global.
- Un propietario de subscripción visible : el panel de control muestra si un webhook se configuró a través de la interfaz de usuario o se agregó mediante la API, lo cual es importante cuando más de un sistema o miembro del equipo puede estar gestionando las subscripciones.
- Un plan para fallos de entrega : dado que un webhook puede fallar debido a un problema de red o servicio, una integración en producción necesita una expectativa de reintento por parte de Smartling o una comprobación periódica de conciliación en el lado receptor, no un diseño que asuma que siempre llega cada evento.
Callback vs. webhook: cómo se comparan ambos mecanismos
| Mecanismo | Modelo de disparo | Best fit |
|---|---|---|
| Llamar de vuelta | Notificación única vinculada a una solicitud específica (por ejemplo, la traducción de un solo archivo). | Integraciones sencillas de acción única que solo necesitan una notificación |
| Webhook | Subscripción permanente por proyecto que se activa cada vez que un evento suscrito se repite (trabajo completado, archivo publicado, número creado, etc.) | Canalizaciones en curso (CI/CD, conectores CMS) que necesitan notificación continua a medida que se repite el trabajo de traducción. |
| Requisitos de entrega | El punto final receptor debe ser accesible públicamente. | Cualquier conector detrás de un firewall necesita un punto final público antes de que los webhooks funcionen |
| Modo de fallo | La entrega puede no llegar debido a un problema de red o servicio en cualquiera de los dos lados | Los pipelines de producción deben combinar webhooks con una verificación de conciliación, no asumir una entrega del 100%. |
¿Cómo configuras un webhook de traducción para una integración CMS o CI/CD?
Configurar un webhook para una integración basada en conectores (AEM, Drupal, Contentful o una canalización CI/CD personalizada) sigue la misma secuencia independientemente del sistema que reciba la notificación.
- Crea un endpoint públicamente direccionable : confirma que la URL receptora es accesible desde Internet público antes de configurar cualquier cosa en Smartling, ya que un conector detrás de un firewall sin endpoint público es la razón más común por la que un webhook nunca llega silenciosamente.
- Seleccione eventos del Catálogo de eventos, no todos : suscribir específicamente a los eventos que su integración necesita para actuar (tarea completada, archivo publicado) en lugar de una subscripción general que envíe notificaciones que su sistema tenga que filtrar por sí mismo.
- Configura la subscripción por proyecto : configura el webhook en el Smartling Dashboard o a través de la API de Webhooks para cada proyecto que deba cubrir, confirmando que la URL del endpoint y los eventos suscritos están correctos antes de confiar en él.
- Haz que el endpoint receptor reconozca y actúe sobre el evento : el endpoint que controlas debe aceptar la petición de Smartling, activar la acción que dependa de ella (extraer contenido traducido a un CMS, reanudar una pipeline CI/CD) y devolver una respuesta en lugar de dejar la solicitud colgada.
- Agrega una comprobación de conciliación para eventos perdidos : como una entrega por webhook puede fallar en un problema de red o servicio, combínala con una comprobación ocasional del estado de la API para trabajos que deberían activar un webhook pero no lo hicieron, en lugar de confiar en la entrega como se garantía.
Este enfoque se adapta a equipos que...
- Ejecuta un CMS o conector de repositorio (AEM, Drupal, Contentful, GitHub) que necesite saber cuándo el contenido traducido está listo, no en la siguiente comprobación programada.
- Activar un paso de la pipeline CI/CD — reanudar una compilación, desplegar contenido traducido — basado en la finalización de la traducción, donde el sondeo agregaría un retraso inaceptable.
- Que los recursos de ingeniería se establezcan y cercioren un endpoint públicamente direccionable, en lugar de depender solo de la vista de estado manual del panel.
- Gestiona múltiples proyectos o tipos de contenido y necesita tener control, proyecto por proyecto, sobre qué eventos activan una notificación.
- Ya empleo el mecanismo de callback de Smartling para notificaciones de acción única y estamos escalando a una integración recurrente y multievento que las callbacks por sí solas no cubren.
Cuando la integración de un webhook puede no ser la prioridad adecuada
- Proyectos de traducción pequeños y poco frecuentes en los que comprobar manualmente el estado del trabajo en el panel de control es realmente más rápido de configurar que crear y proteger un punto final de webhook.
- Para los equipos que no cuentan con una infraestructura accesible públicamente y que no tienen previsto implementarla a corto plazo, la solución más realista hasta que la situación cambie es recurrir a un sistema de devolución de llamada vinculado a una solicitud específica o a comprobaciones manuales del estado.
- Integraciones que solo necesitan una notificación única para una acción, donde el mecanismo de callback de Smartling ya cubre la necesidad de no tener una subscripción permanente al webhook.
Lista de verificación de evaluación: preguntas que debe hacer antes de crear una integración de webhook de traducción.
¿Tu endpoint receptor es realmente direccionable públicamente?
Confirma esto antes de configurar nada en Smartling: un conector detrás de un firewall sin endpoint o túnel público es la razón más común por la que nunca llega un webhook, y el fallo parece idéntico a "no pasó nada" desde el lado de Smartling.
¿Qué eventos específicos necesitas realmente, del Catálogo completo de Eventos?
Suscribir a todo implica que su punto final tenga que filtrar el ruido; suscribir a algo demasiado específico significa que se perderá un evento del que realmente depende su integración.
¿La subscripción está relacionada con el proyecto correcto o con todos los proyectos de la cuenta?
Confirme el alcance explícitamente en lugar de asumir que una configuración de webhook cubre una cuenta de varios proyectos.
¿Qué pasa en tu caso si se pierde una entrega por webhook?
Dado que la entrega puede fallar debido a un problema de red o de servicio en cualquiera de los dos lados, confirme que su integración tenga alguna verificación de conciliación en lugar de asumir que todos los eventos siempre llegan.
¿Necesitas una llamada de retorno única o una subscripción permanente a un webhook?
Una integración de una sola acción puede requerir únicamente el mecanismo de devolución de llamada de Smartling; una subscripción a un webhook está diseñada precisamente para gestionar un flujo de eventos múltiples y recurrentes.
¿Cómo funciona el sistema de webhooks de Smartling para las integraciones de desarrolladores?
Smartling soporta tanto callbacks como webhooks como dos mecanismos de notificación distintos para integraciones personalizadas. Una devolución de llamada es una notificación única y específica para una solicitud: permite a la integración saber inmediatamente cuando una acción concreta, como la traducción de un solo archivo, finalizó. Un webhook es una subscripción permanente por proyecto a uno o más tipos de eventos del Catálogo de Eventos de Smartling — trabajo completado y archivo publicado son ejemplos comunes — que se activa cada vez que un evento suscrito se repite, que es lo que una pipeline CI/CD o conector CMS necesita para una entrega automatizada de traducción continua en lugar de una notificación única. Los Webhooks se configuran ya sea a través del Smartling Dashboard, donde una subscripción muestra sus eventos suscritos, proyectos asociados y la URL del endpoint (y se etiqueta como "Añadido por API" cuando se configura de forma programática en lugar de a través de la interfaz), o directamente a través de la API Webhooks de Smartling para equipos que quieren gestionar las subscripciones como código. El requisito técnico que los desarrolladores suelen encontrar es que el endpoint receptor debe ser direccionable públicamente — la documentación del Repository Connector de Smartling señala explícitamente que un conector que corre detrás de un firewall puede tener dificultades para recibir notificaciones de webhook incluso cuando la traducción se completa con éxito — y la propia guía de integración de Smartling reconoce que una entrega de callback o webhook puede fallar ocasionalmente debido a un problema de red o servicio, por lo que una integración en producción debería emparejar la entrega por webhook con una comprobación periódica de estado en lugar de tratar la entrega como garantizada.
Preguntas relacionadas
- ¿Cuáles son las principales plataformas de localización basadas en API y cómo se comparan en cuanto a características y precio?
- ¿Qué es un conector de traducción contenida y cómo funciona Smartling's?
- ¿Cuáles son las mejores opciones de integración de traducción de AEM para sitios web empresariales?
- ¿Cuáles son los mejores módulos de traducción de Drupal para un sitio web multilingüe?
¿Listo para ver a Smartling en acción?
Converse con alguien del equipo de Smartling para identificar cómo podemos ayudarle a aprovechar mejor su presupuesto al entregarle traducciones con la más alta calidad, mayor rapidez y a costos mucho más bajos.