Centro de ayuda de Zendesk
Traduce las categorías, secciones y artículos del centro de ayuda en sus versiones de idioma existentes y controla manualmente la sincronización y la publicación.
Traduce el contenido del centro de ayuda sin salir de Zendesk. La conexión de Lingo.dev lee las categorías, secciones y artículos seleccionados en el idioma predeterminado del centro de ayuda, los traduce con un motor de localización y guarda las versiones en los idiomas de destino en esos mismos elementos.
En el menú de navegación de Studio 2.5, abre Studio 2.5 → Integraciones en lugar de Configuración → Integraciones. Los enlaces de conexión y configuración que ya tenías siguen funcionando.
Las ejecuciones se inician manualmente. Cuando cambie un artículo, inicia la sincronización del contenido que quieras actualizar. Antes de guardar las primeras traducciones, elige si deben quedar como borradores o publicarse: guardar como borrador una versión de destino ya publicada puede dejarla fuera del alcance del público hasta que se vuelva a publicar.
Prepara el acceso y los idiomas del centro de ayuda #
La integración con el centro de ayuda de Zendesk está disponible con el plan Enterprise. Consulta los precios para conocer la disponibilidad actual. En Configuración → Integraciones aparece No disponible en tu plan junto a Zendesk cuando la organización necesita un plan que dé acceso a la integración.
Usa una cuenta de Zendesk con permisos de administración y acceso al contenido del centro de ayuda. Estos permisos son necesarios para registrar el webhook de publicación de artículos que recopila actividad para Radar. Los cambios guardados se atribuyen a la cuenta que autoriza el acceso, así que usa una cuenta de servicio adecuada si el equipo necesita una atribución compartida. En Lingo.dev, necesitas permisos para la organización y acceso habilitado para establecer la conexión, además de acceso al motor de localización seleccionado.
Activa los idiomas de destino en la configuración de idiomas del centro de ayuda. La lista de localización general de la cuenta de Zendesk es independiente y no activa las traducciones del centro de ayuda. Con la autorización adecuada, el punto de acceso de solo lectura https://<subdomain>.zendesk.com/api/v2/help_center/locales.json muestra la configuración de idiomas del centro de ayuda.
Lingo.dev lee el idioma predeterminado del centro de ayuda en cada ejecución y lo utiliza como idioma de origen. El formulario de conexión no permite seleccionar otro idioma de origen.
Conecta y traduce tu primer artículo #
- Abre Configuración → Integraciones y selecciona Conectar junto a Zendesk. Introduce un nombre y el subdominio del centro de ayuda. Para
acme.zendesk.com, introduceacme. - Continúa en Zendesk y autoriza el acceso. La conexión solo se crea cuando la autorización se completa correctamente.
- En Studio, selecciona el centro de ayuda en Conectado y, después, selecciona Configurar.
- Elige un motor de localización y un modo de guardado y, después, selecciona Continuar. Para esta primera ejecución, selecciona un idioma de destino de entre los activados en el centro de ayuda. El idioma de origen queda excluido; si no hay otro disponible, activa primero uno en Zendesk.
- Abre Artículos y activa el interruptor Sincronización de un artículo cuyo texto de origen sea estable. Espera a que se guarde el ajuste, marca la casilla de la fila de ese artículo y elige Añadir sincronización a la cola.
- Revisa el resultado del flujo de trabajo y el artículo de destino tal como ha quedado en Zendesk. Comprueba el título, el cuerpo, los enlaces, el idioma y si está en borrador o publicado. Si debe estar publicado, abre también su URL pública.
La primera sincronización aprovecha las traducciones completas que ya existen sin sobrescribirlas y conserva tanto el texto como el estado de borrador. Traduce el contenido que falta. Usa Volver a traducir cuando quieras sustituir expresamente una traducción existente.
Selecciona toda el área que quieras traducir #
Las categorías, secciones y artículos tienen tablas independientes e interruptores Sincronización cuyo estado se conserva. Activar una categoría traduce su nombre y descripción, pero no activa sus secciones ni sus artículos. Selecciónalos por separado al preparar un área completa del centro de ayuda.
| Elemento | Campos traducidos |
|---|---|
| Categoría | Nombre/título y descripción |
| Sección | Nombre/título y descripción |
| Artículo | Título y cuerpo |
Las casillas de las filas limitan las acciones puntuales Añadir sincronización a la cola o Añadir retraducción a la cola a los elementos cuyos interruptores Sincronización ya están activados. Marcar una fila no activa su interruptor permanente. Las acciones de la cabecera abarcan todos los elementos activados de la conexión. Comprueba qué selección procesará la acción antes de iniciarla.
El cuerpo de los artículos se procesa como HTML para reconstruir el formato, los enlaces y el contenido multimedia incrustado. Al guardar las traducciones, se pueden adaptar los enlaces reconocidos del centro de ayuda al idioma de destino. Revisa esos enlaces en el resultado y comprueba también si existe la página de destino traducida. Los enlaces externos y la navegación propia del sitio siguen necesitando comprobaciones por separado.
Esta conexión no traduce tickets, macros, temas, publicaciones de la comunidad ni artículos basados en bloques de contenido de Zendesk. Localiza el contenido del centro de ayuda; no sirve para clasificar tickets de soporte.
Actualiza el contenido modificado o sustitúyelo #
Sincronizar compara el contenido de origen actual con el estado registrado y las traducciones existentes. Úsalo para las actualizaciones habituales del contenido de origen, el contenido que falta y el trabajo que haya quedado incompleto en una ejecución anterior.
Volver a traducir regenera los elementos e idiomas seleccionados aunque el texto de origen no haya cambiado. Puede sustituir cambios hechos por personas y ya aceptados. La acción general de la cabecera pide confirmación; las acciones sobre las filas seleccionadas también requieren que elijas qué elementos e idiomas quieres sustituir.
Solo puede haber una ejecución activa por conexión. Las solicitudes adicionales se añaden a la cola y, si está llena, hay que esperar a que quede espacio. Ejecuciones del flujo de trabajo muestra los resultados; Detener cancela el trabajo que aún se puede detener. Un resultado marcado como actualizado significa que no había cambios seleccionados que procesar, no que se haya vuelto a evaluar la calidad de la traducción.
Comprueba qué contenido puede ver el público #
El modo Publicar guarda las traducciones como publicadas. El modo Borrador guarda versiones de idioma sin publicar para su revisión en Zendesk. Al actualizar una versión de idioma ya publicada en modo Borrador, el nuevo borrador puede dejar esa versión fuera del alcance del público hasta que alguien vuelva a publicarla. Decide si esa interrupción encaja con el lanzamiento antes de iniciar la actualización.
Una vez guardada la traducción, revisa la URL de destino en el idioma previsto. Compara el título y el cuerpo que aparecen con la versión del contenido de origen, sigue los enlaces y busca fragmentos en el idioma de origen. Completar una ejecución de traducción es solo una parte del lanzamiento; la aceptación y la publicación siguen siendo decisiones editoriales.
Recupera los cambios del contenido de origen y los resultados parciales #
Antes de guardar la traducción, se vuelve a leer el elemento de origen. Si ha cambiado o se ha eliminado después de la planificación, Lingo.dev omite el destino. Ejecuta otra sincronización manual cuando el contenido de origen esté listo para ajustar las traducciones al nuevo estado.
Un fallo en un idioma no deshace las traducciones guardadas correctamente en otros. Revisa los elementos guardados, omitidos y fallidos y, después, vuelve a intentar procesar los afectados. Forzar el procesamiento de todo el centro de ayuda puede sustituir texto ya aceptado sin resolver la causa original.
Si falta contenido en el resultado, comprueba la selección de elementos, los idiomas activados en el centro de ayuda, el acceso al motor de localización, el modo de guardado, las exclusiones de bloques de contenido y si ha cambiado el contenido de origen. Aprovechar una traducción completa existente no genera texto nuevo: es el comportamiento previsto. Si se ha desactivado un idioma de destino en Zendesk, las ejecuciones lo omiten; actualiza la selección de idiomas de destino de la conexión.
Si Zendesk sufre una interrupción temporal, vuelve a intentarlo cuando se restablezca el servicio. Usa Volver a conectar en la conexión existente si necesitas restablecer la autorización; desconectar y crear una conexión nueva elimina el estado de sincronización.
Desconecta o vuelve a conectar #
Cambia los idiomas de destino, el motor de localización y el modo en la pestaña Configuración del centro de ayuda en Studio. Cambia el nombre de la cuenta o vuelve a conectarla en Configuración → Integraciones. Usa Volver a conectar para restablecer la autorización de la conexión existente.
Al desconectar, se detienen las lecturas y escrituras y se eliminan la conexión local, el historial de ejecuciones y el registro de sincronización de cada elemento. Las traducciones existentes en Zendesk se conservan. Crear una conexión nueva después establece un nuevo punto de partida: su primera sincronización conserva las traducciones completas que ya existen y traduce el contenido que falta. Revoca por separado la autorización del proveedor cuando deba finalizar el acceso. Si lo necesitas, restaura directamente en Zendesk el texto publicado anteriormente.
Recopila actividad en Radar #
La conexión también envía la actividad del centro de ayuda a Radar. Recopilar traducciones para su medición explica cómo configurar los eventos y cómo importar el historial del proveedor antes de ejecutar una medición histórica.
Si la traducción manual funciona pero no aparece nueva actividad de los artículos, comprueba el registro del webhook de la conexión y la entrega de eventos. La autorización puede completarse correctamente aunque una cuenta sin permisos de administración no pueda registrar el webhook. En Configuración → Integraciones, usa Volver a conectar en la conexión existente de Zendesk y autoriza el acceso con una cuenta con permisos de administración. Publica un artículo de prueba y comprueba su evento en Radar antes de confiar en la recopilación automática.