Connectez votre centre d’aide Zendesk à un moteur de localisation. Choisissez les catégories, sections et articles à inclure, et Lingo.dev les traduit dans vos langues cibles puis réinjecte les traductions dans Zendesk.
Compatible avec le contenu Zendesk Guide (Centre d’aide) : catégories, sections et articles.
L’intégration Zendesk s’active au niveau de l’organisation. Si vous ne la voyez pas dans Paramètres -> Intégrations, contactez-nous et nous l’activerons pour vous.
Avant de commencer#
Vous avez besoin de trois éléments :
Un accès administrateur à Zendesk. La connexion passe par OAuth, et le compte qui autorise l’accès doit avoir les droits pour gérer le contenu du Centre d’aide.
Vos langues cibles doivent être activées dans Zendesk. Zendesk n’accepte une traduction que pour une langue que le Centre d’aide reconnaît déjà. Activez-les dans Zendesk, sous Knowledge -> Settings -> Language settings.
Les langues ajoutées sous Admin Center -> Account -> Appearance -> Localization figurent dans une liste distincte et n’activent PAS une langue du Centre d’aide.
Pour voir précisément quelles langues votre Centre d’aide accepte, ouvrez
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonen étant connecté·e en tant qu’administrateur·rice. Toutes les langues répertoriées à cette adresse sont celles que vous pouvez sélectionner dans Lingo.dev.Un moteur de localisation. Son glossaire, sa voix de marque et ses règles guideront les traductions de votre centre d’aide.
Les codes de langue doivent correspondre exactement à ceux de Zendesk
Zendesk utilise des codes comme en-us et de-de. Si la langue source de votre centre d’aide est indiquée comme en-us, choisissez English (United States) dans Lingo.dev, et non English : ce sont deux langues différentes (en-US vs en), et cette différence est de loin la cause la plus fréquente des échecs de connexion.
Connecter votre centre d’aide#
Ouvrir l’intégration
Accédez à Paramètres -> Intégrations et cliquez sur Connect sous Zendesk.
remplir le formulaire
| Champ | Valeur à saisir |
|---|---|
| Sous-domaine | Saisissez uniquement l’identifiant de votre URL Zendesk. Pour https://acme.zendesk.com, entrez acme — sans https://, sans .zendesk.com |
| Moteur | Le moteur de localisation qui traduira ce contenu |
| Langue source | La langue dans laquelle vos articles sont rédigés, exactement telle qu’elle apparaît dans Zendesk |
| Langues cibles | Les langues vers lesquelles traduire. Elles doivent toutes être activées dans Zendesk au préalable |
| Enregistrer comme brouillons | Laissez cette option activée pour enregistrer les traductions comme brouillons non publiés. Désactivez-la pour publier immédiatement |
Autoriser dans Zendesk
Vous êtes redirigé vers Zendesk. Cliquez sur Allow. Vous revenez ensuite sur la page Zendesk dans Lingo.dev avec la connexion activée.
Choisir ce qui est traduit#
La page Zendesk comporte deux onglets : Content et Runs.
L’onglet Content liste tout le contenu de votre centre d’aide — catégories, sections et articles dans un seul tableau. Utilisez les filtres au-dessus (All, Categories, Sections, Articles) pour affiner la liste, puis les cases à cocher pour choisir ce que vous voulez inclure. Le nom de chaque ligne renvoie vers l’élément correspondant dans Zendesk, pour vous permettre de vérifier ce que vous sélectionnez.
Sélectionner une catégorie ne sélectionne pas automatiquement son contenu
Les catégories, sections et articles se sélectionnent indépendamment. Si vous souhaitez traduire une catégorie entière, sélectionnez la catégorie et ses sections et articles.
Enregistrez avant de synchroniser. Une nouvelle connexion démarre avec un périmètre vide, et une synchronisation utilise le périmètre enregistré — pas ce qui est coché à l’écran à cet instant. Si vous lancez une synchronisation avant d’avoir enregistré quoi que ce soit, l’exécution reviendra avec rien à traduire. Cliquez sur Enregistrer, puis traduisez.
Contenu traduit#
| Élément | Champs traduits |
|---|---|
| Catégorie | Titre, description |
| Section | Titre, description |
| Article | Titre, corps |
Le corps des articles est traduit en HTML, ce qui permet de préserver la mise en forme, les liens et les médias intégrés tout au long du processus.
Synchroniser et retraduire#
Deux boutons, deux usages différents :
| Bouton | Action | Quand l’utiliser |
|---|---|---|
| Sync | Traduit uniquement ce qui a changé depuis la dernière exécution | Pour les mises à jour courantes. C’est généralement celui qu’il vous faut |
| Retranslate | Retraduit tout le périmètre depuis zéro | Après avoir modifié le glossaire, la voix de marque ou les règles de votre moteur, si vous voulez régénérer les traductions existantes |
Les deux sont disponibles à deux endroits : dans l’en-tête de la page, où ils couvrent l’ensemble de votre périmètre enregistré, et au-dessus du tableau de contenu, où ils ne couvrent que les lignes que vous avez sélectionnées.
Les exécutions sont manuelles. Modifier un article dans Zendesk n’en lance pas automatiquement une — c’est vous qui choisissez quand traduire.
Une seule exécution peut être en cours à la fois. Tant qu’une exécution est active, les deux boutons sont désactivés.
Suivre une exécution#
L’onglet Runs répertorie chaque exécution avec son statut, son déclencheur, son heure de démarrage et sa durée. Une exécution en cours peut être annulée directement depuis la liste.
Ouvrez une exécution pour en voir le détail : l’étape en cours — récupération du contenu depuis Zendesk, traduction, réécriture dans Zendesk — ainsi que l’avancement global et l’avancement par langue cible. Vous pouvez ainsi voir, par exemple, que l’allemand est terminé alors que le japonais est encore en cours.
Une exécution qui se termine avec rien à traduire n’est pas un échec. Cela signifie que tout ce qui se trouve dans le périmètre correspond déjà à ses traductions, ce qui est le résultat normal si vous synchronisez deux fois sans rien modifier entre les deux.
Où vont les traductions#
Chaque traduction est rattachée au même article, à la même section ou à la même catégorie sous forme de version par langue — c’est le modèle de traduction natif de Zendesk. Vos lecteurs changent de langue dans le Centre d’aide et y accèdent directement ; rien n’est dupliqué ni déplacé.
À qui les traductions sont attribuées
Dans Zendesk, chaque traduction est attribuée au compte qui a autorisé la connexion — pas à la personne qui a cliqué sur Synchroniser. Si vous préférez éviter que le nom d’un collaborateur apparaisse sur l’ensemble du Centre d’aide, utilisez un compte de service partagé pour connecter l’intégration.
Brouillons ou publiés#
Lorsque l’option Enregistrer comme brouillons est activée, les traductions arrivent dans Zendesk sous forme de brouillons non publiés. Rien n’est visible pour vos clients tant qu’une personne ne les relit pas et ne les publie pas dans Zendesk. C’est l’option sûre par défaut, et celle à conserver pendant que vous évaluez la qualité des traductions.
Désactivez-la et les traductions sont publiées dès qu’elles sont enregistrées.
Vous pourrez modifier ce réglage plus tard dans Paramètres -> Intégrations -> Zendesk, ainsi que votre moteur et vos langues cibles.
Déconnexion#
La déconnexion supprime la connexion, son historique d’exécutions et le suivi par article de ce qui a déjà été traduit. Les traductions déjà écrites restent dans Zendesk — elles appartiennent à votre Centre d’aide, pas à nous.
Se reconnecter, c’est repartir de zéro
Comme l’état de synchronisation par article a disparu, la première synchronisation après reconnexion considère tout votre périmètre comme nouveau et le retraduit intégralement — avec le coût que cela implique. Déconnectez-vous si vous voulez vraiment arrêter, pas pour résoudre un problème.
Limites#
| Limite | Détail |
|---|---|
| Types de contenu | Catégories, sections et articles. Les tickets, macros, thèmes et publications de la communauté ne sont pas pris en charge |
| blocs de contenu | Les articles créés à partir des blocs de contenu Zendesk ne sont pas traduits |
| Déclencheurs | Manuel uniquement — aucun webhook, aucune synchronisation automatique lorsqu’un article est modifié |
| Exécutions simultanées | Une par connexion |
| Langues cibles | Elles doivent être activées dans votre centre d’aide Zendesk avant qu’une exécution puisse y écrire |
Dépannage#
La connexion échoue juste après avoir cliqué sur Allow. Dans la plupart des cas, il s’agit d’un problème de langue : la langue source que vous avez sélectionnée n’existe pas dans le Centre d’aide. Ouvrez https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, notez le code exact qui y figure, puis reconnectez-vous avec celui-ci.
Une langue cible n’apparaît pas dans la liste déroulante. Activez-la d’abord dans Zendesk, sous Knowledge -> Settings -> Language settings, puis rouvrez la configuration dans Lingo.dev.
La synchronisation indique qu’il n’y a rien à traduire. Soit votre périmètre enregistré est vide — sélectionnez du contenu dans l’onglet Contenu et cliquez sur Enregistrer — soit tout ce qu’il contient est déjà à jour.
Les traductions n’apparaissent pas dans le centre d’aide. Vérifiez si la connexion est en mode brouillon. Les brouillons existent bien dans Zendesk, mais restent invisibles pour les clients tant qu’ils ne sont pas publiés.
