Centro de ayuda de Zendesk
Conecta tu Centro de ayuda de Zendesk a un motor de localización. Activa Sync en las categorías, secciones y artículos que quieras incluir, y Lingo.dev los traduce a los idiomas de tu Centro de ayuda y devuelve las traducciones a Zendesk.
Funciona con el contenido de Zendesk Guide (Centro de ayuda): categorías, secciones y artículos.
Zendesk está disponible con Enterprise. Si en la página Connect aparece Zendesk no está en tu plan, ponte en contacto con nosotros y lo solucionaremos.
Antes de empezar#
Necesitas tres cosas:
Acceso de administrador a Zendesk. La conexión usa OAuth y la cuenta que autoriza necesita permiso para gestionar el contenido del Centro de ayuda. Todas las traducciones que Lingo.dev escribe se atribuyen a esa cuenta en Zendesk, así que conecta una cuenta de servicio compartida si prefieres que no aparezca el nombre de una sola persona del equipo en todo el Centro de ayuda.
Tus idiomas de destino activados en Zendesk. Lingo.dev ofrece exactamente los idiomas que tu Centro de ayuda tiene activados, y ninguno más. 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 ofrecerá 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.
El idioma de origen no se elige: Lingo.dev lee el idioma predeterminado de tu Centro de ayuda desde Zendesk en cada ejecución.
¿Tu Centro de ayuda ya está traducido?
La primera sincronización mantiene las traducciones que ya están en Zendesk. Para cada elemento y cada idioma, si Zendesk ya tiene una traducción completa, Lingo.dev la deja tal cual y traduce solo lo que falta. Si quieres sustituir una traducción existente, usa Retranslate.
Conecta tu centro de ayuda#
Abre la integración
Ve a Studio -> All integrations y haz clic en Connect en la tarjeta de Zendesk.
Rellena el formulario
| Campo | Qué introducir |
|---|---|
| Nombre | Cómo llamar a esta conexión para distinguir tus Centros de ayuda |
| Centro de ayuda | Solo el subdominio de tu URL de Zendesk. Para https://acme.zendesk.com, introduce acme; el formulario muestra .zendesk.com a continuación |
| Motor | El motor de localización cuyo glosario, reglas y voz de marca siguen estas traducciones |
| Modo | Draft guarda las traducciones como borradores sin publicar; Publish las publica en cuanto se escriben. Consulta Borradores y publicadas más abajo |
Haz clic en Continue to Zendesk.
Autoriza en Zendesk
Zendesk te pedirá que concedas acceso a Lingo.dev. Haz clic en Allow. No se crea nada hasta que lo hagas: si haces clic en Deny, volverás al formulario sin que se haya creado ninguna conexión.
Elige los idiomas
De vuelta en Lingo.dev, verás los idiomas que tu Centro de ayuda tiene activados, excepto su idioma predeterminado. Todos aparecen preseleccionados. Desmarca los que no quieras y luego haz clic en Save and open.
Si el Centro de ayuda solo tiene un idioma, Lingo.dev te pedirá que primero añadas otro en Zendesk.
Elige qué se traduce#
La página de conexión tiene cinco pestañas: Categories, Sections, Articles, Workflow runs y Settings.
Las tres primeras muestran el contenido de ese tipo, una fila por elemento, con un cuadro de búsqueda para nombres e ID. El nombre de cada fila enlaza con ese elemento en Zendesk, para que puedas comprobar qué estás seleccionando. Cada fila tiene un interruptor Sync: actívalo y ese elemento pasará a formar parte de la conexión a partir de ese momento. El cambio se guarda en cuanto lo activas o desactivas; no hay ningún botón Guardar. El interruptor del encabezado de la tabla activa o desactiva Sync para todo lo que aparece en la lista.
Las casillas de verificación son para ejecuciones puntuales. Marca filas y aparecerán dos botones, Queue sync (N) y Queue retranslation (N), que ejecutan solo esas filas sin cambiar qué elementos tienen Sync activado.
Nada se propaga
Activar una categoría traduce su propio nombre y descripción, no las secciones y los artículos que contiene. Para cubrir una categoría completa, activa también sus artículos en la pestaña Articles. El interruptor del encabezado activa todo lo que aparece en la lista, y puedes desmarcar lo que no quieras.
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 traducirlo todo, haya cambiado o no | 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 en el encabezado de la página, donde afectan a todo lo que tenga Sync activado, y aparecen encima de la tabla cuando marcas filas, donde afectan solo a esas filas. Retranslate desde el encabezado te pide confirmación primero, porque se cobra por cada elemento seleccionado y cada idioma.
Las ejecuciones son manuales. Editar un artículo en Zendesk no inicia ninguna: tú decides cuándo traducir.
Solo puede haber una ejecución por conexión a la vez. Si solicitas otra mientras una está en curso, se pondrá en cola detrás; si la cola está llena, vuelve a intentarlo cuando termine una ejecución.
Sigue una ejecución#
La pestaña Workflow runs muestra todas las ejecuciones: cuándo empezaron, qué las desencadenó, qué idiomas cubrieron, cuánto tardaron y su estado. Una ejecución que sigue en curso tiene un botón Stop. Abre una fila para ver el resultado por idioma.
Una ejecución que termina como Up to date no es un fallo. Significa que no había cambiado nada desde la última ejecución, 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.
Borradores o contenido publicado#
En modo Draft, las traducciones llegan a Zendesk como borradores sin publicar. Nada será visible para quienes lean tu contenido hasta que alguien las revise y las publique en Zendesk. Este es el modo con el que conviene empezar cuando tu Centro de ayuda aún no tiene traducciones y estás evaluando la calidad.
En modo Publish, las traducciones se publican en cuanto se escriben.
¿Ya hay traducciones publicadas? Usa Publish
En modo Draft, una traducción que Lingo.dev escribe para un idioma que ya está publicado pasa a convertirse en un borrador de ese idioma, y quienes leen el contenido dejan de ver la versión publicada hasta que alguien la vuelva a publicar. Si tu Centro de ayuda ya ofrece traducciones, elige Publish.
Puedes cambiar el modo más adelante en la pestaña Settings, junto con tu motor y los idiomas de destino.
Configuración#
La pestaña Settings muestra de qué Centro de ayuda lee la conexión y cuánto contenido tiene la sincronización activada, y te permite cambiar el nombre, los idiomas de destino, el motor y el modo. Cada cambio se guarda al momento.
Si uno de los idiomas que elegiste ya no está activado en Zendesk, la pestaña te lo indicará. Las sincronizaciones omitirán ese idioma, y el siguiente cambio en la lista lo eliminará.
Desconectar#
Disconnect, al final de la pestaña Settings, hace que Lingo.dev deje de leer del Centro de ayuda y de escribir en él. Elimina 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 permanecen en Zendesk: pertenecen a tu Centro de ayuda, no a nosotros.
Reconectar
Al reconectar, se inicia un nuevo registro de lo que se ha traducido. La primera sincronización después de reconectar mantiene las traducciones que ya están en Zendesk, incluidas las que Lingo.dev escribió antes, y traduce solo lo que falta.
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; las solicitudes posteriores se ponen en cola detrás |
| Idiomas de destino | Deben estar activados en tu Centro de ayuda de Zendesk para que Lingo.dev pueda ofrecerlos |
| Conexiones | Varios Centros de ayuda por organización, cada uno conectado una sola vez |
Resolución de problemas#
La página Connect dice que Zendesk no está en tu plan. Zendesk está disponible con Enterprise. Ponte en contacto con nosotros y lo solucionaremos; mientras tanto, todo lo que ya esté conectado seguirá funcionando.
La página Connect dice que no puedes conectar esto. La conexión requiere un permiso que tu rol no tiene. Una persona administradora de la organización puede conectarlo o concederte ese permiso.
Falta un idioma de destino en la lista. Actívalo primero en Zendesk, en Knowledge -> Settings -> Language settings, y luego vuelve a abrir la pestaña Settings en Lingo.dev. La lista se lee de Zendesk cada vez.
Después de pulsar Allow, Lingo.dev te pide que añadas un idioma en Zendesk. El Centro de ayuda está escrito en un solo idioma y no ofrece ningún otro, así que todavía no hay ningún idioma al que traducir.
Una sincronización termina como Up to date. O bien no ha cambiado nada desde la última ejecución, o bien todavía no hay nada con Sync activado. Activa el contenido que quieras incluir en las pestañas Categories, Sections y Articles.
Las traducciones no aparecen en el Centro de ayuda. Comprueba si la conexión está en modo Draft. Los borradores existen en Zendesk, pero siguen siendo invisibles para quienes leen el contenido hasta que se publican.