Sie können die Unbabel App in Ihrer Kustomer-Instanz installieren, indem Sie sie im Apps-Verzeichnis ausfindig machen.

 

Installieren der App

Beginnen Sie mit der Installation der App in Kustomer.

 

1 - Klicken Sie in der linken Navigationsleiste auf das Apps -Symbol und dann auf Verzeichnis durchsuchen.

 

 

2 - Suchen Sie nach der Unbabel App, indem Sie ihren Namen in die Suchleiste eingeben.

 

 

3 - Klicken Sie auf die App, um ein neues Fenster zu öffnen. Führen Sie die Installation aus und schließen Sie sie ab.

 

Erstellen der Kustomer-API-Token

Für die Integration mit Unbabel müssen Sie zwei Token erstellen. Diese werden verwendet, um die Ferneinrichtung der Integration fortzusetzen und mit der Programmierschnittstelle (API) von Unbabelzu kommunizieren. Zur Erhöhung der Sicherheit empfehlen wir die Erstellung von zwei Token. Dafür gehen Sie folgendermaßen vor:

 

4 - Gehen Sie zu Kustomer-Einstellungen > Sicherheit > API-Schlüssel und klicken Sie auf + API-Schlüssel hinzufügen

 

 

5 - Ein Popup-Fenster mit der Frage nach Details wird angezeigt.

 

• Um das Token der Unbabel Deployment API zu erstellen, verwenden Sie bitte die folgenden Werte:
  • Name: Unbabel Deployment API
  • Rollen: org.admin, org.admin.shortcut, org.admin.tag, org.admin.team, org.hooks
  • Gültigkeit bis zum Ablauf in Tagen: 60
  • Keine IP-Einschränkungen hinzufügen
  • Klicken Sie auf Erstellen

 

• Um das Token Unbabel Kustomer API zu erstellen, verwenden Sie die folgenden Werte:
  • Name: Unbabel Kustomer API
  • Rollen: org.admin, org.user
  • Gültigkeit bis zum Ablauf in Tagen: kein Ablauf
  • Keine IP-Einschränkungen hinzufügen
  • Klicken Sie auf Erstellen

 

6 - Kopieren Sie das Token der Unbabel Deployment API und geben Sie es an das Unbabel Integrations Delivery Team weiter. Das Team wird es verwenden, um Gitlab-Pipelines auszuführen und mit der Konfiguration von Unbabel auf Ihrer Instanz fortzufahren.

Hinweis: Wenn Sie mehrere Bereitstellungsregionen haben, müssen Sie uns auch den kanonischen Namen der Instanz mitteilen, auf der Sie Unbabel für Kustomer installiert haben.

 

 

Integration Delivery (IDM) führt den GitLab-Prozess auf Seiten von Unbabel aus.

7 - Das Integration Delivery Team setzt die Installation auf Seiten von Unbabel fort und setzt sich mit Ihnen in Verbindung, sobald sie abgeschlossen ist. Bitte warten Sie bis dahin auf eine Bestätigung.

 

 

Konfigurieren von Workflows und Team

Sobald das Unbabel-Team die Konfiguration durchgeführt hat, können Sie die Einrichtung auf Ihrer Instanz fortsetzen und abschließen.

Hinweis: Bitte versuchen Sie diese Schritte nicht, bevor Sie vom Integration Delivery Team dazu aufgefordert werden.

 

8 - Gehen Sie zu Einstellungen > Plattform > Workflows, um die Unbabel-Workflows zu finden und alle zu aktivieren.

 

9 - Gehen Sie zu Einstellungen > Benutzer > Teams. Suchen Sie das neue „Unbabel-Team“ und fügen Sie dem Team die Benutzer hinzu, die Zugriff auf Unbabel haben sollen. Speichern Sie Ihre Änderungen.

 

 

 

Ausfüllen der App-Einstellungen

10 - Die Unbabel App verfügt über Einstellungsfelder, die korrekt ausgefüllt werden müssen, damit die Integration funktioniert. Um darauf zuzugreifen, klicken Sie im linken Navigationsbereich auf Apps und wählen Sie Unbabel im Apps-Verzeichnis aus.

 

 

Das Einstellungsfenster wird angezeigt. Füllen Sie alle vorhandenen Felder aus.

 

Nachfolgend erfahren Sie, wo Sie die erforderlichen Informationen erhalten:

 

• Kanonischer Name
  • Dieser Wert entspricht dem Namen der Kustomer-Instanz

  • Um ihn zu erhalten: Kopieren Sie den ersten Teil der URL Ihrer Instanz vor „kustomerapp“.

    Beispiel: https://[KUSTOMER_DOMAIN].kustomerapp.com/app/dashboard/performance

    Hinweis:

  • Der kanonische Name muss dem Unbabel Integration Delivery Team mitgeteilt werden.

 

• Von-E-Mail
  • Dies ist die organisationsweite E-Mail-Adresse.
  • So erhalten Sie sie: Gehen Sie zu Apps -> E-Mail -> Adresse und wählen Sie die Adresse aus, die Sie für Unbabel verwenden möchten.

 

• Status-Webhook
  • Dieser Webhook ist für die Bereitstellung von Übersetzungsstatus-Updates auf der Insight Card verantwortlich.

  • So erhalten Sie ihn: Gehen Sie zu Einstellungen > Plattform > Eingehender Webhook. Suchen Sie unter Form Hooks nach dem Webhook mit dem Namen Unbabel Async Translation Status Form Hook. Klicken Sie auf das Symbol mit den drei Punkten und kopieren Sie die Hook-Adresse.

 

• Installations-ID
  • Die Installations-ID von Unbabel. Stellt Ihre Instanz auf den Unbabel-APIs dar.
  • So erhalten Sie sie: Wird zur Verfügung gestellt vom Integration Delivery Team bei Unbabel.
  • Sie müssen Unbabel die Adresse des Translation Ingest-Webhook mitteilen, um diese ID zu erhalten. Gehen Sie zu Einstellungen > Plattform > Eingehender Webhook. Suchen Sie unter Form Hooks nach dem Webhook mit dem Namen Unbabel Async Translation Ingest Form Hook. Klicken Sie auf das Symbol mit den drei Punkten und kopieren Sie die Hook-Adresse.

 

• Kustomer-API-Token
  • Das Autorisierungstoken von Kustomer ermöglicht Unbabel den Zugriff auf die Instanz.
  • So erhalten Sie es: Es handelt sich um das Unbabel Kustomer API Token, das im Schritt 4 der Installation erstellt wurde.

 

• Unbabel-Team-ID
  • Die ID des Benutzerteams, das zur Nutzung von Unbabel berechtigt ist
  • So erhalten Sie sie: Gehen Sie zu Einstellungen > Benutzer > Teams, klicken Sie, um das Unbabel-Team zubearbeiten, und kopieren Sie die ID aus dem URL-Pfad.

 

• Unbabel-API-Token
  • Ein sicheres Token, das der Kustomer-Instanz den Zugriff auf Unbabel ermöglicht
  • So erhalten Sie es: Der Benutzername und der API-Schlüssel befinden sich in der Integrations-App im Kundenportal.
  • Format: username:api_key

 

Stellen Sie sicher, dass Sie die Anmeldedaten vom Unbabel Portal erhalten und fügen Sie diese in Kustomer im Format username:api_key hinzu.

 

• Unbabel-Benutzer-ID 1
  • Primärer Kustomer-Superuser für die Unbabel App
  • So erhalten Sie sie: Gehen Sie zu Einstellungen > Benutzer > Benutzer, klicken Sie, um das Unbabel-Team zubearbeiten, und kopieren Sie die ID aus dem URL-Pfad.

 

• Unbabel-Benutzer-ID 2
  • Sekundärer Kustomer-Superuser für die Unbabel App.
  • Optional
  • So erhalten Sie sie: Gehen Sie zu Einstellungen > Benutzer > Benutzer, klicken Sie, um das Unbabel-Team zubearbeiten, und kopieren Sie die ID aus dem URL-Pfad.

 

Erstellen einer Antwort-E-Mail-Vorlage und Aktualisieren von Workflows

Um den vollen Funktionsumfang der Unbabel App nutzen zu können, ist noch eine letzte Konfiguration erforderlich: das Erstellen von Antwort-E-Mail-Vorlagen und Aktualisieren der entsprechenden Workflows.

 

11 - Gehen Sie zu Einstellungen > Verwaltung > E-Mail-Vorlagen und klicken Sie auf Vorlage hinzufügen.

 

 

12 - Benennen Sie Ihre Vorlage und erstellen Sie sie als Vorlage vom Typ „E-Mail-Antwort“.

 

 

13 - Klicken Sie, um Ihre neue Vorlage zu bearbeiten, und kopieren Sie die ID in die URL, wie unten gezeigt.

 

 

14 - Gehen Sie zu Einstellungen > Plattform > Workflows und suchen Sie nach einem vorhandenen Workflow mit dem Namen UnbabelAsync – Vorlage für ausgehende Nachricht(en) zuweisen und klicken Sie darauf, um ihn zu bearbeiten.

 

 

15 - Suchen Sie im Workflow nach dem Schritt Standard-Vorlage zuweisen und klicken Sie darauf. Dadurch werden die Schritteigenschaften geöffnet. Scrollen Sie nach unten, umUBA – Vorlage für ausgehende Nachricht(en) (String)zu finden, und fügen Sie die kopierte Vorlagen-ID ein.

 

16 - Wiederholen Sie diesen Vorgang für alle Sprachvorlagen unterhalb dieses Schritts.

 

 

17 - Speichern Sie alle Änderungen.

 

Die Installation und Konfiguration sind nun abgeschlossen.