Zendesk-Hilfe-Center
Verbinden Sie Ihr Zendesk Help Center mit einer Lokalisierungs-Engine. Aktivieren Sie Sync für die Kategorien, Abschnitte und Artikel, die Sie abdecken möchten, und Lingo.dev übersetzt sie in die Sprachen Ihres Help Centers und schreibt die Übersetzungen zurück nach Zendesk.
Funktioniert mit Inhalten aus Zendesk Guide (Hilfe-Center): Kategorien, Abschnitte und Artikel.
Zendesk ist mit Enterprise verfügbar. Wenn auf der Connect-Seite Zendesk ist nicht in Ihrem Tarif enthalten steht, melden Sie sich bei uns – wir kümmern uns darum.
Bevor du loslegst#
Du brauchst drei Dinge:
Admin-Zugriff auf Zendesk. Die Verbindung läuft über OAuth, und das autorisierende Konto braucht die Berechtigung, Help-Center-Inhalte zu verwalten. Jede Übersetzung, die Lingo.dev schreibt, wird in Zendesk diesem Konto zugeordnet. Verbinden Sie sich daher am besten mit einem gemeinsamen Servicekonto, wenn nicht der Name eines einzelnen Teammitglieds im gesamten Help Center erscheinen soll.
Ihre in Zendesk aktivierten Zielsprachen. Lingo.dev bietet genau die Sprachen an, die in Ihrem Help Center aktiviert sind – und keine anderen. 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.
Um genau zu sehen, 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 dieser Endpunkt auflistet, bietet Lingo.dev auch an.Eine Lokalisierungs-Engine. Deren Glossar, Markenstimme und Regeln geben vor, wie die Übersetzungen deines Hilfe-Centers klingen.
Die Ausgangssprache wählen Sie nicht selbst aus: Lingo.dev liest bei jedem Durchlauf die Standardsprache Ihres Help Centers aus Zendesk aus.
Help Center schon übersetzt?
Bei der ersten Synchronisierung bleiben die Übersetzungen erhalten, die bereits in Zendesk vorhanden sind. Wenn für ein Element in einer Sprache in Zendesk schon eine vollständige Übersetzung vorliegt, lässt Lingo.dev sie unverändert und übersetzt nur, was noch fehlt. Wenn du eine bestehende Übersetzung ersetzen möchtest, verwende Erneut übersetzen.
Verbinde dein Hilfe-Center#
Öffne die Integration
Gehen Sie zu Studio -> All integrations und klicken Sie auf der Zendesk-Kachel auf Connect.
Fülle das Formular aus
| Feld | Was du eingeben musst |
|---|---|
| Name | Wie diese Verbindung heißen soll, damit du deine Help Center auseinanderhalten kannst |
| Help Center | Nur die Subdomain aus Ihrer Zendesk-URL. Für https://acme.zendesk.com geben Sie acme ein – das Formular zeigt danach .zendesk.com an |
| Engine | Die Lokalisierungs-Engine, deren Glossar, Regeln und Markenstimme für diese Übersetzungen gelten |
| Modus | Draft schreibt Übersetzungen als unveröffentlichte Entwürfe, Publish schaltet sie live, sobald sie geschrieben sind. Mehr dazu unten unter Entwürfe vs. veröffentlicht |
Klicken Sie auf Continue to Zendesk.
In Zendesk autorisieren
Zendesk fordert Sie auf, Lingo.dev Zugriff zu gewähren. Klicken Sie auf Allow. Vorher wird nichts erstellt: Wenn Sie auf Deny klicken, landen Sie ohne hergestellte Verbindung wieder beim Formular.
Sprachen auswählen
Zurück bei Lingo.dev sehen Sie die Sprachen, die in Ihrem Help Center aktiviert sind – abzüglich der Standardsprache. Alle sind vorausgewählt. Entfernen Sie die Häkchen bei den Sprachen, die Sie nicht möchten, und klicken Sie dann auf Save and open.
Wenn das Help Center nur eine Sprache hat, fordert Lingo.dev Sie auf, zuerst in Zendesk eine weitere hinzuzufügen.
Wähle aus, was übersetzt wird#
Die Verbindungsseite hat fünf Tabs: Categories, Sections, Articles, Workflow runs und Settings.
Die ersten drei listen die Inhalte dieses Typs auf – jeweils eine Zeile pro Element, mit einem Suchfeld für Namen und IDs. Jeder Zeilenname verlinkt in Zendesk auf das jeweilige Element, damit Sie genau prüfen können, was Sie auswählen. Jede Zeile hat einen Sync-Schalter: Aktivieren Sie ihn, gehört dieses Element ab dann zur Verbindung. Die Änderung wird sofort gespeichert, sobald Sie den Schalter umlegen; es gibt keinen Save-Button. Der Schalter in der Tabellenkopfzeile aktiviert oder deaktiviert Sync für alles in der Liste.
Die Kontrollkästchen sind für einmalige Durchläufe. Markieren Sie Zeilen, erscheinen zwei Buttons: Queue sync (N) und Queue retranslation (N). Damit führen Sie nur diese Zeilen aus, ohne zu ändern, was bei Sync aktiviert ist.
Nichts wird automatisch mit übernommen
Wenn Sie eine Kategorie aktivieren, werden nur ihr Name und ihre Beschreibung übersetzt – nicht die darunterliegenden Abschnitte und Artikel. Um eine ganze Kategorie abzudecken, aktivieren Sie ihre Artikel zusätzlich im Tab Articles. Der Schalter in der Kopfzeile aktiviert alles Aufgelistete, und Sie können Häkchen bei Elementen entfernen, die Sie nicht möchten.
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 erneut, unabhängig davon, ob sich etwas geändert hat | Nachdem du Glossar, Markenstimme oder Regeln deiner Engine geändert hast und bestehende Übersetzungen neu erzeugen möchtest |
Beide befinden sich in der Kopfzeile der Seite, wo sie alles mit aktiviertem Sync abdecken, und erscheinen über der Tabelle, wenn Sie Zeilen markieren, wo sie nur diese Zeilen abdecken. Wenn Sie die Neuübersetzung über die Kopfzeile starten, müssen Sie zuerst bestätigen, weil jedes ausgewählte Element und jede Sprache berechnet wird.
Läufe werden manuell gestartet. Wenn du einen Artikel in Zendesk bearbeitest, wird dadurch kein Lauf ausgelöst – du entscheidest, wann übersetzt wird.
Pro Verbindung kann immer nur ein Durchlauf gleichzeitig laufen. Fordern Sie einen weiteren an, während einer läuft, wird er dahinter in die Warteschlange eingereiht. Ist die Warteschlange voll, versuchen Sie es erneut, sobald ein Durchlauf abgeschlossen ist.
Einen Durchlauf verfolgen#
Der Tab Workflow runs listet jeden Durchlauf auf: wann er gestartet wurde, was ihn ausgelöst hat, welche Sprachen er umfasste, wie lange er gedauert hat und seinen Status. Ein noch laufender Durchlauf hat einen Stop-Button. Öffnen Sie eine Zeile, um das Ergebnis pro Sprache zu sehen.
Ein Durchlauf, der mit Up to date endet, ist kein Fehler. Das bedeutet, dass sich seit dem letzten Durchlauf nichts geändert hat – das ist das normale Ergebnis, wenn zweimal synchronisiert wird, 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.
Entwürfe vs. veröffentlicht#
Im Modus Draft kommen Übersetzungen in Zendesk als unveröffentlichte Entwürfe an. Für Ihre Leserinnen und Leser ist nichts sichtbar, bis jemand sie in Zendesk prüft und veröffentlicht. Mit diesem Modus sollten Sie starten, wenn Ihr Help Center noch keine Übersetzungen hat und Sie die Qualität bewerten möchten.
Im Modus Publish werden Übersetzungen live geschaltet, sobald sie geschrieben sind.
Übersetzungen schon veröffentlicht? Dann Publish verwenden
Im Draft-Modus wird eine Übersetzung, die Lingo.dev für eine Sprache schreibt, die bereits veröffentlicht ist, zum Entwurf dieser Sprache, und Leserinnen und Leser verlieren die Live-Version, bis jemand sie erneut veröffentlicht. Wenn Ihr Help Center bereits Übersetzungen ausliefert, wählen Sie Publish.
Sie können den Modus später im Tab Settings ändern – zusammen mit Ihrer Engine und den Zielsprachen.
Einstellungen#
Im Tab Einstellungen siehst du, aus welchem Help Center die Verbindung Inhalte bezieht und für wie viele Inhalte die Synchronisierung aktiviert ist. Du kannst dort außerdem den Namen, die Zielsprachen, die Engine und den Modus ändern. Jede Änderung wird sofort beim Bearbeiten gespeichert.
Wenn eine von Ihnen ausgewählte Sprache in Zendesk nicht mehr aktiviert ist, weist der Tab darauf hin. Synchronisierungen überspringen diese Sprache, und bei der nächsten Änderung an der Liste wird sie entfernt.
Verbindung trennen#
Disconnect unten im Tab Settings beendet, dass Lingo.dev aus dem Help Center liest und in es schreibt. Dabei werden die Verbindung, ihr Durchlaufverlauf und der artikelbezogene Datensatz darüber entfernt, was bereits übersetzt wurde. Bereits geschriebene Übersetzungen bleiben in Zendesk – sie gehören zu Ihrem Help Center, nicht zu uns.
Neu verbinden
Beim erneuten Verbinden beginnt eine neue Aufzeichnung dessen, was übersetzt wurde. Bei der ersten Synchronisierung danach bleiben die Übersetzungen erhalten, die bereits in Zendesk vorhanden sind – auch die, die Lingo.dev zuvor geschrieben hat. Übersetzt wird nur, was noch fehlt.
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 | Eine pro Verbindung; weitere Anfragen werden dahinter in die Warteschlange eingereiht |
| Zielsprachen | Muss in Ihrem Zendesk Help Center aktiviert sein, bevor Lingo.dev sie anbieten kann |
| Verbindungen | Mehrere Help Center pro Organisation, jedes davon einmal verbunden |
Fehlerbehebung#
Auf der Connect-Seite steht, dass Zendesk nicht in Ihrem Tarif enthalten ist. Zendesk ist mit Enterprise verfügbar. Melden Sie sich bei uns – wir kümmern uns darum. Alles, was bereits verbunden ist, funktioniert in der Zwischenzeit weiter.
Auf der Connect-Seite steht, dass Sie dies nicht verbinden können. Für die Verbindung ist eine Berechtigung erforderlich, die Ihrer Rolle fehlt. Eine Organisationsadmin kann die Verbindung herstellen oder Ihnen die Berechtigung erteilen.
Eine Zielsprache fehlt in der Liste. Aktivieren Sie sie zuerst in Zendesk unter Knowledge -> Settings -> Language settings und öffnen Sie dann den Tab Settings in Lingo.dev erneut. Die Liste wird jedes Mal aus Zendesk ausgelesen.
Nach Allow fordert Lingo.dev Sie auf, in Zendesk eine Sprache hinzuzufügen. Das Help Center ist in nur einer Sprache verfasst und bietet noch keine weitere an, in die übersetzt werden kann.
Eine Synchronisierung endet mit Up to date. Entweder hat sich seit dem letzten Durchlauf nichts geändert, oder es ist noch nichts für Sync aktiviert. Aktivieren Sie die Inhalte, die abgedeckt werden sollen, in den Tabs Categories, Sections und Articles.
Übersetzungen erscheinen nicht im Help Center. Prüfen Sie, ob die Verbindung im Draft-Modus ist. Entwürfe existieren in Zendesk, bleiben für Leserinnen und Leser aber unsichtbar, bis sie veröffentlicht werden.