Création d’objets personnalisés à intégrer aux données personnalisées

Accès rapide : Centre d’administration > Objets et règles > Objets personnalisés > Objets

Zendesk fournit de nombreux types d’objets de données natifs vous permettant de stocker et gérer vos données client, les tickets, les utilisateurs, les organisations, etc. Nous les appelons objets standards. Mais les objets standards ne peuvent pas fournir tous les types d’objets de données dont peut avoir besoin votre organisation. Les administrateurs peuvent créer des objets personnalisés pour capturer les données pour lesquelles les objets standards ne suffisent pas. En élargissant le modèle de données Zendesk avec les objets personnalisés, vous pourrez intégrer vos données personnalisées aux tickets, aux déclencheurs et aux analyses Explore en toute transparence.

Pour créer un objet personnalisé, vous devez créer l’objet, définir le schéma avec des champs personnalisés et connecter l’objet aux objets associés. Pour vos workflows, vous pouvez vouloir référencer vos objets personnalisés dans vos déclencheurs.

Cet article aborde les sujets suivants :

• Création d’un objet personnalisé
• Définition d’un schéma d’objet personnalisé avec des champs personnalisés
• Accès des agents aux objets personnalisés
• Ajout de relations d’objets

Articles connexes :

• Gestion des objets personnalisés
• Ajout d’enregistrements d’objets personnalisés pour capturer des données personnalisées
• Utilisation des objets personnalisés dans les déclencheurs

Création d’un objet personnalisé

Techniquement, un objet personnalisé se compose d’un nom, d’une clé et de champs. Le nom et la clé servent à identifier l’objet et les champs créent le schéma d’attributs de l’objet. Notez que le schéma ne contient pas d’informations au sujet d’une instance spécifique de l’objet : il décrit les informations que vous pouvez recueillir pour ce type d’objet. La création des objets personnalisés est consignée dans le journal des audits.

Avant de commencer à créer des objets personnalisés, nous vous conseillons de planifier votre workflow d’objets personnalisés.

Pour créer un objet personnalisé

1. Dans le Centre d’administration, cliquez sur Objets et règles () dans la barre latérale, puis sélectionnez Objets personnalisés > Objets.
2. Cliquez sur Créer un objet.
3. Saisissez les informations suivantes :
   • Nom : le nom de l’objet, comme le verront les agents.
   • Nom d’affichage au pluriel : la version du nom de l’objet au pluriel, à utiliser dans la navigation et les listes.
   • Clé d’objet : un identifiant unique pour cet objet. Pour éviter toute confusion au niveau des données, une clé d’objet ne peut pas être réutilisée, même si l’objet original qui utilisait cette clé a été supprimé.
   • (facultatif) Description : une description faite pour aider les autres administrateurs à comprendre à quoi sert l’objet. Si elle dépasse 92 caractères, la description est tronquée dans la liste de la page des objets.

   

4. Cliquez sur Créer un objet.
5. Cliquez sur l’onglet Champs pour ajouter des champs personnalisés à l’objet. Ce sont eux qui créent le schéma ou les propriétés de l’objet.
6. Connectez l’objet personnalisé aux objets associés. C’est en quelque sorte votre modèle de données, qui définit la relation de cet objet avec les autres objets et données de Zendesk.
   Remarque – Certaines relations avec un objet personnalisé ne se définissent pas côté objet. Il est possible que vous deviez créer des champs de ticket personnalisés, des champs d’utilisateur, des champs d’organisation ou des champs de recherche pour d’autres objets personnalisés. Consultez Définition des relations.
7. (facultatif) Cliquez sur Modifier l’ordre pour faire glisser les champs et les déposer dans l’ordre dans lequel vous voulez que les agents les voient dans l’aperçu des enregistrements, puis cliquez sur Enregistrer quand vous avez terminé.
8. Cliquez sur l’onglet Permissions pour vérifier les permissions d’accès aux enregistrements de l’objet des agents. Avec les éditions Enterprise, vous pouvez configurer l’accès des agents aux enregistrements des objets. Avec les éditions Team, Growth et Professional, les permissions des agents sont prédéfinies.

Définition d’un schéma d’objet personnalisé avec des champs personnalisés

Avant de pouvoir utiliser un objet personnalisé que vous avez créé, vous devez y ajouter des champs personnalisés. Ces champs définissent les propriétés ou le schéma de l’objet personnalisé et seront utilisés par les agents lors de la création d’enregistrements. La liste des champs est classée en ordre alphabétique (nom).

Pour ajouter des champs personnalisés à un objet personnalisé

1. Dans le Centre d’administration, cliquez sur Objets et règles () dans la barre latérale, puis sélectionnez Objets personnalisés > Objets.
2. Cliquez sur le nom de l’objet personnalisé auquel vous voulez ajouter un champ.
3. Cliquez sur l’onglet Champs, puis sur Ajouter un champ.

   

4. Sélectionnez le type de champ, puis saisissez un nom d’affichage.
5. Vérifiez que la clé du champ est bien la valeur que vous désirez.

   La clé du champ permet de référencer le champ personnalisé dans les balises et l’API. Quand vous saisissez un nom pour le champ, la clé du champ est remplie automatiquement. Si vous voulez que le nom et la clé soient différents, vous devez modifier la clé du champ. Vous ne pouvez pas modifier la clé du champ une fois le champ d’objet personnalisé créé. Une clé de champ ne peut pas être réutilisée au sein d’un objet, même si le champ original qui utilisait la clé a été supprimé.

6. Définissez les autres propriétés de votre champ. Les options varient selon le type de champ que vous ajoutez.
7. Cliquez sur Enregistrer ou Enregistrer et ajouter un autre.
8. Répétez les étapes 4 à 7 autant de fois que nécessaire.

Agencement des champs d’un objet pour l’expérience agent

Quand ils travaillent sur des tickets, les agents peuvent afficher un aperçu des détails des enregistrements des objets personnalisés associés aux tickets. Tous les champs d’un objet s’affichent dans le volet d’aperçu des enregistrements, mais il peut être judicieux de placer les champs les plus importants en haut pour simplifier la vie de vos agents.

Pour réagencer les champs d’un objet personnalisé

1. Dans le Centre d’administration, cliquez sur Objets et règles () dans la barre latérale, puis sélectionnez Objets personnalisés > Objets.
2. Cliquez sur le nom de l’objet personnalisé auquel vous voulez ajouter un champ.
3. Cliquez sur l’onglet Champs, puis sur Modifier l’ordre.
4. Faites glisser et déposez les champs dans l’ordre d’affichage souhaité.
5. Cliquez sur Enregistrer.

Accès des agents aux objets personnalisés

Quand vous créez des objets personnalisés, vous devez aussi comprendre comment les agents peuvent accéder aux objets et à leurs enregistrements. Avec toutes les éditions, l’accès est prédéfini pour chaque rôle système. Avec les éditions Enterprise, vous pouvez utiliser la page Rôles du Centre d’administration pour configurer l’accès de chaque rôle personnalisé à chaque objet.

Pour voir un résumé de l’accès des agents aux enregistrements d’un objet spécifique, utilisez l’onglet Permissions de l’objet personnalisé en question.

Pour en savoir plus, consultez Configuration de l’accès des agents aux enregistrements d’objets personnalisés.

Ajout de relations d’objets

Une fois que vous avez créé l’objet personnalisé et défini son schéma de champs personnalisés, il est important de le connecter à d’autres objets, standards ou personnalisés. Les champs de relation de recherche fournissent un moyen de définir la relation de l’objet personnalisé aux objets Zendesk standards (utilisateurs, organisations et tickets) et aux autres objets personnalisés. On peut décrire une relation de recherche comme suit : objet source → objet associé. L’objet source est l’objet Zendesk qui contient le champ de relation de recherche (entre autres champs). L’objet associé est l’objet spécifié par le champ de relation de recherche.

L’ajout d’objets associés ne crée pas automatiquement d’association entre deux enregistrements spécifiques. Il décrit la relation et permet aux agents d’associer des enregistrements de cette façon.

Vous pouvez ajouter des relations pour les objets personnalisés pour :

• un autre objet personnalisé
• un objet standard

Si vous voulez que l’objet personnalisé contienne le champ de relation de recherche, utilisez les instructions suivantes. Par contre, si vous voulez qu’un autre objet inclue l’objet personnalisé comme champ de relation de recherche, consultez Ajout de champs personnalisés à vos tickets, Ajout de champs personnalisés aux utilisateurs ou Ajout de champs personnalisés aux organisations.

Pour ajouter une relation à un objet personnalisé

1. Dans le Centre d’administration, cliquez sur Objets et règles () dans la barre latérale, puis sélectionnez Objets personnalisés > Objets.
2. Placez le curseur sur l’objet personnalisé que vous souhaitez ajouter, puis cliquez sur l’icône du menu des options () et sélectionnez Modifier.
3. Cliquez sur l’onglet Champs, puis sur Ajouter un champ.
4. Définissez le nom d’affichage, la clé du champ et la description.
5. Sélectionnez un objet associé à répertorier dans le champ de relation de recherche.

   Il peut s’agir d’un autre objet personnalisé (), d’un ticket (), d’un utilisateur () ou d’une organisation (). Par exemple, si vous sélectionnez utilisateur comme objet associé, le champ de relation de recherche affichera une liste des utilisateurs Zendesk.

6. Cliquez sur Ajouter un filtre pour définir un ou plusieurs filtres et réduire le nombre d’options que peut afficher le champ.

   Vous pouvez filtrer les objets par autant de marqueurs ou de champs personnalisés que vous souhaitez. Pour en savoir plus, consultez Filtrage des options de champ.

7. Cliquez sur Enregistrer ou Enregistrer et ajouter un autre.