Créer une connexion source Zendesk dans l’interface utilisateur
Ce tutoriel décrit les étapes à suivre pour créer une connexion source Zendesk à l’aide de l’interface utilisateur de Adobe Experience Platform.
Prise en main
Ce tutoriel nécessite une compréhension du fonctionnement des composants suivants d’Adobe Experience Platform :
-
Experience Data Model (XDM) Système : le cadre normalisé en fonction duquel Experience Platform organise les données d’expérience client.
- Principes de base de la composition des schémas : découvrez les blocs de création de base des schémas XDM, y compris les principes clés et les bonnes pratiques en matière de composition de schémas.
- Tutoriel sur l’éditeur de schémas : découvrez comment créer des schémas personnalisés à l’aide de l’interface utilisateur de l’éditeur de schémas.
-
Real-Time Customer Profile : fournit un profil de consommateur unifié en temps réel, basé sur des données agrégées provenant de plusieurs sources.
Collecter les informations d’identification requises
Pour accéder à votre compte Zendesk sur Platform, vous devez fournir des valeurs pour les informations d’identification suivantes :
yoursubdomain
0lZnClEvkJSTQ7olGLl7PMhVq99gu26GTbJtf
Pour plus d’informations sur l’authentification de votre source Zendesk, consultez la Zendesk présentation de la source.
Création d’un schéma de plateforme pour Zendesk
Avant de créer une connexion source Zendesk, vous devez également vous assurer de créer au préalable un schéma de plateforme à utiliser pour votre source. Consultez le tutoriel sur la création d’un schéma de plateforme pour obtenir des instructions complètes sur la création d’un schéma.
Pour plus d'informations sur votre schéma Zendesk requis pour Zendesk Search API, reportez-vous à la section limites ci-dessous.
Connecter votre compte Zendesk
Dans l’interface utilisateur de Platform, sélectionnez Sources à partir de la barre de navigation de gauche pour accéder à l’espace de travail Sources. L’écran Catalogue affiche diverses sources avec lesquelles vous pouvez créer un compte.
Vous pouvez sélectionner la catégorie appropriée dans le catalogue sur le côté gauche de votre écran. Vous pouvez également trouver la source spécifique à utiliser à l’aide de l’option de recherche.
Sous la catégorie Succès client, sélectionnez Zendesk, puis sélectionnez Ajouter des données.
La page Se connecter au compte Zendesk s’affiche. Sur cette page, vous pouvez utiliser de nouvelles informations d’identification ou des informations d’identification existantes.
Compte existant
Pour utiliser un compte existant, sélectionnez le compte Zendesk avec lequel vous souhaitez créer un nouveau flux de données, puis sélectionnez Suivant pour continuer.
Nouveau compte
Si vous créez un compte, sélectionnez Nouveau compte, puis fournissez un nom, une description facultative et vos informations d’identification. Lorsque vous avez terminé, sélectionnez Connexion à la source, puis patientez quelques instants le temps que la nouvelle connexion sʼétablisse.
Sélectionner les données
Une fois votre source authentifiée, la page se met à jour dans une arborescence de schémas interactifs qui vous permet d’explorer et d’inspecter la hiérarchie de vos données. Sélectionnez Suivant pour continuer.
Étapes suivantes
En suivant ce tutoriel, vous avez authentifié et avez créé une connexion source entre votre compte Zendesk et Platform. Vous pouvez maintenant passer au tutoriel suivant et créer un flux de données pour importer les données de succès client dans Platform.
Ressources supplémentaires
Les sections ci-dessous fournissent des ressources supplémentaires auxquelles vous pouvez vous référer lors de l’utilisation de la source Zendesk.
Validation validation
Les étapes suivantes décrivent les étapes que vous pouvez suivre pour vérifier que vous avez correctement connecté votre source Zendesk et que les profils Zendesk sont ingérés dans Platform.
Dans l’interface utilisateur de Platform, sélectionnez Jeux de données dans le volet de navigation de gauche pour accéder à l’espace de travail Jeux de données. L’écran Activité du jeu de données affiche les détails des exécutions.
Sélectionnez ensuite l’identifiant d’exécution du flux de données que vous souhaitez afficher pour afficher des détails spécifiques sur cette exécution.
Enfin, sélectionnez Prévisualiser le jeu de données pour afficher les données ingérées.
Vous pouvez également comparer vos données Platform aux données de votre page Zendesk > Customers.
Schéma Zendesk
Le tableau ci-dessous répertorie les mappages pris en charge qui doivent être configurés pour Zendesk.
results.active
results.alias
results.created_at
results.custom_role_id
results.default_group_id
results.details
results.email
results.external_id
results.iana_time_zone
results.id
results.last_login_at
results.locale
results.locale_id
results.moderator
results.name
results.notes
results.only_private_comments
results.organization_id
results.phone
results.photo
results.report_csv
results.restricted_agent
results.result_type
results.role
results.role_type
results.shared
results.shared_agent
results.shared_phone_number
results.signature
results.suspended
results.ticket_restriction
results.time_zone
results.two_factor_auth_enabled
results.updated_at
results.url
results.verified
Limites limits
-
L’ API de recherche Zendesk > Exporter les résultats de recherche renvoie un maximum de 1 000 enregistrements par page.
- La valeur du paramètre
filter[type]
est définie suruser
et par conséquent, la connexion Zendesk renvoie uniquement les utilisateurs. - Le nombre de résultats par page est géré par le paramètre
page[size]
. La valeur est définie sur100
. Cela permet de réduire l'impact des contraintes de réduction de vitesse définies par Zendesk. - Voir Limites et Pagination.
- Vous pouvez également vous reporter à la section Pagination des listes à l’aide de la pagination du curseur.
- La valeur du paramètre