Mikroapps

Integration von Zendesk

Durch Integration mit Zendesk können Sie von einem beliebigen Gerät, Intranet oder Messengerdienst Anforderungen einreichen und überwachen.

Zum Aktivieren der Zendesk-Integration führen Sie folgende Schritte aus. Stellen Sie sicher, dass Sie die Voraussetzungen erfüllen, und erfassen Sie Ihre Client-ID und den Tokenschlüssel. Nachdem Sie diesen Vorgang abgeschlossen haben, wird die vorhandene Überwachungsprotokollierung beibehalten, einschließlich aller Aktionen, die mit Citrix Mikroapps ausgeführt werden.

Eine Liste aller vorgefertigten Zendesk-Mikroapps finden Sie unterVerwenden von Zendesk-Mikroapps.

Prüfung der Voraussetzungen

Erstellen Sie ein dediziertes Zendesk-Konto und verwenden Sie es zum Einrichten der Zendesk-Integration. Dieses Konto muss über eine zugewiesene Rolle mit vollen Datenzugriffsrechten verfügen, z. B. Administrator. Nach dem Einrichten dieser Integration in Zendesk benötigen Sie folgende Angaben, um die Integration in Citrix Workspace-Mikroapps hinzuzufügen:

  • URL
  • Client-ID
  • Geheimer Clientschlüssel
  • Konto
  • Kennwort

Vor Beginn der Integration müssen folgende Voraussetzungen erfüllt sein:

  • Konfigurieren Sie in Citrix Gateway die Unterstützung für Single Sign-On für Zendesk, damit Benutzer sich nur einmal anmelden und ihre Anmeldeinformationen nicht erneut eingeben müssen. Folgen Sie den Anweisungen unter Konfigurieren von Single Sign-On für Zendesk. Weitere Hinweise zum Konfigurieren von SSO finden Sie unter Citrix Gateway Service.

Einrichten der Zendesk-Integration

  1. Melden Sie sich mit dem dedizierten Benutzerkonto bei www.zendesk.com an.
  2. Wählen Sie in der linken Randleiste das Einstellungssymbol Admin. Wählen Sie unter Channels die Option API.
  3. Wählen Sie die Registerkarte OAuth Clients und dann das Pluszeichen (+).
  4. Geben Sie einen Clientnamen für die App ein.
  5. (Optional) Fügen Sie eine Beschreibung, ein Unternehmen und ein Logo hinzu.
  6. Kopieren Sie den unter Unique Identifier angezeigten Wert für den eindeutigen Bezeichner, da Sie ihn später benötigen.
  7. Richten Sie Umleitungs-URLs wie unten beschrieben ein.
  8. Wählen Sie Speichern und OK.
  9. Nachdem die Seite aktualisiert wurde, wird ein neues vorausgefülltes Feld “Secret” angezeigt. Kopieren Sie den unter Secret Token angezeigten Tokenschlüssel für die spätere Verwendung. Er ist nach dem Verlassen dieses Bildschirms nicht mehr verfügbar.
  10. Wählen Sie Speichern.

Jetzt können Sie die Integration in Citrix Workspace-Mikroapps abschließen.

Hinzufügen von Rückruf-URLs

Fügen Sie Ihrer Instanzkonfiguration eine benutzerdefinierte URL hinzu, um Zugriff auf private Daten zu gewähren und OAuth-authentifizierte Benutzeraktionen zu aktivieren. Der erste Callback in der Liste ändert sich nicht. Der zweite Callback hängt von der Zielanwendung ab und ist beim Erstellen der Integration in Ihrer URL-Adressleiste zu finden. Der Abschnitt {yourmicroappserverurl} setzt sich zusammen aus dem Mandanten, der Region und der Umgebung: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Melden Sie sich als Administrator bei Zendesk an und fügen Sie die folgenden autorisierten Umleitungs-URLs für diese Integration hinzu:

  • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.zendesk.ZendeskService/auth/serverContext
  • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Hinzufügen der Integration zu Citrix Workspace Mikroapps

Fügen Sie die Zendesk-Integration zu Citrix Workspace-Mikroapps hinzu, um eine Verbindung zu Ihrer Anwendung herzustellen. Dadurch werden vorkonfigurierte Mikroapps mit Benachrichtigungen und Aktionen bereitgestellt, die in Ihrem Workspace sofort einsatzbereit sind.

Führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf der Seite “Übersicht” auf Starten.

    Die Seite “Integrationen verwalten” wird geöffnet.

  2. Wählen Sie Neue Integration hinzufügen und Neue Integration aus Citrix-Vorlagen hinzufügen.
  3. Wählen Sie die Zendesk-Kachel.
  4. Geben Sie einen Namen für die Integration ein.

    Zendesk-Connectorparameter, URL, Client-ID, geheimer Clientschlüssel, Zeitraum für zu ladende Tickets (Monate)

  5. Geben Sie die Connectorparameter ein, die Sie im Verfahren unter “Voraussetzungen” erfasst haben.
    • Geben Sie die Instanz-URL ein.
    • Geben Sie die Client-ID ein. Dieser Wert ist der eindeutige Bezeichner, den Sie beim Registrieren Ihrer Anwendung bei Zendesk erhalten haben.
    • Geben Sie das Clientgeheimnis ein. Dieser Wert ist das Geheimnis, das Sie beim Registrieren Ihrer Anwendung bei Zendesk kopiert haben.
    • Wählen Sie einen Zeitraum für Tickets laden (Monate).
  6. Wählen Sie Mit Zendesk-Konto anmelden, um die OAuth-Autorisierung zu aktivieren. Eine Zendesk-Anmeldeseite wird auf einer neuen Registerkarte geöffnet. Sie werden aufgefordert, einen Kontonamen einzugeben, den Zugriff zu bestätigen und ein Kennwort einzugeben.
  7. Wählen Sie Hinzufügen.

Die Seite Mikroappintegrationen wird geöffnet und zeigt die hinzugefügte Integration mit zugehörigen Mikroapps an. Hier können Sie eine weitere Integration hinzufügen, vorkonfigurierte Mikroapps einrichten oder eine neue Mikroapp für diese Integration erstellen.

Sie können nun die erste Datensynchronisierung festlegen und ausführen. Da unter Umständen eine große Datenmenge von Ihrer integrierten Anwendung zur Mikroapps-Plattform übermittelt wird, empfehlen wir, für die erste Datensynchronisierung auf der Seite Tabelle Entitäten zu filtern, um die Synchronisierung zu beschleunigen.

Weitere Informationen finden Sie unter Überprüfen erforderlicher Entitäten und Festlegen der Datensynchronisierung im Artikel zum Konfigurieren der Integration.

Weitere Informationen zu API-Endpunkten und Tabellenentitäten finden Sie unter Zendesk-Connectorspezifikationen.

Verwenden von Zendesk-Mikroapps

Vorhandene Anwendungsintegrationen werden mit vorkonfigurierten Mikroapps geliefert. Beginnen Sie mit diesen Mikroapps und passen Sie sie an Ihre Erfordernisse an.

Zendesk-Mikroapp

Unsere Integration von Zendesk bietet folgende vorkonfigurierte Mikroapps:

Ticket hinzufügen: Erstellen von Zendesk-Tickets.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Seite “Ticket erstellen” Formular zum Erstellen eines Tickets.

Tickets: Anzeigen von Zendesk-Tickets mit Details.

Benachrichtigung oder Seite Workflows für Anwendungsfälle
Benachrichtigung: Neues Ticket wurde Ihnen zugewiesen (geändert) Wenn einem Benutzer ein vorhandenes Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Neues Ticket wurde Ihnen zugewiesen (neu) Wenn einem Benutzer ein neues Ticket zugewiesen wird, erhält er eine Benachrichtigung.
Benachrichtigung: Ticketstatusänderung Wenn der Status eines Tickets geändert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Benachrichtigung: Ticket wurde aktualisiert Wenn ein Ticket aktualisiert wird, wird der Benutzer benachrichtigt, der das Ticket erstellt hat.
Seite “Meine Tickets” Personalisierte Liste der Tickets zu einem Benutzer mit Link zu den Ticketdetails.
Seite “Ticketdetails” Schreibgeschützte Ansicht eines Tickets mit Details.

Integration von Zendesk