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 de Zendesk se habilita por organización. Si no la ves en Settings -> Integrations, ponte en contacto con nosotros y te la activaremos.
Antes de empezar#
Necesitas tres cosas:
Acceso de administrador a Zendesk. La conexión usa OAuth y la cuenta que autoriza debe tener permisos para gestionar el contenido del centro de ayuda.
Tus idiomas de destino deben estar habilitados en Zendesk. Zendesk solo acepta traducciones a idiomas que el Centro de ayuda ya tenga configurados. Actívalos en Zendesk, en Knowledge -> Settings -> Language settings.
Los idiomas añadidos en Admin Center -> Account -> Appearance -> Localization forman una lista independiente 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 has iniciado sesión como administrador/a. Todo lo que aparezca en ese endpoint es lo que podrás seleccionar en Lingo.dev.Un motor de localización. Su glosario, voz de marca y reglas son lo que seguirán las traducciones de tu centro de ayuda.
Los códigos de idioma deben coincidir exactamente con los de 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 frente a en) y ese desajuste es, con diferencia, el motivo más habitual por el que falla una conexión.
Conecta tu centro de ayuda#
Abre la integración
Ve a Settings -> Integrations y haz clic en Connect en Zendesk.
Rellena el formulario
| Campo | Qué introducir |
|---|---|
| Subdominio | Solo la parte identificativa de tu URL de Zendesk. Para https://acme.zendesk.com, introduce 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 quieres traducir. Todos deben estar habilitados antes en Zendesk |
| Guardar como borradores | Déjalo activado para guardar las traducciones como borradores sin publicar. Desactívalo para publicarlas al momento |
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 ya 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 la parte superior (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 comprobar qué estás seleccionando.
Seleccionar una categoría no selecciona su contenido
Las categorías, secciones y artículos se eligen por separado. Si quieres traducir una categoría completa, selecciona la categoría y también 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 sin haber guardado nada, la ejecución volverá sin nada que traducir. Haz clic en Save y luego traduce.
Qué se traduce#
| Elemento | Campos traducidos |
|---|---|
| Categoría | Título, descripción |
| Sección | Título, descripción |
| Artículo | Título, cuerpo |
El cuerpo de los artículos se traduce como HTML, así que el formato, los enlaces y el contenido multimedia incrustado se conservan de principio a fin.
Sincroniza y vuelve a traducir#
Dos botones, dos tareas distintas:
| Botón | Qué hace | Cuándo usarlo |
|---|---|---|
| Sync | Traduce solo lo que ha cambiado desde la última ejecución | Actualizaciones habituales. Es la opción que usarás la mayor parte del tiempo |
| Retranslate | Vuelve a traducir desde cero todo lo que entra en el alcance | Después de cambiar el glosario, la voz de marca o las reglas de tu motor, cuando quieras regenerar las traducciones existentes |
Ambas opciones están disponibles en dos sitios: en la cabecera de la página, donde abarcan todo tu alcance guardado, y encima 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 ninguna: 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 desactivados.
Sigue una ejecución#
La pestaña Runs muestra todas las ejecuciones con su estado, qué las ha desencadenado, cuándo empezaron y cuánto tardaron. Si una ejecución sigue en curso, puedes cancelarla desde la lista.
Abre una ejecución para ver los detalles: en qué fase está —extrayendo contenido de Zendesk, traduciendo o escribiéndolo de vuelta—, además del progreso general y del progreso por idioma de destino, para que puedas ver, por ejemplo, que el alemán ya ha terminado mientras el japonés sigue en curso.
Una ejecución que termina como nothing to translate 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 medias.
Dónde van a parar las traducciones#
Cada traducción se adjunta al mismo artículo, sección o categoría como una versión por configuración regional, que es el propio modelo de traducción de Zendesk. Tus lectores cambian de idioma en el Centro de ayuda y acceden a ella; no se duplica ni se mueve nada.
A quién se atribuyen las traducciones
En Zendesk, cada traducción se atribuye a la cuenta que autorizó la conexión, no a la persona que hizo clic en Sync. Si prefieres que no aparezca el nombre de un miembro del equipo en todo el Centro de ayuda, conecta usando una cuenta de servicio compartida.
Borradores o contenido publicado#
Con Save as drafts activado, las traducciones llegan a Zendesk como borradores sin publicar. Nada será visible para tus clientes hasta que alguien las revise y publique en Zendesk. Es la opción segura por defecto y la más recomendable mientras evalúas la calidad de la traducción.
Si lo desactivas, las traducciones se publicarán en cuanto se escriban.
Puedes cambiarlo más adelante en Settings -> Integrations -> Zendesk, junto con tu motor y tus idiomas de destino.
Desconectar#
Al desconectar, se eliminan la conexión, su historial de ejecuciones y el registro por artículo de lo que ya se ha traducido. Las traducciones que ya se hayan escrito se quedan en Zendesk: pertenecen a tu Centro de ayuda, no a nosotros.
Volver a conectar es empezar desde cero
Como el estado de sincronización por artículo se pierde, la primera sincronización después de volver a conectar tratará todo tu alcance como si fuera nuevo y lo traducirá entero otra vez, con el coste que eso implica. Desconecta cuando de verdad quieras parar, no para resolver problemas.
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 |
Resolución de problemas#
La conexión falla justo después de hacer clic en Permitir. Casi siempre se debe a una discrepancia de idioma: el idioma de origen que has seleccionado no existe en el Centro de ayuda. Abre https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, anota el código exacto que aparece allí y vuelve a conectarlo usando ese código.
Falta un idioma de destino en el menú desplegable. Actívalo primero en Zendesk, en Knowledge -> Settings -> Language settings, y después vuelve a abrir la configuración en Lingo.dev.
Sync indica que no hay nada que traducir. O bien tu alcance guardado está vacío —selecciona contenido en la pestaña Content y haz clic en Save—, o bien todo lo que incluye ya está actualizado.
Las traducciones no aparecen en el centro de ayuda. Comprueba si la conexión está en modo borrador. Los borradores existen en Zendesk, pero siguen siendo invisibles para los clientes hasta que se publiquen.
