Centre d’aide Zendesk
Connectez votre centre d’aide Zendesk à un moteur de localisation. Activez la synchronisation pour les catégories, sections et articles que vous souhaitez couvrir, et Lingo.dev les traduit dans les langues de votre centre d’aide, puis renvoie les traductions dans Zendesk.
Compatible avec le contenu Zendesk Guide (Centre d’aide) : catégories, sections et articles.
Zendesk est disponible avec Enterprise. Si la page Connect affiche Zendesk n’est pas inclus dans votre offre, contactez-nous et nous réglerons ça.
Avant de commencer#
Vous avez besoin de trois éléments :
Accès administrateur à Zendesk. La connexion passe par OAuth, et le compte qui l’autorise doit avoir les droits pour gérer le contenu du centre d’aide. Chaque traduction que Lingo.dev écrit est attribuée à ce compte dans Zendesk. Si vous préférez éviter que le nom d’un membre de l’équipe apparaisse sur l’ensemble du centre d’aide, connectez-vous avec un compte de service partagé.
Vos langues cibles activées dans Zendesk. Lingo.dev propose exactement les langues activées dans votre centre d’aide, et rien d’autre. 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 exactement ce que votre centre d’aide accepte, ouvrez
https://<subdomain>.zendesk.com/api/v2/help_center/locales.jsonen étant connecté en tant qu’administrateur. Tout ce que ce point de terminaison liste est ce que Lingo.dev proposera.Un moteur de localisation. Son glossaire, sa voix de marque et ses règles guideront les traductions de votre centre d’aide.
La langue source ne se choisit pas : Lingo.dev lit la langue par défaut de votre centre d’aide dans Zendesk à chaque exécution.
Help Center déjà traduit ?
La première synchronisation conserve les traductions déjà présentes dans Zendesk. Pour chaque élément et chaque langue, si Zendesk contient déjà une traduction complète, Lingo.dev la laisse telle quelle et ne traduit que ce qui manque. Pour remplacer une traduction existante, utilisez Retraduire.
Connecter votre centre d’aide#
Ouvrir l’intégration
Allez dans Studio -> All integrations et cliquez sur Connect sur la carte Zendesk.
remplir le formulaire
| Champ | Valeur à saisir |
|---|---|
| Nom | Nom à donner à cette connexion pour distinguer facilement vos Help Centers |
| Centre d’aide | Saisissez uniquement le sous-domaine de votre URL Zendesk. Pour https://acme.zendesk.com, entrez acme — le formulaire affichera ensuite .zendesk.com |
| Moteur | Le moteur de localisation dont ces traductions suivent le glossaire, les règles et la voix de marque |
| Mode | Draft enregistre les traductions comme brouillons non publiés, Publish les met en ligne dès qu’elles sont écrites. Voir Brouillons vs Publié ci-dessous |
Cliquez sur Continue to Zendesk.
Autoriser dans Zendesk
Zendesk vous demande d’autoriser Lingo.dev à y accéder. Cliquez sur Allow. Rien n’est créé tant que vous ne l’avez pas fait : cliquez sur Deny et vous revenez au formulaire sans qu’aucune connexion ne soit établie.
Choisissez les langues
De retour sur Lingo.dev, vous voyez les langues activées dans votre centre d’aide, à l’exception de la langue par défaut. Elles sont toutes présélectionnées. Décochez celles que vous ne voulez pas, puis cliquez sur Save and open.
Si le centre d’aide n’a qu’une seule langue, Lingo.dev vous demandera d’en ajouter une d’abord dans Zendesk.
Choisir ce qui est traduit#
La page de connexion comporte cinq onglets : Categories, Sections, Articles, Workflow runs et Settings.
Les trois premiers listent le contenu correspondant, à raison d’une ligne par élément, avec un champ de recherche pour les noms et les ID. Le nom de chaque ligne renvoie vers l’élément dans Zendesk, afin que vous puissiez vérifier ce que vous sélectionnez. Chaque ligne comporte un interrupteur Sync : activez-le et cet élément fera désormais partie de la connexion. La modification est enregistrée dès que vous basculez l’interrupteur — il n’y a pas de bouton Save. L’interrupteur dans l’en-tête du tableau active ou désactive Sync pour tous les éléments de la liste.
Les cases à cocher servent aux exécutions ponctuelles. Cochez des lignes et deux boutons apparaissent, Queue sync (N) et Queue retranslation (N), pour lancer uniquement ces lignes sans modifier les éléments dont Sync est activé.
Rien ne se propage automatiquement
Activer une catégorie traduit son nom et sa description, pas les sections et articles qu’elle contient. Pour couvrir toute une catégorie, activez aussi ses articles dans l’onglet Articles. L’interrupteur d’en-tête active tous les éléments affichés, et vous pouvez décocher ceux que vous ne voulez pas.
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, qu’il y ait eu des changements ou non | 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 |
Ces deux actions apparaissent dans l’en-tête de la page, où elles s’appliquent à tout ce qui a la synchronisation activée, et au-dessus du tableau lorsque vous cochez des lignes, où elles ne s’appliquent qu’à ces lignes. Lancer une retraduction depuis l’en-tête vous demande d’abord une confirmation, car chaque élément sélectionné et chaque langue sont facturés.
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 à la fois par connexion. Si vous en lancez une autre pendant qu’une exécution est en cours, elle sera mise en file d’attente derrière ; si la file est pleine, réessayez une fois l’exécution terminée.
Suivre une exécution#
L’onglet Workflow runs répertorie chaque exécution : son heure de démarrage, son déclencheur, les langues couvertes, sa durée et son statut. Une exécution encore en cours affiche un bouton Stop. Ouvrez une ligne pour voir le résultat par langue.
Une exécution qui se termine avec le statut Up to date n’est pas un échec. Cela signifie que rien n’a changé depuis la dernière exécution — c’est le résultat normal si vous synchronisez deux fois sans rien modifier entre-temps.
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é.
Brouillons ou publiés#
En mode Draft, les traductions arrivent dans Zendesk sous forme de brouillons non publiés. Rien n’est visible pour vos lecteurs tant que quelqu’un ne les a pas relues et publiées dans Zendesk. C’est le mode idéal pour démarrer si votre centre d’aide n’a pas encore de traductions et que vous êtes en train d’en évaluer la qualité.
En mode Publish, les traductions sont mises en ligne dès qu’elles sont écrites.
Des traductions déjà publiées ? Utilisez Publish
En mode Draft, une traduction que Lingo.dev écrit pour une langue déjà publiée devient un brouillon pour cette langue, et les lecteurs perdent la version en ligne jusqu’à ce que quelqu’un la republie. Si votre centre d’aide propose déjà des traductions, choisissez Publish.
Vous pourrez modifier le mode plus tard dans l’onglet Settings, ainsi que votre moteur et vos langues cibles.
Settings#
L’onglet Paramètres indique quel Help Center la connexion lit, combien de contenu est synchronisé, et vous permet de modifier le nom, les langues cibles, le moteur et le mode. Chaque modification est enregistrée automatiquement au fur et à mesure.
Si une langue que vous avez sélectionnée n’est plus activée dans Zendesk, l’onglet l’indique. Les synchronisations ignorent cette langue, et la prochaine modification de la liste la retirera.
Déconnexion#
Disconnect en bas de l’onglet Settings empêche Lingo.dev de lire et d’écrire dans le centre d’aide. Cela supprime la connexion, son historique d’exécutions et l’état 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.
Reconnexion
La reconnexion lance un nouvel historique des traductions. La première synchronisation après la reconnexion conserve les traductions déjà présentes dans Zendesk, y compris celles que Lingo.dev a déjà rédigées, et ne traduit que ce qui manque.
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 ; les demandes suivantes sont mises en file d’attente derrière |
| Langues cibles | Doivent être activées dans votre centre d’aide Zendesk avant que Lingo.dev puisse les proposer |
| Connexions | Plusieurs Help Centers par organisation, chacun connecté une seule fois |
Dépannage#
La page Connect indique que Zendesk n’est pas inclus dans votre offre. Zendesk est disponible avec Enterprise. Contactez-nous et nous réglerons ça ; tout ce qui est déjà connecté continue de fonctionner entre-temps.
La page Connect indique que vous ne pouvez pas connecter ceci. La connexion nécessite un droit que votre rôle ne possède pas. Un administrateur de l’organisation peut se connecter, ou vous accorder ce droit.
Une langue cible manque dans la liste. Activez-la d’abord dans Zendesk sous Knowledge -> Settings -> Language settings, puis rouvrez l’onglet Settings dans Lingo.dev. La liste est relue dans Zendesk à chaque fois.
Après Allow, Lingo.dev vous demande d’ajouter une langue dans Zendesk. Le centre d’aide est rédigé dans une seule langue et n’en propose aucune autre, donc il n’y a encore aucune langue cible vers laquelle traduire.
Une synchronisation se termine avec le statut Up to date. Soit rien n’a changé depuis la dernière exécution, soit rien n’a encore la synchronisation activée. Activez le contenu que vous voulez couvrir dans les onglets Categories, Sections et Articles.
Les traductions n’apparaissent pas dans le centre d’aide. Vérifiez si la connexion est en mode Draft. Les brouillons existent bien dans Zendesk, mais restent invisibles pour les lecteurs tant qu’ils ne sont pas publiés.