Centre d’aide Zendesk
Traduisez les catégories, sections et articles du Centre d’aide dans leurs versions linguistiques existantes, tout en gardant le contrôle manuel de la synchronisation et de la publication.
Traduisez le contenu du Centre d’aide sans quitter Zendesk. La connexion Lingo.dev lit les catégories, sections et articles sélectionnés dans la langue par défaut du Centre d’aide, les traduit à l’aide d’un moteur de localisation et enregistre les versions dans les langues cibles sur ces mêmes éléments.
Dans le menu de navigation de Studio 2.5, ouvrez Studio 2.5 → Intégrations plutôt que Paramètres → Intégrations. Les liens de connexion et de configuration existants restent accessibles.
Les exécutions sont manuelles. Après la modification d’un article, lancez la synchronisation du contenu à mettre à jour. Avant le premier enregistrement, choisissez si les traductions doivent rester en brouillon ou être publiées : enregistrer en brouillon une version cible déjà publiée peut la rendre inaccessible aux lecteurs jusqu’à sa republication.
Préparer les accès et les langues du Centre d’aide #
L’intégration du Centre d’aide Zendesk est disponible avec le forfait Enterprise. Consultez les tarifs pour connaître la disponibilité actuelle. Dans Paramètres → Intégrations, la mention Non disponible avec votre forfait apparaît à côté de Zendesk lorsque l’organisation doit disposer d’un forfait donnant accès à cette intégration.
Utilisez un compte administrateur Zendesk ayant accès au contenu du Centre d’aide. Les droits d’administration sont nécessaires pour enregistrer le webhook de publication d’articles qui collecte l’activité pour Radar. Les écritures sont attribuées au compte qui autorise l’accès ; utilisez donc un compte de service adapté si l’équipe souhaite une attribution commune. Dans Lingo.dev, vous devez disposer des autorisations nécessaires et du droit d’utiliser la connexion pour l’organisation, ainsi que de l’accès au moteur de localisation sélectionné.
Activez les langues cibles dans les paramètres de langue du Centre d’aide. La liste de localisation à l’échelle du compte Zendesk est distincte et n’active pas les traductions du Centre d’aide. Avec les autorisations appropriées, le point de terminaison en lecture seule https://<subdomain>.zendesk.com/api/v2/help_center/locales.json permet de consulter la configuration des langues du Centre d’aide.
Lingo.dev lit la langue par défaut du Centre d’aide à chaque exécution et l’utilise comme langue source. Le formulaire de connexion ne permet pas de choisir une autre langue source.
Connecter le Centre d’aide et traduire un premier article #
- Ouvrez Paramètres → Intégrations et sélectionnez Connecter pour Zendesk. Saisissez un nom et le sous-domaine du Centre d’aide. Pour
acme.zendesk.com, saisissezacme. - Continuez vers Zendesk et autorisez l’accès. La connexion n’est créée qu’une fois l’autorisation accordée.
- Dans Studio, sélectionnez le Centre d’aide sous Connecté, puis choisissez Configurer.
- Choisissez un moteur de localisation et un mode d’écriture dans Zendesk, puis sélectionnez Continuer. Pour cette première exécution, choisissez une langue cible parmi celles activées dans le Centre d’aide. La langue source est exclue ; si aucune autre langue n’est disponible, activez-en d’abord une dans Zendesk.
- Ouvrez Articles et activez l’interrupteur Synchronisation pour un article dont le texte source est stable. Attendez que le paramètre soit enregistré, cochez la case de la ligne de cet article, puis choisissez Mettre la synchronisation en file d’attente.
- Examinez le résultat du workflow et l’article cible tel qu’il apparaît dans Zendesk. Vérifiez son titre, son corps, ses liens, sa langue et son état : brouillon ou publié. S’il doit être publié, ouvrez également son URL destinée aux lecteurs.
La première synchronisation reprend les traductions existantes complètes sans les écraser, en conservant leur texte et leur état de brouillon. Elle traduit le contenu manquant. Utilisez Retraduire lorsque vous souhaitez délibérément remplacer une traduction existante.
Sélectionner toute la partie du Centre d’aide à traduire #
Les catégories, sections et articles disposent de tableaux distincts et d’interrupteurs Synchronisation dont l’état est conservé. Activer une catégorie traduit son nom et sa description, mais n’active pas ses sections ni ses articles. Sélectionnez-les séparément pour préparer la traduction d’une partie complète du Centre d’aide.
| Élément | Champs traduits |
|---|---|
| Catégorie | Nom/titre et description |
| Section | Nom/titre et description |
| Article | Titre et corps |
Les cases à cocher des lignes limitent les opérations ponctuelles Mettre la synchronisation en file d’attente ou Mettre la retraduction en file d’attente aux éléments dont les interrupteurs Synchronisation sont déjà activés. Cocher une ligne n’active pas son interrupteur permanent. Les actions de l’en-tête s’appliquent à l’ensemble des éléments activés dans la connexion. Vérifiez la sélection que l’action traitera avant de la lancer.
Le corps des articles est traité en HTML pour reconstituer la mise en forme, les liens et les médias intégrés. Lors de l’écriture dans Zendesk, les liens reconnus du Centre d’aide peuvent être adaptés à la langue cible. Vérifiez ces liens dans le résultat, notamment pour vous assurer que la destination traduite existe. Les liens externes et la navigation propre au site doivent toujours être vérifiés séparément.
Cette connexion ne traduit pas les tickets, les macros, les thèmes, les publications de la communauté ni les articles reposant sur des blocs de contenu Zendesk. Elle localise le contenu du Centre d’aide ; elle ne sert pas au tri des tickets d’assistance.
Mettre à jour le contenu modifié ou le remplacer #
Synchronisation compare la source actuelle à l’état enregistré et aux traductions existantes. Utilisez cette action pour les mises à jour courantes de la source, le contenu manquant et les travaux laissés inachevés lors d’une exécution précédente.
Retraduire régénère les éléments et les langues sélectionnés, même si le texte source n’a pas changé. Cette action peut remplacer des modifications humaines déjà acceptées. L’action globale de l’en-tête demande une confirmation ; pour les actions sur les lignes sélectionnées, vous devez également choisir le périmètre de remplacement souhaité.
Une seule exécution peut être active par connexion. Les demandes supplémentaires sont mises en file d’attente ; si celle-ci est pleine, il faut attendre qu’une place se libère. Exécutions de workflow affiche les résultats ; Arrêter annule les travaux qui peuvent encore être interrompus. Un résultat indiquant que le contenu est à jour signifie qu’aucune modification sélectionnée ne nécessitait de traitement, et non que la qualité de la traduction a été réévaluée.
Vérifier ce que les lecteurs peuvent voir #
Le mode Publier enregistre les traductions et les rend accessibles aux lecteurs. Le mode Brouillon enregistre des versions linguistiques non publiées pour relecture dans Zendesk. Si vous mettez à jour une version linguistique déjà publiée en mode Brouillon, le nouveau brouillon peut la rendre inaccessible jusqu’à ce que quelqu’un la republie. Avant de lancer la mise à jour, déterminez si cette interruption est compatible avec la mise en ligne prévue.
Après l’enregistrement, vérifiez l’URL cible dans la langue prévue. Comparez le titre et le corps de l’article à la version source, suivez les liens et recherchez les fragments restés dans la langue source. Une exécution de traduction terminée n’est qu’une étape de la mise en ligne ; l’acceptation et la publication restent des décisions éditoriales.
Gérer les modifications de la source et les résultats partiels #
L’étape d’écriture dans Zendesk relit l’élément source. S’il a été modifié ou supprimé après la planification, Lingo.dev ignore la cible. Une fois la source prête, lancez une nouvelle synchronisation manuelle pour prendre en compte le nouvel état.
Un échec pour une langue n’annule pas les écritures réussies ailleurs. Examinez les éléments enregistrés, ignorés et en échec, puis réessayez sur le périmètre concerné. Forcer le traitement de tout le Centre d’aide peut remplacer du texte déjà accepté sans corriger la cause initiale.
Si du contenu manque dans le résultat, vérifiez la sélection des éléments, les langues activées dans le Centre d’aide, l’accès au moteur de localisation, le mode d’écriture dans Zendesk, les exclusions liées aux blocs de contenu et les éventuelles modifications de la source. La reprise d’une traduction existante complète ne produit volontairement aucun nouveau texte. Si une langue cible a été désactivée dans Zendesk, les exécutions l’ignorent ; actualisez la sélection des langues cibles de la connexion.
En cas d’indisponibilité temporaire de Zendesk, réessayez une fois le service rétabli. Utilisez Reconnecter sur la connexion existante si l’autorisation doit être rétablie ; déconnecter puis créer une nouvelle connexion supprime l’état de synchronisation.
Déconnecter ou reconnecter #
Modifiez les langues cibles, le moteur de localisation et le mode dans l’onglet Paramètres du Centre d’aide dans Studio. Renommez ou reconnectez le compte dans Paramètres → Intégrations. Utilisez Reconnecter pour rétablir l’autorisation sur la connexion existante.
La déconnexion arrête les lectures et les écritures et supprime la connexion locale, l’historique des exécutions et les données de synchronisation de chaque élément. Les traductions existantes dans Zendesk sont conservées. Créer ensuite une nouvelle connexion établit un nouvel état de référence : sa première synchronisation conserve les traductions complètes déjà présentes et traduit le contenu manquant. Révoquez séparément l’autorisation auprès du fournisseur lorsque l’accès doit prendre fin. Au besoin, restaurez directement dans Zendesk le texte publié précédemment.
Collecter l’activité dans Radar #
La connexion transmet également l’activité du Centre d’aide à Radar. Collecter les traductions pour les mesures décrit la configuration des événements et explique comment importer l’historique du fournisseur avant d’exécuter une mesure historique.
Si la traduction manuelle fonctionne mais que les nouvelles activités liées aux articles n’apparaissent pas, vérifiez l’enregistrement du webhook de la connexion et la bonne transmission de ses événements. L’autorisation peut réussir même si un compte non administrateur ne peut pas enregistrer le webhook. Dans Paramètres → Intégrations, utilisez Reconnecter sur la connexion Zendesk existante et autorisez l’accès avec un compte administrateur. Publiez un article de test et vérifiez que son événement apparaît dans Radar avant de vous fier à la collecte automatique.