

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Zendesk Suite-Integration
<a name="zendesk-integration"></a>

Verwalten Sie Ihre Zendesk-Supporttickets direkt von Amazon Quick aus in natürlicher Sprache. Mit dem Zendesk Suite Action Connector können Sie Supporttickets erstellen, aktualisieren, suchen und auflisten, ohne Amazon Quick verlassen zu müssen.

Zendesk Suite ist als integrierter Connector in Amazon Quick verfügbar. Um diese Integration einzurichten, führen Sie die folgenden zwei Schritte aus. Bereiten Sie zunächst Ihr Zendesk-Konto mit dem erforderlichen Zugriff vor. Erstellen Sie dann den Connector in Amazon Quick und authentifizieren Sie sich mit Ihren Zendesk-Anmeldeinformationen.

Dieser Connector unterstützt die OAuth-Benutzerauthentifizierung und die API-Schlüsseldienstauthentifizierung. Informationen zu den Authentifizierungsmethoden, die Amazon Quick unterstützt, finden Sie unter[Authentifizierungsmethoden](quick-action-auth.md).

## Voraussetzungen
<a name="zendesk-integration-prerequisites"></a>

Bevor Sie die Integration einrichten, stellen Sie sicher, dass Sie über die folgenden Ressourcen und den folgenden Zugriff verfügen.
+ Ein aktives Zendesk-Konto mit einer Administratorrolle.
+ Berechtigungen für den Zugriff auf Tickets und Supportdaten in Ihrer Zendesk-Instanz.
+ Ein Abonnement, das die unter beschriebenen Anforderungen erfüllt. [Integrationen in der Konsole einrichten](integration-console-setup-process.md)

## Verifizieren Sie Ihr Zendesk-Konto
<a name="zendesk-account-setup"></a>

Bevor Sie Amazon Quick konfigurieren, stellen Sie sicher, dass Ihr Zendesk-Konto die folgenden Anforderungen erfüllt.
+ Ihr Zendesk-Konto ist aktiv und Sie können sich auf der [Zendesk-Anmeldeseite auf der Zendesk-Website](https://www.zendesk.com/login/) anmelden.
+ Die Tickets und Supportdaten, auf die Sie zugreifen möchten, sind für Ihr Konto zugänglich.

## Konfigurieren Sie das Zendesk-Konto
<a name="zendesk-configure-account"></a>

Die benutzerdefinierte OAuth-App-Authentifizierungsmethode in Amazon Quick erfordert einen in Zendesk konfigurierten OAuth-Client. Die API-Schlüssel-Authentifizierungsmethode erfordert ein API-Token.

### Um einen OAuth-Client zu konfigurieren
<a name="zendesk-configure-oauth"></a>

1. **Navigieren Sie in Ihrer Zendesk-Instanz zu **Admin Center**, dann zu **Apps und Integrationen und** dann unter API zu **OAuth-Clients**.**

1. **Wählen Sie „OAuth-Client hinzufügen“.**

1. Füllen Sie das Formular mit den folgenden Feldern aus:
   + **Name** — Geben Sie einen Namen für Ihre App ein.
   + **Beschreibung** — Geben Sie eine kurze Beschreibung ein.
   + **Kennung** — Geben Sie eine eindeutige Kennung für den OAuth-Client ein.
   + **URLs umleiten — Geben Sie** ein. `https://{{region}}.quicksight.aws.amazon.com/sn/oauthcallback` {{region}}Ersetzen Sie es durch Ihre AWS Region, zum Beispiel`us-east-1`.

1. Wählen Sie **Speichern**. Zendesk generiert ein Kundengeheimnis.
**Wichtig**  
Notieren Sie sich jetzt das Kundengeheimnis. Sie können es nicht abrufen, nachdem Sie diese Seite verlassen haben.

1. Nachdem Sie das Geheimnis erfasst haben, wählen Sie erneut **Speichern**, um den OAuth-Client zu erstellen.

Der Identifier und der Secret dienen als Client ID und Client Secret, wenn Sie den Action Connector in Amazon Quick mit der benutzerdefinierten OAuth-App-Authentifizierungsmethode konfigurieren.

Weitere Informationen finden Sie unter [Verwenden der OAuth-Authentifizierung mit Ihrer Anwendung](https://support.zendesk.com/hc/en-us/articles/4408845965210-Using-OAuth-authentication-with-your-application) auf der Zendesk-Website.

### So konfigurieren Sie ein API-Token
<a name="zendesk-configure-api-token"></a>

1. Navigieren Sie zu **Admin Center**, dann zu **Apps und Integrationen** und dann zu **API-Token**.

1. Wählen Sie **API-Token hinzufügen** aus.

1. Geben Sie unter **Beschreibung** eine kurze Beschreibung für das API-Token ein.

1. Wählen Sie **Speichern**. Zendesk generiert ein API-Token.
**Wichtig**  
Notieren Sie das API-Token jetzt. Sie können es nicht abrufen, nachdem Sie diese Seite verlassen haben.

Wenn Sie die API-Schlüsselauthentifizierungsmethode in Amazon Quick wählen, verwenden Sie dieses API-Token als API-Schlüsselwert.

Weitere Informationen finden Sie unter [Verwaltung des API-Token-Zugriffs auf die Zendesk-API](https://support.zendesk.com/hc/en-us/articles/4408889192858-Managing-API-token-access-to-the-Zendesk-API) auf der Zendesk-Website.

## Richten Sie die Integration in Amazon Quick ein
<a name="zendesk-integration-setup"></a>

Nachdem Sie den Zugriff auf Ihr Zendesk-Konto verifiziert haben, erstellen Sie den Connector in Amazon Quick.

1. Wählen Sie in der Amazon Quick-Konsole **Connectors** aus.

1. Wählen Sie den Tab „**Für Ihr Team erstellen**“.

1. Wählen Sie **Zendesk Suite** aus den verfügbaren Optionen aus. 

1. Geben Sie im **Zendesk Suite-Dialog** die folgenden Felder ein:
   + **Name** — Ein aussagekräftiger Name für Ihren Zendesk-Connector.
   + **Beschreibung (optional)** — Wählen Sie **\+ Beschreibung hinzufügen**, um Hinweise zur Verwendung dieses Connectors hinzuzufügen.
   + **Verbindungstyp** — Wählen Sie **Öffentliches Netzwerk**.

1. Wählen Sie Ihre Authentifizierungsmethode und konfigurieren Sie die Connector-Einstellungen:
   + **Benutzerdefinierte OAuth-App** — Geben Sie die folgenden Felder für Ihre Zendesk-Instanz ein:
     + **Basis-URL**
     + **Kunden-ID**
     + **Geheimes Kundenkonto**
     + **Token-URL**
     + **Autorisierungs-URL**
     + **URL umleiten**
   + **API-Schlüssel** — Geben Sie die folgenden Felder ein:
     + **Basis-URL**
     + **API-Schlüssel** (Zendesk-API-Token)
     + Mit Ihrem Zendesk-Konto verknüpfte **E-Mail**

1. Wählen Sie **Weiter** aus.

1. **Überprüfen Sie die Aktionen für Zendesk Suite und wählen Sie Weiter.**

1. Geben Sie an, wer auf den Connector zugreifen kann:
   + Um mit einem Team zu teilen, geben Sie einen Teamnamen oder eine Gruppen-E-Mail ein.
   + Um es privat zu halten, lassen Sie das Feld leer.
   + Um es für alle Benutzer freizugeben, aktivieren Sie die Option **Jeder in Ihrer Organisation**.

1. Wählen Sie **Publish**.

Der Connector wird im Bereich **Verfügbar** mit dem Status **Verbunden** angezeigt.

## Verfügbare Aktionen
<a name="zendesk-integration-actions"></a>

Nachdem Sie den Connector eingerichtet haben, können Sie die folgenden Ticketverwaltungsaktionen verwenden.


**Verfügbare Aktionen in der Zendesk Suite**  

| Action | Description | 
| --- | --- | 
| Ticket erstellen | Neues Ticket erstellen | 
| Suchergebnisse auflisten | Tickets suchen | 
| Tickets auflisten | Alle Tickets ansehen | 
| Ticket vorzeigen | Ticketdetails anzeigen | 
| Ticket aktualisieren | Ticketdetails bearbeiten | 

**Anmerkung**  
Die Aktionen, die Sie verwenden können, hängen von den Berechtigungen ab, die in Ihrem Zendesk-Konto konfiguriert sind.

## Fehlerbehebung
<a name="zendesk-integration-troubleshooting"></a>

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unter[Verwaltung vorhandener Integrationen](integration-workflows.md#managing-existing-integrations).

### Probleme bei der Authentifizierung
<a name="zendesk-troubleshooting-auth"></a>
+ **Sign-in schlägt fehl** — Stellen Sie sicher, dass Ihr Zendesk-Konto aktiv ist und dass Sie sich auf der [Zendesk-Anmeldeseite auf der Zendesk-Website](https://www.zendesk.com/login/) anmelden können. Wenn Ihre Organisation Single Sign-On (SSO) verwendet, vergewissern Sie sich, dass Ihr Identitätsanbieter korrekt konfiguriert ist.
+ **Zugriff verweigert** — Vergewissern Sie sich, dass Ihr Zendesk-Benutzer über eine Administratorrolle mit Berechtigungen für den Zugriff auf Tickets und Supportdaten verfügt. Stellen Sie bei API-Schlüsselverbindungen sicher, dass das API-Token gültig und die zugehörige E-Mail-Adresse korrekt ist.