Verbinde dein Zendesk-Hilfe-Center mit einer Lokalisierungs-Engine. Wähle die Kategorien, Abschnitte und Artikel aus, die übersetzt werden sollen, und Lingo.dev übersetzt sie in deine Zielsprachen und schreibt die Übersetzungen zurück nach Zendesk.
Funktioniert mit Inhalten aus Zendesk Guide (Hilfe-Center): Kategorien, Abschnitte und Artikel.
Die Zendesk-Integration wird pro Organisation aktiviert. Wenn du sie unter Settings -> Integrations nicht siehst, melde dich bei uns – wir schalten sie für dich frei.
Bevor du loslegst#
Du brauchst drei Dinge:
Admin-Zugriff auf Zendesk. Die Verbindung nutzt OAuth, und das autorisierende Konto braucht die Berechtigung, Inhalte im Hilfe-Center zu verwalten.
Ihre in Zendesk aktivierten Zielsprachen. Zendesk akzeptiert Übersetzungen nur für Sprachen, die im Help Center bereits vorhanden sind. Aktivieren Sie sie in Zendesk unter Knowledge -> Settings -> Language settings.
Sprachen, die unter Admin Center -> Account -> Appearance -> Localization hinzugefügt werden, sind eine separate Liste und aktivieren keine Sprache im Help Center.
Wenn Sie genau sehen möchten, was Ihr Help Center akzeptiert, öffnen Sie
https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, während Sie als Admin angemeldet sind. Alles, was dort aufgeführt ist, können Sie in Lingo.dev auswählen.Eine Lokalisierungs-Engine. Deren Glossar, Markenstimme und Regeln geben vor, wie die Übersetzungen deines Hilfe-Centers klingen.
Sprachcodes müssen exakt zu Zendesk passen
Zendesk verwendet Codes wie en-us und de-de. Wenn die Quellsprache deines Hilfe-Centers als en-us aufgeführt ist, wähle in Lingo.dev English (United States) und nicht einfach English – das sind zwei unterschiedliche Sprachen (en-US vs. en), und genau dieser Unterschied ist der mit Abstand häufigste Grund, warum eine Verbindung fehlschlägt.
Verbinde dein Hilfe-Center#
Öffne die Integration
Gehe zu Settings -> Integrations und klicke unter Zendesk auf Connect.
Fülle das Formular aus
| Feld | Was du eingeben musst |
|---|---|
| Subdomain | Nur den Teil aus deiner Zendesk-URL. Für https://acme.zendesk.com gib acme ein – ohne https://, ohne .zendesk.com |
| Engine | Die Lokalisierungs-Engine, die diese Inhalte übersetzt |
| Quellsprache | Die Sprache, in der deine Artikel verfasst sind – genau so, wie Zendesk sie aufführt |
| Zielsprachen | Die Sprachen, in die übersetzt werden soll. Alle müssen vorher in Zendesk aktiviert sein |
| Als Entwürfe speichern | Lass dies aktiviert, damit Übersetzungen als unveröffentlichte Entwürfe geschrieben werden. Deaktiviere es, um sie sofort zu veröffentlichen |
In Zendesk autorisieren
Du wirst zu Zendesk weitergeleitet. Klicke auf Allow. Danach landest du wieder auf der Zendesk-Seite in Lingo.dev und die Verbindung ist aktiv.
Wähle aus, was übersetzt wird#
Die Zendesk-Seite hat zwei Tabs: Content und Runs.
Im Tab Content findest du alles aus deinem Hilfe-Center – Kategorien, Abschnitte und Artikel in einer einzigen Tabelle. Nutze die Filter-Chips darüber (All, Categories, Sections, Articles), um die Liste einzugrenzen, und die Kontrollkästchen, um auszuwählen, was übersetzt werden soll. Der Name jeder Zeile verlinkt zum jeweiligen Element in Zendesk, damit du prüfen kannst, was du auswählst.
Wenn du eine Kategorie auswählst, ist ihr Inhalt nicht automatisch dabei
Kategorien, Abschnitte und Artikel wählst du unabhängig voneinander aus. Wenn du eine ganze Kategorie übersetzen möchtest, wähle die Kategorie und ihre Abschnitte und Artikel aus.
Speichere, bevor du synchronisierst. Eine neue Verbindung startet mit einem leeren Bereich, und bei der Synchronisierung wird der gespeicherte Bereich verwendet – nicht das, was gerade auf dem Bildschirm ausgewählt ist. Wenn du synchronisierst, bevor du etwas speicherst, endet der Lauf ohne Inhalte zum Übersetzen. Klicke auf Save und übersetze dann.
Was übersetzt wird#
| Element | Übersetzte Felder |
|---|---|
| Kategorie | Titel, Beschreibung |
| Abschnitt | Titel, Beschreibung |
| Artikel | Titel, Inhalt |
Artikelinhalte werden als HTML übersetzt, damit Formatierung, Links und eingebettete Medien den Hin- und Rückweg unbeschadet überstehen.
Synchronisieren und neu übersetzen#
Zwei Buttons, zwei unterschiedliche Aufgaben:
| Button | Was er macht | Wann du ihn verwendest |
|---|---|---|
| Sync | Übersetzt nur das, was sich seit dem letzten Durchlauf geändert hat | Für regelmäßige Updates. Diesen Button brauchst du meistens |
| Retranslate | Übersetzt alles im Umfang noch einmal von Grund auf | Nachdem du Glossar, Markenstimme oder Regeln deiner Engine geändert hast und bestehende Übersetzungen neu erzeugen möchtest |
Beide sind an zwei Stellen verfügbar: im Seitenkopf, wo sie deinen gesamten gespeicherten Umfang abdecken, und über der Inhaltstabelle, wo sie nur die von dir ausgewählten Zeilen abdecken.
Läufe werden manuell gestartet. Wenn du einen Artikel in Zendesk bearbeitest, wird dadurch kein Lauf ausgelöst – du entscheidest, wann übersetzt wird.
Es kann immer nur ein Durchlauf gleichzeitig aktiv sein. Während ein Durchlauf läuft, sind beide Buttons deaktiviert.
Einen Durchlauf verfolgen#
Im Tab Runs siehst du jeden Durchlauf mit Status, Auslöser, Startzeitpunkt und Dauer. Ein laufender Durchlauf kann direkt aus der Liste heraus abgebrochen werden.
Öffne einen Lauf, um die Details zu sehen: in welcher Phase er sich befindet – Inhalte aus Zendesk abrufen, übersetzen, zurückschreiben – sowie den Gesamtfortschritt und den Fortschritt pro Zielsprache. So siehst du auf einen Blick, dass Deutsch fertig ist, während Japanisch noch läuft.
Ein Lauf, der mit nichts zu übersetzen endet, ist kein Fehler. Das bedeutet, dass alles im Bereich bereits mit den Übersetzungen übereinstimmt. Das ist das normale Ergebnis, wenn du zweimal synchronisierst, ohne dazwischen etwas zu bearbeiten.
Wo die Übersetzungen landen#
Jede Übersetzung wird als sprachspezifische Version demselben Artikel, Abschnitt oder derselben Kategorie zugeordnet – ganz nach Zendesks eigenem Übersetzungsmodell. Deine Leserinnen und Leser wechseln einfach im Help Center die Sprache und sehen die passende Version; nichts wird dupliziert oder verschoben.
Wem die Übersetzungen zugeschrieben werden
In Zendesk wird jede Übersetzung dem Konto zugeschrieben, das die Verbindung autorisiert hat – nicht der Person, die auf Sync geklickt hat. Wenn du nicht möchtest, dass der Name eines Teammitglieds im ganzen Help Center erscheint, richte die Verbindung über ein gemeinsames Servicekonto ein.
Entwürfe vs. veröffentlicht#
Wenn Save as drafts aktiviert ist, landen Übersetzungen in Zendesk als unveröffentlichte Entwürfe. Für deine Kund:innen ist nichts sichtbar, bis jemand sie in Zendesk prüft und veröffentlicht. Das ist die sichere Standardeinstellung – und die richtige Wahl, solange du die Übersetzungsqualität bewertest.
Wenn du die Option deaktivierst, werden Übersetzungen veröffentlicht, sobald sie geschrieben wurden.
Du kannst das später unter Settings -> Integrations -> Zendesk ändern – zusammen mit deiner Engine und deinen Zielsprachen.
Verbindung trennen#
Wenn du die Verbindung trennst, werden die Verbindung selbst, ihr Laufverlauf und der artikelbezogene Eintrag dazu entfernt, was bereits übersetzt wurde. Übersetzungen, die bereits nach Zendesk geschrieben wurden, bleiben dort bestehen – sie gehören zu deinem Help Center, nicht zu uns.
Nach dem erneuten Verbinden geht es bei null los
Weil der artikelbezogene Synchronisierungsstatus verloren geht, behandelt die erste Synchronisierung nach dem erneuten Verbinden deinen gesamten Bereich als neu und übersetzt alles noch einmal – mit den entsprechenden Kosten. Trenne die Verbindung nur, wenn du sie wirklich beenden willst, nicht zur Fehlersuche.
Einschränkungen#
| Einschränkung | Detail |
|---|---|
| Inhaltstypen | Kategorien, Abschnitte und Artikel. Tickets, Makros, Themes und Community-Beiträge sind nicht abgedeckt. |
| Inhaltsblöcke | Artikel, die aus Zendesk-Content-Blocks aufgebaut sind, werden nicht übersetzt |
| Auslöser | Nur manuell – kein Webhook, keine automatische Synchronisierung, wenn sich ein Artikel ändert |
| Gleichzeitige Durchläufe | Einer pro Verbindung |
| Zielsprachen | Müssen in deinem Zendesk-Hilfe-Center aktiviert sein, bevor ein Durchlauf dort hinein schreiben kann |
Fehlerbehebung#
Die Verbindung schlägt direkt nach dem Klick auf „Zulassen“ fehl. Fast immer liegt das an einer abweichenden Sprache: Die von Ihnen ausgewählte Quell-Sprache gibt es im Help Center nicht. Öffnen Sie https://<subdomain>.zendesk.com/api/v2/help_center/locales.json, notieren Sie sich den dort exakt aufgeführten Code und verbinden Sie die Integration anschließend damit erneut.
Eine Zielsprache fehlt im Dropdown-Menü. Aktivieren Sie sie zuerst in Zendesk unter Knowledge -> Settings -> Language settings und öffnen Sie anschließend die Konfiguration in Lingo.dev erneut.
Sync meldet, dass es nichts zu übersetzen gibt. Entweder ist dein gespeicherter Bereich leer – wähle Inhalte im Tab „Content“ aus und klicke auf Save – oder alles darin ist bereits auf dem neuesten Stand.
Übersetzungen erscheinen nicht im Hilfe-Center. Prüfe, ob die Verbindung im Entwurfsmodus ist. Entwürfe existieren in Zendesk, bleiben für Kund:innen aber unsichtbar, bis sie veröffentlicht werden.
