View a markdown version of this page

Zendesk Suite-Integration - Amazon Quick

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

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 unterAuthentifizierungsmethoden.

Voraussetzungen

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

Verifizieren Sie Ihr Zendesk-Konto

Bevor Sie Amazon Quick konfigurieren, stellen Sie sicher, dass Ihr Zendesk-Konto die folgenden Anforderungen erfüllt.

Konfigurieren Sie das Zendesk-Konto

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

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

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

  3. 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 regionErsetzen Sie es durch Ihre AWS Region, zum Beispielus-east-1.

  4. 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.

  5. 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 auf der Zendesk-Website.

So konfigurieren Sie ein API-Token

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

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

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

  4. 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 auf der Zendesk-Website.

Richten Sie die Integration in Amazon Quick ein

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.

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

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

  4. 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.

  5. 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

  6. Wählen Sie Weiter aus.

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

  8. 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.

  9. Wählen Sie Publish.

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

Verfügbare Aktionen

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

Informationen zum Bearbeiten, Teilen oder Löschen Ihres Connectors finden Sie unterVerwaltung vorhandener Integrationen.

Probleme bei der Authentifizierung

  • 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 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.