Umbenennen der Subdomäne

In diesem Beitrag wird beschrieben, wie Sie die Subdomäne Ihres Kontos umbenennen. Sie können die Subdomäne eines kostenpflichtigen Kontos oder eines Testkontos umbenennen, nicht jedoch die eines Sandbox-Kontos. 

Beachten Sie, dass Sie beim Umbenennen Ihrer Subdomäne (meinefirma.zendesk.com) im Grunde die Adresse Ihres Kontos ändern. Diese Änderung wird sofort wirksam. Ihr Zendesk-Konto wird dann nicht mehr unter Ihrer alten URL geführt und Zendesk kann keine Umleitung für Sie einrichten. Statt Ihre Subdomäne umzubenennen, können Sie auch einfach den Kontonamen ändern. 

Für Team, Professional und Enterprise wird Host-Mapping (der Kauf einer anderen Domäne, die auf Ihr Zendesk-Konto verweist) als Alternative zum Ändern Ihrer Subdomäne dringend empfohlen. So können Sie die URL ändern, die Kunden sehen, wenn sie auf Ihr Help Center zugreifen, ohne die Adresse der Agentenoberfläche oder Ihres Zendesk-Kontos ändern zu müssen, Weitere Informationen finden Sie unter Host-Mapping: Ändern der URL Ihres Help Centers.

Die in diesem Beitrag beschriebenen Aufgaben sollen Ihnen helfen, die offensichtlichen Probleme beim Umbenennen Ihrer Subdomäne zu vermeiden. Dennoch besteht immer die Möglichkeit, dass überraschende Fehler auftreten. Gehen Sie Ihren gesamten Workflow durch, bevor Sie diese Änderung vornehmen.

Hinweis: Wenn Sie ein Nur-Chat-Konto, ein Nur Sell-Konto oder ein Sell+Chat-Konto haben, kann die Subdomäne im Admin Center nicht geändert werden. Bitten Sie in diesem Fall den Zendesk-Kundensupport um Hilfe.

Dieser Beitrag beschreibt die folgenden Aktualisierungen, die Sie vornehmen müssen:

• Schritt 1: Aufgaben vor dem Umbenennen Ihrer Subdomäne
• Schritt 2: Subdomäne umbenennen
• Schritt 3: Aufgaben nach dem Umbenennen Ihrer Subdomäne

Schritt 1: Aufgaben vor dem Umbenennen Ihrer Subdomäne

Bevor Sie Ihre Subdomäne umbenennen, sollten Sie die folgenden Objekte aktualisieren:

• CNAME, Host-Maps und SSL
• Jira-Integration

CNAME, Host-Maps und SSL

Zuerst sollten Sie eventuelle E-Mail-Weiterleitungen und Host-Mappings so aktualisieren, dass sie auf ihre neue Supportadresse und die URL Ihrer umbenannten Subdomäne verweisen, damit Sie keine eingehenden Tickets verpassen. Hierzu können Sie die Option „Wildcard-E-Mails akzeptieren“ verwenden (siehe Akzeptieren von Wildcard-E-Mail-Adressen für Supportanfragen). Nehmen Sie die eigentliche Umstellung außerhalb der Spitzenzeiten vor, damit Sie in Ruhe alles richtig einrichten können.

Außerdem sollten Sie dafür sorgen, dass vor dem Ändern Ihrer Subdomäne alle CNAME-Änderungen und Zertifikatsaktualisierungen bei Ihrem Kundenserviceteam durchgeführt werden. Sie müssen einen neuen CNAME-Eintrag für Ihre neue Zendesk-Subdomäne mit einer neuen Host-Map-URL hinzufügen. Außerdem müssen Sie die Umleitung von der alten Host-Map zur neuen einrichten. Dies kann eine gewisse Zeit in Anspruch nehmen. 

Um ein neues SSL-Zertifikat zu erhalten, reichen Sie eine „Zertifikatsregistrierungsanforderung“ (auf Englisch „Certificate Signing Request“ bzw. CSR) ein. Laden Sie das neue Zertifikat dann in Zendesk Support hoch. Sie müssen ein neues SSL-Zertifikat installieren, das die geänderte Host-Mapping-URL abdeckt. Weitere Informationen finden Sie unter Ersetzen des aktuellen SSL-Zertifikats. 

Jira

Wenn Sie die Jira On Demand-Integration aktiviert haben, sollten Sie Jira aktualisieren, bevor Sie Ihre Subdomäne umbenennen.

So aktualisieren Sie Jira mit einer neuen Subdomäne

1. Deinstallieren Sie die App in Zendesk Support unter Admin > Apps > Apps verwalten.
2. Deaktivieren Sie Jira unter Admin > Verwalten > Add-ons > Zendesk Support für Jira > Deaktivieren**.
3. Benennen Sie Ihre Subdomäne um.
4. Aktivieren Sie den Connector erneut in Jira.
5. Wählen Sie in der Connector-Einrichtung die Option Konfigurieren.
6. Klicken Sie im nächsten Bildschirm auf Einrichtung abschließen, um die App zu installieren.
7. Befolgen Sie die Anweisungen auf dem Bildschirm.
8. Prüfen Sie in Zendesk Support, ob die App „Jira OnDemand“ ordnungsgemäß geladen wird.

Die verknüpften Tickets/Vorgänge zwischen Zendesk Support und Jira gehen hierbei nicht verloren. Sie wiederholen nur die Autorisierung für die Zendesk-App.

Wenn Sie OAuth-Anmeldedaten verwendet haben, die an Ihre alte Subdomäne gebunden sind, müssen Sie unter Umständen auch Ihre übrigen Apps aktualisieren.

Schritt 2: Subdomäne umbenennen

Wenn Sie bereit sind, Ihre Subdomäne umzubenennen, fahren Sie wie folgt fort. Nur der Inhaber eines Kontos kann die Subdomäne umbenennen.

So benennen Sie die Subdomäne um

1. Klicken Sie auf das Symbol Admin () und dann auf Einstellungen > Konto.
2. Klicken Sie auf der Kontoseite auf die Registerkarte „Branding“.
3. Klicken Sie auf Subdomäne ändern.
   
   
   Hinweis: Wenn Sie mehrere Marken haben, klicken Sie statt auf „Subdomäne ändern“ auf das Menü „Marken“.
4. Geben Sie die neue Subdomäne im Dialogfeld ein (siehe unten) und bestätigen Sie dann die Änderungen durch Klicken auf Subdomäne umbenennen.
   Sie müssen die Browserseite aktualisieren, um die Änderung zu sehen.
   

Gute Nachrichten: Sie brauchen nicht alles manuell zu ändern, wenn Sie Ihre Subdomäne umbenennen. Alle vorhandenen Benutzer, Tickets, Organisationen und Gruppen existieren automatisch unter der neuen URL. Ihre Auslöser und Automatisierungen werden ebenfalls korrekt umgestellt. Ihre Benutzer müssen sich bei Ihrem neuen Zendesk-Standort erneut anmelden. Ihre Profile und Ticketverläufe bleiben jedoch erhalten.

Führen Sie nach dem Ändern Ihrer Subdomäne die im folgenden Abschnitt beschriebenen Aufgaben aus.

Schritt 3: Aufgaben nach dem Umbenennen Ihrer Subdomäne

Nachdem Sie Ihre Subdomäne umbenannt haben, sollten Sie die folgenden Objekte aktualisieren:

• Vereinbarungen zum Teilen von Tickets
• Darstellung der Kundenzufriedenheitsbewertungen/Web Widget
• Ticketantworten
• Mobile SDK
• Zendesk Talk
• API-Tokens/-Credentials
• Single-Sign-On
• Zendesk Chat

Vereinbarungen zum Teilen von Tickets

Wenn Sie über aktive Vereinbarungen zum Teilen von Tickets verfügen, müssen Sie diese nach dem Ändern Ihrer Subdomäne deaktivieren und neu erstellen. Dazu gehören auch Vereinbarungen zum Teilen von Tickets, die als Empfänger fungieren. Dies bedeutet, dass die Administratoren der betreffenden Zendesk-Konten die Vereinbarungen zum Teilen neu erstellen müssen, um die URL Ihres Zendesk-Kontos zu aktualisieren.

Das Teilen einzelner Tickets funktioniert ebenfalls nicht mehr. Nachdem Sie Ihre Subdomäne umbenannt und Ihre Teilungsvereinbarungen aktualisiert haben, müssen Sie alle geteilten Tickets manuell aktualisieren, um sie an die neue Teilungsvereinbarung anzugleichen.

Darstellung der Kundenzufriedenheitsbewertungen/Web Widget

Wenn Sie über Widgets verfügen, müssen Sie diese nach dem Ändern Ihrer Subdomäne aktualisieren. Sie müssen auch die jQuery aktualisieren, wenn Sie Änderungen an der Darstellung der Kundenzufriedenheitsbewertungen vorgenommen haben. Weitere Informationen zum Aktualisieren Ihrer Kundenzufriedenheitsbewertungen im JSON-Format finden Sie unter Anzeigen der letzten 100 Zufriedenheitsbewertungen.

Sie müssen die Widgets für Ihr Help Center und Ihre Website einzeln aktualisieren, nachdem Sie Ihre Subdomäne umbenannt haben.

So aktualisieren Sie das Web Widget:

1. Klicken Sie in der Seitenleiste auf das Symbol Admin () und dann auf Kanäle > Widget.
2. Klicken Sie auf die Registerkarte Setup, sofern sie noch nicht ausgewählt ist.
3. Klicken Sie unter dem Feld mit dem Code auf In Zwischenablage kopieren.
   
4. Um das Widget in Ihrer Website zu bearbeiten, gehen Sie zu der Webseite, der Sie das Widget hinzufügen möchten, und fügen Sie den aktualisierten Code vor dem abschließenden HTML </HEAD>-Tag ein. Sie müssen den Code zu jeder Webseite hinzufügen, auf der das Widget aktualisiert werden soll.

So aktualisieren Sie das Help-Center-Widget:

1. Klicken Sie im Werkzeugbereich des Help Centers auf Erscheinungsbild anpassen und dann auf Bearbeiten.
2. Wählen Sie im Dropdownmenü die Header-Vorlage aus.
3. Löschen Sie den vorhandenen Help-Center-Widget-Code.
4. Fügen Sie den aktualisierten Code vor dem </HEADER>-Tag ein.
5. Klicken Sie auf Speichern und dann auf Änderungen veröffentlichen.

Weitere Informationen zum Aktualisieren Ihrer Widgets finden Sie unter Einbetten von Kundenserviceoptionen in Ihre Website anhand des Web Widgets.

Ticketantworten

Wenn Sie E-Mail-Benachrichtigungen verwenden, werden Kundenantworten auf Benachrichtigungen zu offenen oder wartenden Tickets, die vor dem Umbenennen der Subdomäne gesendet wurden, weder in Ihrem Konto empfangen noch als Aktualisierungen zu den entsprechenden Tickets hinzugefügt. Alle Ticket-URLs in E-Mail-Benachrichtigungen, die vor Umbenennung der Subdomäne gesendet wurden, sind jetzt ebenfalls ungültig. Um dies zu korrigieren, sollten Sie alle betroffenen Tickets mit einem öffentlichen Kommentar aktualisieren, nachdem Sie Ihre Subdomäne umbenannt haben.

Erstellen Sie als Erstes eine Ansicht aller ungelösten Tickets in Ihrer Zendesk Support-Instanz. Wenn Sie keine größeren Anpassungen vorgenommen haben, ist diese Ansicht möglicherweise bereits in Ihrem Konto aktiv.

In dieser Ansicht können Sie mit einem einzigen Schritt einen Kommentar zu allen Tickets hinzufügen. Die neue Antwortadresse ist nun gültig und wird mit dem Platzhalter {{ticket.URL}} in die aktualisierte Ticket-URL eingefügt.

Hinweis: Sie können keine Anhänge in Tickets öffnen, die bereits vor dem Umbenennen der Subdomäne vorhanden waren. Senden Sie bei Bedarf eine E-Mail an [e-mail].

Mobile SDK

Sie müssen den Code im Mobile SDK aktualisieren, damit er nach der Umbenennung der Subdomäne auf die richtige Zendesk-URL verweist.

So aktualisieren Sie das Mobile SDK:

1. Gehen Sie zu Admin > Kanäle > Mobile SDK.
2. Machen Sie das Code-Snippet mit Ihrer Subdomäne im Android- und iOS-Code ausfindig.
3. Leiten Sie die aktualisierten Code-Snippets an Ihren Entwickler weiter. 

Zendesk Talk

Wenn nach Umbenennung Ihrer Subdomäne Probleme mit Zendesk Talk auftreten, senden Sie eine Anfrage an unser Kundenserviceteam ([e-mail]).

API-Authentifizierung

Wenn Sie die Zendesk-API verwenden, um in Ihrem Konto Daten abzurufen oder zu senden, müssen Sie die Subdomäne aktualisieren, auf die Sie verweisen, damit der API-Aufruf nicht fehlschlägt.

Beispiel:

https://{OLDsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password}
https://{NEWsubdomain}.zendesk.com/api/v2/tickets.json \ -v -u {email_address}:{password}

Wenn sich Ihre E-Mail Adresse oder die Ihrer Agenten geändert hat, müssen Sie möglicherweise Ihre API-Token oder -Credentials aktualisieren. Weitere Informationen finden Sie in unseren Support Tech Notes unter Generieren eines neuen API-Tokens.

Single-Sign-On

Sowohl SAML als auch JWT übergeben die SSO-Anforderungen an die Zendesk Access Consumer URL, die Ihre Subdomäne referenziert. Sie können sich erst dann über SSO anmelden, wenn Sie die Subdomäne aktualisieren.

Weitere Informationen zur Einrichtung von SSO finden Sie unter Verwenden von SAML für das Single-Sign-On (Professional und Enterprise) und Einrichten des Single-Sign-On mit JWT (JSON Web Token).

Zendesk Chat

Wenn Sie Zendesk Chat ursprünglich separat abonniert und dann Ihr Chat-Konto mit Ihrem Support-Konto verknüpft haben, werden von Ihrem Chat-Konto aus keine Tickets erstellt. Sie müssen sich an unser Kundenserviceteam wenden, um Änderungen vorzunehmen.

Wenn Sie Zendesk Chat und Zendesk Support zusammen abonniert haben, werden die Aktualisierungen automatisch vorgenommen; von Ihrer Seite aus ist keine Aktion erforderlich.