Zendesk Help Center
Übersetze Kategorien, Abschnitte und Artikel des Help Centers in ihre bestehenden Sprachversionen – mit manueller Kontrolle über Synchronisierung und Veröffentlichung.
Übersetze Help-Center-Inhalte direkt in Zendesk. Die Lingo.dev-Verbindung liest ausgewählte Kategorien, Abschnitte und Artikel in der Standardsprache des Help Centers, übersetzt sie mit einer Lokalisierungs-Engine und schreibt die Zielsprachversionen in dieselben Elemente zurück.
Öffne in der Navigation von Studio 2.5 jetzt Studio 2.5 → Integrationen statt Einstellungen → Integrationen. Keine Sorge: Bestehende Links zum Verbinden und Einrichten funktionieren weiterhin.
Ausführungen werden manuell gestartet. Wenn sich ein Artikel ändert, starte die Synchronisierung für die Inhalte, die du aktualisieren möchtest. Lege vor dem ersten Zurückschreiben fest, ob Übersetzungen als Entwurf oder als veröffentlichte Version gespeichert werden sollen: Wird eine bereits veröffentlichte Zielversion als Entwurf gespeichert, kann sie bis zur erneuten Veröffentlichung für die Leserschaft nicht mehr verfügbar sein.
Zugriff und Help-Center-Sprachen vorbereiten #
Die Zendesk-Help-Center-Integration ist mit dem Enterprise-Tarif verfügbar. Die aktuelle Verfügbarkeit findest du unter Preise. Unter Einstellungen → Integrationen steht neben Zendesk Nicht in deinem Tarif verfügbar, wenn die Organisation dafür einen entsprechenden Tarif benötigt.
Verwende ein Zendesk-Administratorkonto mit Zugriff auf Help-Center-Inhalte. Administratorrechte sind erforderlich, um den Webhook für Artikelveröffentlichungen zu registrieren, der Aktivitäten für Radar erfasst. Schreibvorgänge werden dem Konto zugeordnet, das den Zugriff autorisiert hat. Verwende daher ein geeignetes Dienstkonto, wenn das Team eine gemeinsame Zuordnung benötigt. In Lingo.dev brauchst du die nötigen Berechtigungen und die Freischaltung für Verbindungen in der Organisation sowie Zugriff auf die ausgewählte Lokalisierungs-Engine.
Aktiviere die Zielsprachen in den Spracheinstellungen des Help Centers. Die kontoweite Lokalisierungsliste von Zendesk ist davon unabhängig und aktiviert keine Help-Center-Übersetzungen. Mit entsprechender Autorisierung kannst du über den schreibgeschützten Endpunkt https://<subdomain>.zendesk.com/api/v2/help_center/locales.json die Sprachkonfiguration des Help Centers abrufen.
Lingo.dev liest bei jeder Ausführung die Standardsprache des Help Centers und verwendet sie als Ausgangssprache. Im Verbindungsformular wählst du keine andere Ausgangssprache aus.
Verbindung herstellen und einen ersten Artikel übersetzen #
- Öffne Einstellungen → Integrationen und wähle bei Zendesk Verbinden. Gib einen Namen und die Subdomain des Help Centers ein. Gib für
acme.zendesk.comden Wertacmeein. - Gehe zu Zendesk und autorisiere den Zugriff. Die Verbindung wird erst nach erfolgreicher Autorisierung erstellt.
- Wähle in Studio unter Verbunden das Help Center und anschließend Einrichten aus.
- Wähle eine Lokalisierungs-Engine und einen Modus für das Zurückschreiben aus und klicke anschließend auf Weiter. Wähle für diese erste Ausführung eine der im Help Center aktivierten Zielsprachen. Die Ausgangssprache steht nicht zur Auswahl. Wenn keine andere Sprache verfügbar ist, aktiviere zunächst eine in Zendesk.
- Öffne Artikel und aktiviere den Schalter Synchronisieren für einen Artikel, dessen Ausgangstext sich vorerst nicht ändert. Warte, bis die Einstellung gespeichert ist, markiere das Kontrollkästchen in der Artikelzeile und wähle Synchronisierung einreihen.
- Sieh dir das Workflow-Ergebnis und den tatsächlichen Zielartikel in Zendesk an. Kontrolliere Titel, Inhalt, Links, Sprache und den Status als Entwurf oder veröffentlichte Version. Wenn der Artikel veröffentlicht sein soll, öffne auch die für die Leserschaft zugängliche URL.
Die erste Synchronisierung übernimmt bereits vorhandene vollständige Übersetzungen, ohne sie zu überschreiben. Dabei bleiben sowohl der Text als auch der Entwurfsstatus erhalten. Fehlende Inhalte werden übersetzt. Verwende „Neu übersetzen“, wenn du eine vorhandene Übersetzung bewusst ersetzen möchtest.
Den gesamten zu übersetzenden Bereich auswählen #
Kategorien, Abschnitte und Artikel haben eigene Tabellen und Schalter für Synchronisieren, deren Einstellung dauerhaft gespeichert wird. Wenn du eine Kategorie aktivierst, werden ihr Name und ihre Beschreibung übersetzt. Ihre Abschnitte und Artikel werden dadurch nicht aktiviert. Wähle diese separat aus, wenn du einen vollständigen Help-Center-Bereich vorbereitest.
| Element | Übersetzte Felder |
|---|---|
| Kategorie | Name/Titel und Beschreibung |
| Abschnitt | Name/Titel und Beschreibung |
| Artikel | Titel und Inhalt |
Mit den Kontrollkästchen in den Zeilen beschränkst du einmalige Vorgänge über Synchronisierung einreihen oder Neuübersetzung einreihen auf Elemente, deren Schalter Synchronisieren bereits aktiviert sind. Das Markieren einer Zeile aktiviert nicht deren dauerhaft gespeicherten Schalter. Aktionen in der Kopfzeile gelten für den aktivierten Umfang der Verbindung. Kontrolliere vor dem Start, welche Auswahl die Aktion verarbeitet.
Artikelinhalte werden als HTML verarbeitet, um Formatierung, Links und eingebettete Medien wiederherzustellen. Beim Zurückschreiben können erkannte Help-Center-Links an die Zielsprache angepasst werden. Sieh dir diese Links im Ergebnis an und kontrolliere auch, ob das übersetzte Linkziel existiert. Externe Links und die seitenspezifische Navigation müssen weiterhin separat kontrolliert werden.
Diese Verbindung übersetzt keine Tickets, Makros, Designs, Community-Beiträge oder Artikel, die auf Zendesk-Inhaltsblöcken basieren. Sie lokalisiert Help-Center-Inhalte und dient nicht der Triage von Support-Tickets.
Geänderte Inhalte aktualisieren oder ersetzen #
Synchronisieren vergleicht den aktuellen Ausgangstext mit dem gespeicherten Stand und den vorhandenen Übersetzungen. Verwende diese Funktion für reguläre Aktualisierungen des Ausgangstextes, fehlende Inhalte und noch nicht abgeschlossene Arbeit aus einer früheren Ausführung.
Neu übersetzen erstellt die Übersetzungen für die ausgewählten Elemente und Sprachen erneut, auch wenn sich der Ausgangstext nicht geändert hat. Dabei können bereits akzeptierte manuelle Änderungen ersetzt werden. Die umfassende Aktion in der Kopfzeile verlangt eine Bestätigung. Auch bei Aktionen für ausgewählte Zeilen musst du festlegen, welchen Bereich du ersetzen möchtest.
Pro Verbindung ist jeweils eine Ausführung aktiv. Weitere Anfragen werden in eine Warteschlange eingereiht. Ist diese voll, musst du warten, bis wieder Kapazität frei wird. Workflow-Ausführungen zeigt die Ergebnisse an. Stopp bricht Arbeiten ab, die noch angehalten werden können. Das Ergebnis „Aktuell“ bedeutet, dass keine ausgewählte Änderung verarbeitet werden musste – nicht, dass die Übersetzungsqualität erneut beurteilt wurde.
Kontrollieren, was die Leserschaft sehen kann #
Im Veröffentlichungsmodus werden Übersetzungen als veröffentlichte Versionen zurückgeschrieben. Im Entwurfsmodus werden unveröffentlichte Sprachversionen zur Prüfung in Zendesk zurückgeschrieben. Wenn du eine bereits veröffentlichte Sprachversion im Entwurfsmodus aktualisierst, kann der neue Entwurf die veröffentlichte Version entfernen, bis jemand sie erneut veröffentlicht. Entscheide vor der Aktualisierung, ob diese Unterbrechung zur geplanten Veröffentlichung passt.
Sieh dir nach dem Zurückschreiben die Ziel-URL in der vorgesehenen Sprache an. Vergleiche den tatsächlichen Titel und Inhalt mit dem Stand des Ausgangstextes, folge den Links und achte auf Textfragmente in der Ausgangssprache. Eine abgeschlossene Übersetzungsausführung ist nur ein Teil des Veröffentlichungsprozesses. Abnahme und Veröffentlichung bleiben redaktionelle Entscheidungen.
Auf Änderungen am Ausgangstext und Teilergebnisse reagieren #
Beim Zurückschreiben wird das Ausgangselement erneut gelesen. Wenn es nach der Planung geändert oder entfernt wurde, überspringt Lingo.dev die Zielversion. Starte eine weitere manuelle Synchronisierung, sobald der Ausgangstext bereit ist, um den neuen Stand abzugleichen.
Ein Fehler bei einer Sprache macht erfolgreiche Schreibvorgänge in anderen Sprachen nicht rückgängig. Sieh dir zurückgeschriebene, übersprungene und fehlgeschlagene Elemente an und wiederhole den Vorgang für den betroffenen Bereich. Eine erzwungene Neuübersetzung des gesamten Help Centers kann bereits akzeptierte Texte ersetzen, ohne die ursprüngliche Ursache zu beheben.
Wenn Ergebnisse fehlen, kontrolliere die Elementauswahl, die aktivierten Help-Center-Sprachen, den Zugriff auf die Lokalisierungs-Engine, den Modus für das Zurückschreiben, Ausschlüsse aufgrund von Inhaltsblöcken und mögliche Änderungen am Ausgangstext. Bei der Übernahme einer vorhandenen vollständigen Übersetzung wird bewusst kein neuer Text erzeugt. Wenn eine Zielsprache in Zendesk deaktiviert wurde, wird sie bei Ausführungen übersprungen. Aktualisiere dann die Zielsprachenauswahl der Verbindung.
Bei vorübergehenden Zendesk-Ausfällen versuche es erneut, sobald der Dienst wieder verfügbar ist. Verwende Erneut verbinden für die bestehende Verbindung, wenn die Autorisierung wiederhergestellt werden muss. Wenn du die Verbindung trennst und eine neue erstellst, geht der Synchronisierungsstand verloren.
Verbindung trennen oder erneut herstellen #
Ändere Zielsprachen, Lokalisierungs-Engine und Modus auf der Registerkarte Einstellungen des Help Centers in Studio. Unter Einstellungen → Integrationen kannst du das Konto umbenennen oder erneut verbinden. Verwende Erneut verbinden, um die Autorisierung der bestehenden Verbindung wiederherzustellen.
Das Trennen beendet Lese- und Schreibvorgänge und entfernt die lokale Verbindung, den Ausführungsverlauf und den Synchronisierungsstand jedes Elements. Vorhandene Zendesk-Übersetzungen bleiben erhalten. Wenn du danach eine neue Verbindung erstellst, wird eine neue Ausgangsbasis festgelegt: Die erste Synchronisierung behält bereits vorhandene vollständige Übersetzungen bei und ergänzt fehlende Inhalte. Widerrufe die Autorisierung beim Anbieter separat, wenn der Zugriff enden soll. Stelle bei Bedarf früher veröffentlichte Formulierungen direkt in Zendesk wieder her.
Aktivitäten in Radar erfassen #
Die Verbindung liefert auch Help-Center-Aktivitäten an Radar. Übersetzungen für die Messung erfassen beschreibt die Einrichtung der Ereignisse und zeigt, wie du vor einer Messung historischer Daten den Verlauf des Anbieters importierst.
Wenn die manuelle Übersetzung funktioniert, aber neue Artikelaktivitäten fehlen, kontrolliere die Webhook-Registrierung und die Ereigniszustellung der Verbindung. Die Autorisierung kann erfolgreich sein, auch wenn ein Konto ohne Administratorrechte den Webhook nicht registrieren kann. Verwende unter Einstellungen → Integrationen die Option Erneut verbinden für die bestehende Zendesk-Verbindung und autorisiere den Zugriff mit einem Administratorkonto. Veröffentliche einen Testartikel und kontrolliere dessen Ereignis in Radar, bevor du dich auf die automatische Erfassung verlässt.