Conecta tu Centro de ayuda de Zendesk a un motor de localización. Elige las categorías, secciones y artículos que quieres incluir, y Lingo.dev los traduce a tus idiomas de destino y devuelve las traducciones a Zendesk.
Funciona con el contenido de Zendesk Guide (Centro de ayuda): categorías, secciones y artículos.
La integración con Zendesk se habilita por organización. Si no la ves en Settings -> Integrations, escríbenos y la activamos por ti.
Antes de empezar#
Necesitas tres cosas:
Acceso de administrador a Zendesk. La conexión usa OAuth y la cuenta que autoriza debe tener permiso para administrar el contenido del Centro de ayuda.
Tus idiomas de destino habilitados en Zendesk. Zendesk solo acepta traducciones para un idioma que el Centro de ayuda ya tenga registrado. Actívalos en Zendesk en Knowledge -> Settings -> Language settings.
Los idiomas agregados en Admin Center -> Account -> Appearance -> Localization están en una lista separada y NO habilitan un idioma del Centro de ayuda.
Para ver exactamente qué acepta tu Centro de ayuda, abre
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonmientras inicias sesión como administrador. Todo lo que aparezca en ese endpoint es lo que puedes elegir en Lingo.dev.Un motor de localización. Su glosario, voz de marca y reglas son los que seguirán las traducciones de tu Centro de ayuda.
Los códigos de idioma deben coincidir exactamente con Zendesk
Zendesk usa códigos como en-us y de-de. Si el idioma de origen de tu Centro de ayuda aparece como en-us, elige English (United States) en Lingo.dev, no solo English: son dos idiomas distintos (en-US vs en) y esa diferencia es, por mucho, la causa más común de que falle una conexión.
Conecta tu Centro de ayuda#
Abre la integración
Ve a Settings -> Integrations y haz clic en Connect en Zendesk.
Completa el formulario
| Campo | Qué ingresar |
|---|---|
| Subdominio | Solo la parte de tu URL de Zendesk. Para https://acme.zendesk.com ingresa acme: sin https:// ni .zendesk.com |
| Motor | El motor de localización que traducirá este contenido |
| Idioma de origen | El idioma en el que están escritos tus artículos, exactamente como aparece en Zendesk |
| Idiomas de destino | Los idiomas a los que se traducirá el contenido. Todos deben estar habilitados primero en Zendesk |
| Guardar como borradores | Déjalo activado para guardar las traducciones como borradores no publicados. Desactívalo para publicarlas de inmediato |
Autoriza en Zendesk
Se te redirigirá a Zendesk. Haz clic en Allow. Volverás a la página de Zendesk en Lingo.dev con la conexión activa.
Elige qué se traduce#
La página de Zendesk tiene dos pestañas: Content y Runs.
La pestaña Content muestra todo lo que hay en tu Centro de ayuda —categorías, secciones y artículos— en una sola tabla. Usa los chips de filtro de arriba (All, Categories, Sections, Articles) para acotar la lista y las casillas para elegir lo que quieres incluir. El nombre de cada fila enlaza con ese elemento en Zendesk, para que puedas revisar exactamente qué estás seleccionando.
Seleccionar una categoría no selecciona lo que contiene
Las categorías, secciones y artículos se eligen por separado. Si quieres traducir una categoría completa, selecciona la categoría y sus secciones y artículos.
Guarda antes de sincronizar. Una conexión nueva empieza con un alcance vacío, y la sincronización usa el alcance guardado, no lo que esté marcado en pantalla en ese momento. Si sincronizas antes de guardar, la ejecución volverá sin nada para traducir. Haz clic en Guardar y después traduce.
Qué se traduce#
| Elemento | Campos traducidos |
|---|---|
| Categoría | Título, descripción |
| Sección | Título, descripción |
| Artículo | Título, cuerpo |
Los cuerpos de los artículos se traducen como HTML, así que el formato, los enlaces y el contenido multimedia incrustado se conservan de principio a fin.
Sincronizar y retraducir#
Dos botones, dos tareas distintas:
| Botón | Qué hace | Cuándo usarlo |
|---|---|---|
| Sync | Traduce solo lo que cambió desde la última ejecución | Actualizaciones rutinarias. Es la opción que vas a usar la mayor parte del tiempo |
| Retranslate | Vuelve a traducir desde cero todo lo que está dentro del alcance | Después de cambiar el glosario, la voz de marca o las reglas de tu motor, cuando quieras regenerar las traducciones existentes |
Ambos están disponibles en dos lugares: en el encabezado de la página, donde abarcan todo tu alcance guardado, y arriba de la tabla de contenido, donde abarcan solo las filas que hayas seleccionado.
Las ejecuciones son manuales. Editar un artículo en Zendesk no inicia una ejecución; tú decides cuándo traducir.
Solo puede haber una ejecución en curso a la vez. Mientras haya una ejecución activa, ambos botones estarán deshabilitados.
Sigue una ejecución#
La pestaña Runs muestra cada ejecución con su estado, qué la activó, cuándo comenzó y cuánto tardó. Si una ejecución sigue en curso, puedes cancelarla desde la lista.
Abre una ejecución para ver los detalles: en qué etapa está —extrayendo contenido de Zendesk, traduciendo o escribiéndolo de vuelta—, además del progreso general y el progreso por idioma de destino, para que puedas ver, por ejemplo, que alemán ya terminó mientras japonés sigue en proceso.
Una ejecución que termina como nada para traducir no es un error. Significa que todo lo incluido en el alcance ya coincide con sus traducciones, que es el resultado normal de sincronizar dos veces sin editar nada entre una y otra.
Dónde quedan las traducciones#
Cada traducción se adjunta al mismo artículo, sección o categoría como una versión por configuración regional: el propio modelo de traducción de Zendesk. Tus lectores solo cambian el idioma en el Centro de ayuda y listo; no se duplica ni se mueve nada.
A quién se atribuyen las traducciones
En Zendesk, cada traducción queda como autoría de la cuenta que autorizó la conexión, no de la persona que hizo clic en Sincronizar. Si prefieres que el nombre de un miembro del equipo no aparezca en todo el Centro de ayuda, conecta con una cuenta de servicio compartida.
Borradores vs. publicados#
Con Save as drafts activado, las traducciones llegan a Zendesk como borradores no publicados. Nada será visible para tus clientes hasta que alguien las revise y publique en Zendesk. Esta es la opción predeterminada más segura y la que conviene mantener mientras evalúas la calidad de la traducción.
Si lo desactivas, las traducciones se publican en cuanto se escriben.
Puedes cambiar esto más adelante en Settings -> Integrations -> Zendesk, junto con tu motor y tus idiomas de destino.
Desconectar#
Al desconectar, se elimina la conexión, su historial de ejecuciones y el registro por artículo de lo que ya se tradujo. Las traducciones que ya se escribieron permanecen en Zendesk: le pertenecen a tu Centro de ayuda, no a nosotros.
Volver a conectar empieza desde cero
Como el estado de sincronización por artículo desaparece, la primera sincronización después de volver a conectar trata todo tu alcance como si fuera nuevo y lo traduce otra vez completo, con el costo que eso implica. Desconecta cuando de verdad quieras detenerte, no para resolver un problema.
Límites#
| Límite | Detalle |
|---|---|
| Tipos de contenido | Categorías, secciones y artículos. No incluye tickets, macros, temas ni publicaciones de la comunidad. |
| Bloques de contenido | No se traducen los artículos creados a partir de bloques de contenido de Zendesk |
| Activadores | Solo manual: sin webhook ni sincronización automática cuando cambia un artículo |
| Ejecuciones simultáneas | Una por conexión |
| Idiomas de destino | Deben estar habilitados en tu Centro de ayuda de Zendesk antes de que una ejecución pueda escribir en ellos |
Solución de problemas#
La conexión falla justo después de hacer clic en Allow. Casi siempre se debe a una discrepancia de idioma: el idioma de origen que elegiste no existe en el Centro de ayuda. Abre https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, revisa el código exacto que aparece ahí y vuelve a conectarte con ese.
Falta un idioma de destino en la lista desplegable. Primero actívalo en Zendesk en Knowledge -> Settings -> Language settings y luego vuelve a abrir la configuración en Lingo.dev.
La sincronización dice que no hay nada para traducir. O bien tu alcance guardado está vacío —selecciona contenido en la pestaña Contenido y haz clic en Guardar—, o bien todo lo que incluye ya está actualizado.
Las traducciones no aparecen en el Centro de ayuda. Revisa si la conexión está en modo borrador. Los borradores existen en Zendesk, pero permanecen invisibles para los clientes hasta que se publiquen.
