Centro de ayuda de Zendesk
Traduce las categorías, secciones y artículos del Centro de ayuda en sus versiones de idioma existentes, con control manual sobre 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 existentes de conexión y configuración siguen funcionando.
Las ejecuciones se inician manualmente. Cuando cambie un artículo, inicia la sincronización del contenido que quieras actualizar. Antes de guardar por primera vez, elige si las traducciones quedarán como borradores o se publicarán: guardar como borrador una versión de destino ya publicada puede dejarla fuera del alcance de los lectores 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 permita el acceso.
Usa una cuenta de administrador de Zendesk con acceso al contenido del Centro de ayuda. Se requiere acceso de administrador 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 permiso y el derecho de conexión para la organización, además de acceso al motor de localización seleccionado.
Habilita los idiomas de destino en la configuración de idiomas del Centro de ayuda. La lista de localización a nivel de cuenta de Zendesk es independiente y no habilita 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 usa como idioma de origen. El formulario de conexión no permite seleccionar un idioma de origen diferente.
Conecta y traduce tu primer artículo #
- Abre Configuración → Integraciones y selecciona Conectar para Zendesk. Ingresa un nombre y el subdominio del Centro de ayuda. Para
acme.zendesk.com, ingresaacme. - Continúa en Zendesk y autoriza el acceso. La conexión se crea solo cuando la autorización se completa correctamente.
- En Studio, selecciona el Centro de ayuda en Conectados y luego selecciona Configurar.
- Elige un motor de localización y un modo de escritura, y luego selecciona Continuar. Para esta primera ejecución, selecciona un idioma de destino entre los habilitados en el Centro de ayuda. El idioma de origen queda excluido; si no hay otro disponible, primero habilita uno en Zendesk.
- Abre Artículos y activa el interruptor Sincronizar de un artículo cuyo texto de origen sea estable. Espera a que se guarde la configuración, marca la casilla de la fila de ese artículo y elige Poner sincronización en cola.
- Revisa el resultado del flujo de trabajo y el artículo de destino tal como quedó en Zendesk. Verifica el título, el cuerpo, los enlaces, el idioma y si está como borrador o publicado. Si debe estar publicado, abre también la URL que ven los lectores.
La primera sincronización adopta las traducciones existentes que estén completas sin sobrescribirlas y conserva tanto el texto como el estado de borrador. Traduce el contenido faltante. Usa Volver a traducir cuando quieras reemplazar una traducción existente de forma deliberada.
Selecciona toda el área que quieras traducir #
Las categorías, secciones y artículos tienen tablas independientes e interruptores Sincronizar que conservan su configuración. Habilitar una categoría traduce su nombre y descripción, pero no habilita sus secciones ni 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 Poner sincronización en cola o Poner retraducción en cola a los elementos cuyos interruptores Sincronizar ya están activados. Marcar una fila no activa su interruptor permanente. Las acciones del encabezado abarcan todos los elementos habilitados de la conexión. Verifica 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 verifica también si existe la página de destino traducida. Los enlaces externos y la navegación propia del sitio deben verificarse 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 es una conexión para clasificar tickets de soporte.
Actualiza el contenido modificado o reemplázalo #
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 faltante y el trabajo que quedó incompleto en una ejecución anterior.
Volver a traducir regenera los elementos e idiomas seleccionados aunque el texto de origen no haya cambiado. Puede reemplazar ediciones humanas ya aceptadas. La acción general del encabezado solicita confirmación; las acciones sobre las filas seleccionadas también requieren que elijas qué contenido quieres reemplazar.
Solo puede haber una ejecución activa por conexión. Las solicitudes adicionales se ponen en cola y, si la cola está llena, debes esperar a que haya capacidad disponible. Ejecuciones de flujo de trabajo muestra los resultados; Detener cancela el trabajo que aún se puede detener. Un resultado que indica que todo está actualizado significa que ninguno de los cambios seleccionados necesitaba procesarse, no que se haya realizado una nueva evaluación de la calidad de la traducción.
Verifica lo que pueden ver los lectores #
El modo Publicar guarda las traducciones como versiones 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 hacer que la versión publicada deje de estar disponible hasta que alguien la vuelva a publicar. Antes de iniciar la actualización, decide si esa interrupción es aceptable para el lanzamiento.
Después de guardar, revisa la URL de destino en el idioma previsto. Compara el título y el cuerpo tal como quedaron con la revisió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, se vuelve a leer el elemento de origen. Si cambió o se eliminó después de la planificación, Lingo.dev omite el destino. Ejecuta otra sincronización manual cuando el contenido de origen esté listo para conciliar el nuevo estado.
Un error en un idioma no deshace los cambios guardados correctamente en otros. Revisa los elementos guardados, omitidos y fallidos, y luego vuelve a intentar la operación sobre los elementos e idiomas afectados. Forzar el procesamiento de todo el Centro de ayuda puede reemplazar texto ya aceptado sin corregir la causa original.
Si falta contenido en el resultado, revisa la selección de elementos, los idiomas habilitados del Centro de ayuda, el acceso al motor de localización, el modo de escritura, las exclusiones de bloques de contenido y si cambió el contenido de origen. Al adoptar una traducción existente completa, no se genera texto nuevo de forma intencional. Si se deshabilitó 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 el servicio se restablezca. Usa Volver a conectar en la conexión existente si necesitas restaurar la autorización; desconectarla y crear una 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 restaurar 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. Si después creas una nueva conexión, se establece una nueva base de referencia: su primera sincronización conserva las traducciones completas que ya existen y completa el contenido faltante. Revoca la autorización del proveedor por separado cuando deba finalizar el acceso. Cuando sea necesario, restaura directamente en Zendesk el texto publicado anteriormente.
Recopila actividad en Radar #
La conexión también envía a Radar la actividad del Centro de ayuda. Recopilar traducciones para medición describe cómo configurar los eventos e importar el historial del proveedor antes de ejecutar una medición histórica.
Si la traducción manual funciona, pero no aparece la nueva actividad de los artículos, revisa el registro del webhook de la conexión y la entrega de sus eventos. La autorización puede completarse correctamente aunque una cuenta que no sea de administrador no pueda registrar el webhook. En Configuración → Integraciones, usa Volver a conectar en la conexión existente de Zendesk y autoriza el acceso como administrador. Publica un artículo de prueba y verifica su evento en Radar antes de depender de la recopilación automática.