Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Intégration à Zendesk Suite
Gérez vos tickets d'assistance Zendesk directement depuis Amazon Quick en langage naturel. Avec le connecteur d'action Zendesk Suite, vous pouvez créer, mettre à jour, rechercher et répertorier des tickets d'assistance sans quitter Amazon Quick.
Zendesk Suite est disponible sous forme de connecteur intégré dans Amazon Quick. Pour configurer cette intégration, effectuez les deux étapes suivantes. Tout d'abord, préparez votre compte Zendesk avec les accès requis. Créez ensuite le connecteur dans Amazon Quick et authentifiez-vous avec vos informations d'identification Zendesk.
Ce connecteur prend en charge l'authentification utilisateur OAuth et l'authentification par service de clé API. Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.
Conditions préalables
Avant de configurer l'intégration, vérifiez que vous disposez des ressources et des accès suivants.
-
Un compte Zendesk actif avec un rôle d'administrateur.
-
Autorisations pour accéder aux tickets et aux données d'assistance dans votre instance Zendesk.
-
Un abonnement qui répond aux exigences décrites dansConfiguration des intégrations dans la console.
Vérifiez votre compte Zendesk
Avant de configurer Amazon Quick, vérifiez que votre compte Zendesk répond aux exigences suivantes.
-
Votre compte Zendesk est actif et vous pouvez vous connecter à la page de connexion Zendesk
sur le site Web de Zendesk. -
Les tickets et les données d'assistance auxquels vous souhaitez accéder sont accessibles sur votre compte.
Configurer le compte Zendesk
La méthode d'authentification personnalisée de l'application OAuth dans Amazon Quick nécessite un client OAuth configuré dans Zendesk. La méthode d'authentification par clé d'API nécessite un jeton d'API.
Pour configurer un client OAuth
-
Dans votre instance Zendesk, accédez au Centre d'administration, puis à Applications et intégrations, puis aux clients OAuth sous API.
-
Choisissez Ajouter un client OAuth.
-
Complétez le formulaire avec les champs suivants :
-
Nom — Entrez le nom de votre application.
-
Description — Entrez une brève description.
-
Identifiant — Entrez un identifiant unique pour le client OAuth.
-
URL de redirection — Entrez
https://. Remplacezregion.quicksight.aws.amazon.com/sn/oauthcallbackregionpar votre AWS région, par exemple,us-east-1.
-
-
Choisissez Enregistrer. Zendesk génère un secret client.
Important
Enregistrez le secret du client maintenant. Vous ne pouvez pas le récupérer une fois que vous avez quitté cette page.
-
Après avoir capturé le secret, choisissez à nouveau Enregistrer pour créer le client OAuth.
L'identifiant et le secret servent d'ID client et de secret client lorsque vous configurez le connecteur d'action dans Amazon Quick avec la méthode d'authentification personnalisée de l'application OAuth.
Pour plus d'informations, consultez Utiliser l'authentification OAuth avec votre application
Pour configurer un jeton d'API
-
Accédez au Centre d'administration, puis à Applications et intégrations, puis aux jetons d'API.
-
Choisissez Ajouter un jeton d'API.
-
Dans Description, entrez une brève description du jeton d'API.
-
Choisissez Enregistrer. Zendesk génère un jeton d'API.
Important
Enregistrez le jeton d'API maintenant. Vous ne pouvez pas le récupérer une fois que vous avez quitté cette page.
Si vous choisissez la méthode d'authentification par clé d'API dans Amazon Quick, utilisez ce jeton d'API comme valeur de clé d'API.
Pour plus d'informations, consultez Gestion de l'accès par jeton d'API à l'API Zendesk
Configurer l'intégration dans Amazon Quick
Après avoir vérifié l'accès à votre compte Zendesk, créez le connecteur dans Amazon Quick.
-
Dans la console Amazon Quick, choisissez Connectors.
-
Choisissez l'onglet Créer pour votre équipe.
-
Choisissez Zendesk Suite parmi les options disponibles.
-
Dans la boîte de dialogue Zendesk Suite, entrez les champs suivants :
-
Nom : nom descriptif de votre connecteur Zendesk.
-
Description (facultatif) — Choisissez + Ajouter une description pour ajouter des notes sur la façon dont ce connecteur sera utilisé.
-
Type de connexion — Choisissez Réseau public.
-
-
Choisissez votre méthode d'authentification et configurez les paramètres du connecteur :
-
Application OAuth personnalisée : entrez les champs suivants pour votre instance Zendesk :
-
URL de base
-
Identifiant du client
-
Secret du client
-
URL du jeton
-
URL d'autorisation
-
URL de redirection
-
-
Clé API — Entrez les champs suivants :
-
URL de base
-
Clé d'API (jeton d'API Zendesk)
-
E-mail associé à votre compte Zendesk
-
-
-
Choisissez Suivant.
-
Passez en revue les actions de Zendesk Suite et choisissez Next.
-
Spécifiez qui peut accéder au connecteur :
-
Pour partager avec une équipe, entrez le nom de l'équipe ou l'e-mail du groupe.
-
Pour qu'il reste privé, laissez le champ vide.
-
Pour partager avec tous les utilisateurs, sélectionnez Tous les membres de votre organisation.
-
-
Choisissez Publier.
Le connecteur apparaît dans le panneau Disponible avec l'état Connecté.
Actions disponibles
Après avoir configuré le connecteur, vous pouvez utiliser les actions de gestion des tickets suivantes.
| Action | Description |
|---|---|
| Créer un ticket | Créer un nouveau ticket |
| Liste des résultats de recherche | Rechercher des billets |
| Liste des billets | Voir tous les billets |
| Afficher le billet | Afficher les détails du billet |
| Mettre à jour le ticket | Modifier les détails du billet |
Note
Les actions que vous pouvez utiliser dépendent des autorisations configurées dans votre compte Zendesk.
Résolution des problèmes
Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.
Problèmes d’authentification
-
Sign-in échoue : vérifiez que votre compte Zendesk est actif et que vous pouvez vous connecter à la page de connexion Zendesk
sur le site Web de Zendesk. Si votre organisation utilise l'authentification unique (SSO), vérifiez que votre fournisseur d'identité est correctement configuré. -
Accès refusé — Vérifiez que votre utilisateur Zendesk possède un rôle d'administrateur autorisé à accéder aux tickets et aux données d'assistance. Pour les connexions par clé d'API, vérifiez que le jeton d'API est valide et que l'adresse e-mail associée est correcte.
