Centro de ayuda de Zendesk
Conecta tu Centro de ayuda de Zendesk a un motor de localización. Activa Sync para 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 esas traducciones a Zendesk.
Funciona con el contenido de Zendesk Guide (Centro de ayuda): categorías, secciones y artículos.
Zendesk está disponible con el plan Enterprise. Si en la página Connect aparece Zendesk is not on your plan, contáctanos y lo resolvemos.
Antes de empezar#
Necesitas tres cosas:
Acceso de administrador a Zendesk. La conexión usa OAuth, y la cuenta que autoriza necesita permisos para administrar el contenido del Centro de ayuda. Cada traducción que Lingo.dev escribe queda atribuida a esa cuenta en Zendesk, así que conéctate con una cuenta de servicio compartida si prefieres que no aparezca el nombre de una sola persona en todo el Centro de ayuda.
Tus idiomas de destino habilitados en Zendesk. Lingo.dev ofrece exactamente los idiomas que tu Centro de ayuda tiene habilitados, y ninguno más. 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. Lo que aparezca en ese endpoint es lo que Lingo.dev ofrecerá.Un motor de localización. Su glosario, voz de marca y reglas son los 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 conserva las traducciones que ya están en Zendesk. Para cada elemento e idioma, si Zendesk ya tiene una traducción completa, Lingo.dev la deja tal como está y traduce solo lo que falta. Si quieres reemplazar una traducción existente, usa Retraducir.
Conecta tu Centro de ayuda#
Abre la integración
Ve a Studio -> All integrations y haz clic en Connect en la tarjeta de Zendesk.
Completa el formulario
| Campo | Qué ingresar |
|---|---|
| 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, ingresa 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 la sección Borradores vs. Publicado más abajo |
Haz clic en Continue to Zendesk.
Autoriza en Zendesk
Zendesk te pide que le des acceso a Lingo.dev. Haz clic en Allow. No se crea nada hasta que lo hagas: si haces clic en Deny, vuelves al formulario sin que se cree ninguna conexión.
Elige los idiomas
De vuelta en Lingo.dev, verás los idiomas que tu Centro de ayuda tiene habilitados, excepto el idioma predeterminado. Todos aparecen preseleccionados. Desmarca los que no quieras y luego haz clic en Save and open.
Si el Centro de ayuda tiene un solo idioma, Lingo.dev te pedirá que primero agregues 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 primeras tres muestran el contenido de ese tipo, una fila por elemento, con un cuadro de búsqueda por nombre e ID. El nombre de cada fila enlaza a ese elemento en Zendesk, así que puedes revisar bien qué estás eligiendo. Cada fila tiene un interruptor de Sync: actívalo y ese elemento pasará a formar parte de la conexión desde ese momento. El cambio se guarda en cuanto activas o desactivas el interruptor; no hay botón Save. El interruptor del encabezado de la tabla activa o desactiva Sync para todo lo de 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é tiene Sync activado.
Nada se aplica en cascada
Activar una categoría traduce su nombre y descripción, pero no las secciones ni 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 |
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 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 abarcan todo lo que tiene Sync activado, y aparecen arriba de la tabla cuando marcas filas, donde abarcan solo esas filas. Si usas Retranslate desde el encabezado, primero te pedirá confirmación, porque se cobra por cada elemento seleccionado y por cada idioma.
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 a la vez por conexión. Si pides otra mientras una está en curso, quedará 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 cada ejecución: cuándo empezó, qué la activó, qué idiomas cubrió, cuánto tardó y su estado. Una ejecución que todavía está 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 error. Significa que nada cambió desde la última ejecución, que es el resultado normal de sincronizar dos veces sin editar nada en el medio.
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.
Borradores vs. publicados#
En modo Draft, las traducciones llegan a Zendesk como borradores sin publicar. Nada será visible para tus lectores hasta que alguien las revise y las publique en Zendesk. Este es el mejor modo para empezar si tu Centro de ayuda todavía no tiene traducciones y estás evaluando la calidad.
En modo Publish, las traducciones se publican en cuanto se escriben.
¿Ya tienes traducciones publicadas? Usa Publish
En modo Draft, una traducción que Lingo.dev escribe para un idioma que ya está publicado se convierte en un borrador de ese idioma, y los lectores 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 tus idiomas de destino.
Configuración#
La pestaña Configuración muestra qué Centro de ayuda lee esta conexión y cuánto contenido tiene Sync. También te permite cambiar el nombre, los idiomas de destino, el motor y el modo. Cada cambio se guarda en cuanto lo haces.
Si un idioma que elegiste ya no está habilitado en Zendesk, la pestaña te lo indicará. Las sincronizaciones omitirán ese idioma, y el próximo cambio en la lista lo quitará.
Desconectar#
Disconnect al final de la pestaña Settings hace que Lingo.dev deje de leer y escribir en el Centro de ayuda. 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: pertenecen a tu Centro de ayuda, no a nosotros.
Volver a conectar
Al volver a conectar, se inicia un nuevo registro de lo que se ha traducido. La primera sincronización después de reconectar conserva 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 quedan en cola detrás |
| Idiomas de destino | Deben estar habilitados en tu Centro de ayuda de Zendesk antes de que Lingo.dev pueda ofrecerlos |
| Conexiones | Varios Centros de ayuda por organización, cada uno conectado una sola vez |
Solución de problemas#
La página Connect dice que Zendesk no está en tu plan. Zendesk está disponible con Enterprise. Contáctanos y lo resolvemos; 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. Un administrador de la organización puede conectarlo o darte ese permiso.
Falta un idioma de destino en la lista. Primero habilítalo en Zendesk en Knowledge -> Settings -> Language settings y luego vuelve a abrir la pestaña Settings en Lingo.dev. La lista se lee desde Zendesk cada vez.
Después de Allow, Lingo.dev te pide que agregues 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 nada que traducir.
Una sincronización termina como Up to date. O no cambió nada desde la última ejecución, o 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. Revisa si la conexión está en modo Draft. Los borradores existen en Zendesk, pero siguen invisibles para los lectores hasta que se publiquen.