Intégrer Zendesk

L’intégration Zendesk vous permet d’envoyer et de surveiller des demandes à partir de n’importe quel appareil, site intranet ou n’importe quelle messagerie instantanée.

Utilisez la procédure suivante pour activer l’intégration Zendesk. Assurez-vous de remplir les conditions préalables, puis obtenez votre ID du client et la clé secrète client. Une fois ce processus terminé, votre niveau de journalisation d’audit existant est conservé, y compris toute action effectuée par l’utilisation des micro-apps Citrix.

Pour obtenir une liste complète des micro-apps Zendesk prêtes à l’emploi, consultez la section Utiliser les micro-apps Zendesk.

Vérifier les conditions préalables

Créez un compte Zendesk dédié et utilisez-le pour configurer l’intégration Zendesk. Ce compte doit disposer d’un rôle avec des privilèges d’accès complet aux données, tels que le rôle Administrateur. Une fois l’intégration dans Zendesk configurée, vous aurez besoin de ces artefacts pour ajouter l’intégration dans les micro-apps Citrix Workspace :

  • URL
  • ID client
  • Clé secrète client
  • Compte
  • Mot de passe

Les conditions préalables suivantes doivent être remplies avant de commencer le processus d’intégration :

  • Configurez Citrix Gateway pour prendre en charge l’authentification unique pour Zendesk : une fois que les utilisateurs se connectent, ils sont automatiquement reconnectés sans avoir à entrer leurs informations d’identification une seconde fois. Suivez les instructions de l’article Configuration de l’authentification unique pour Zendesk. Pour plus d’informations sur la configuration de l’authentification unique (SSO, Single Sign-ON), consultez la section Citrix Gateway Service.

Configurer l’intégration Zendesk

  1. Connectez-vous à www.zendesk.com avec le compte utilisateur dédié.
  2. Sélectionnez Admin (icône de paramètres) dans la barre latérale gauche. Sous Channels, sélectionnez API.
  3. Sélectionnez l’onglet OAuth Clients, puis sélectionnez l’icône + (plus).
  4. Entrez un nom de client pour votre application dans le champ Client Name.
  5. (Facultatif) Renseignez les champs Description, Company et Logo.
  6. Copiez la valeur d’identificateur unique automatiquement renseignée (Unique Identifier) pour une utilisation ultérieure.
  7. Définissez les URL de redirection (Redirect URL) comme décrit ci-dessous.
  8. Sélectionnez Save et OK.
  9. Une fois la page actualisée, un nouveau champ Secret prérempli apparaît. Copiez la clé secrète (Secret Token) générée pour une utilisation ultérieure. Celle-ci n’est pas disponible une fois que vous quittez cet écran.
  10. Sélectionnez Save.

Vous êtes prêt à terminer l’intégration dans les micro-apps Citrix Workspace.

Ajouter des URL de rappel

Ajoutez une adresse URL personnalisée à votre configuration d’instance pour accorder l’accès aux données privées et activer les actions utilisateur authentifiées par OAuth. Le premier rappel répertorié ne change pas. Le second rappel dépend de l’application cible et se trouve dans votre barre d’adresse URL lors de la création de l’intégration. La section {yourmicroappserverurl} est composée d’une partie locataire, d’une partie région et d’une partie environnement : https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Connectez-vous à Zendesk en tant qu’administrateur et ajoutez les URL de redirection autorisées suivantes pour cette intégration :

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

Ajouter l’intégration aux micro-apps Citrix Workspace

Ajoutez l’intégration Zendesk aux micro-apps Citrix Workspace pour vous connecter à votre application. Des micro-apps prêtes à l’emploi sont proposées, ainsi que des notifications et des actions préconfigurées qui sont prêtes à être utilisées dans votre espace de travail.

Procédez comme suit :

  1. Dans la page de vue d’ensemble, sélectionnez Démarrer.

    La page Gérer les intégrations s’ouvre.

  2. Sélectionnez Ajouter une nouvelle intégration et Ajouter une nouvelle intégration à partir des modèles fournis par Citrix.
  3. Choisissez la vignette Zendesk.
  4. Donnez un nom à l’intégration.

    Paramètres du connecteur Zendesk : URL, ID du client, Clé secrète client, Tickets – Nombre de mois à charger

  5. Renseignez la section Paramètres du connecteur avec les éléments requis que vous avez obtenus.
    • Entrez l’URL de l’instance.
    • Renseignez le champ ID du client. Cette valeur est l’identificateur unique que vous avez obtenu lorsque vous avez enregistré votre application auprès de Zendesk.
    • Entrez la Clé secrète client. Cette valeur est la clé secrète que vous avez copiée lorsque vous avez enregistré votre application auprès de Zendesk.
    • Sélectionnez une valeur pour Tickets – Nombre de mois à charger.
  6. Sélectionnez Se connecter avec le compte Zendesk pour activer l’autorisation OAuth. Une page de connexion Zendesk s’ouvre dans un nouvel onglet. Vous êtes invité à entrer un nom de compte, à confirmer l’accès et à entrer un mot de passe.
  7. Sélectionnez Ajouter.

La page Intégrations de micro-apps s’ouvre avec votre intégration ajoutée et ses micro-apps associées. À partir de là, vous pouvez ajouter une autre intégration, continuer à configurer vos micro-apps prêtes à l’emploi ou créer une nouvelle micro-app pour cette intégration.

Vous êtes maintenant prêt à définir et exécuter votre première synchronisation de données. Vous pouvez extraire une grande quantité de données de vos applications intégrées vers la plate-forme de micro-apps. Par conséquent, nous vous recommandons d’utiliser la page Tableau pour filtrer les entités de votre première synchronisation de données afin d’accélérer la synchronisation.

Pour plus d’informations, consultez les sections Vérifier les entités requises et Définir la synchronisation des données dans l’article Configurer l’intégration.

Pour plus d’informations sur les points de terminaison d’API et les entités de table, consultez la section Spécifications du connecteur Zendesk.

Utiliser les micro-apps Zendesk

Les intégrations d’application existantes sont fournies avec des micro-apps prêtes à l’emploi. Commencez avec ces micro-apps et personnalisez-les en fonction de vos besoins.

Micro-app Zendesk

L’intégration Zendesk est fournie avec les micro-apps prêtes à l’emploi préconfigurées suivantes :

Ajouter un ticket : permet d’envoyer des tickets Zendesk.

Notification ou Page Workflows de cas d’utilisation
Page Soumettre ticket Fournit un formulaire permettant de soumettre un ticket.

Tickets : permet d’afficher les tickets Zendesk, ainsi que les détails correspondants.

Notification ou Page Workflows de cas d’utilisation
Notification Ticket qui vous a été attribué (modifié) Lorsqu’un ticket existant est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Ticket qui vous a été attribué (nouveau) Lorsqu’un nouveau ticket est attribué à un utilisateur, celui-ci reçoit une notification.
Notification Changement de l’état du ticket Lorsque l’état d’un ticket est modifié, l’utilisateur ayant envoyé le ticket reçoit une notification.
Notification Ticket mis à jour Lorsqu’un ticket est mis à jour, l’utilisateur ayant envoyé le ticket reçoit une notification.
Page Mes tickets Fournit une liste personnalisée des tickets liés à un utilisateur, ainsi qu’un lien vers les détails des tickets.
Page Détails du ticket Fournit une vue en lecture seule d’un ticket et de ses détails correspondants.