Les Objets Personnalisés vous permettent d'étendre les objets standard People et Conversation d'Intercom pour stocker des données représentant votre entreprise de manière plus flexible. Les références vous permettent de définir comment ces objets sont liés entre eux afin que les données pertinentes puissent être affichées aux bonnes personnes.
Types de références
Référencer plusieurs objets
C'est un type de référence plus courant. Par exemple, plusieurs commandes peuvent appartenir à la même personne, mais une commande ne peut appartenir qu'à une seule personne. Vous pouvez donc créer un Objet Personnalisé appelé « Order » et créer à la fois un attribut People reference et un attribut Order reference pour les relier entre eux.
Dans votre Objet Personnalisé appelé "Order" :
Dans votre attribut People :
Référencer un seul objet
Un autre type de référence est la référence « un-à-un ». Par exemple, vous avez beaucoup de personnes dans votre système, et vous exigez qu'elles fournissent les détails de leur passeport pour réserver un vol.
En supposant qu'une personne ne peut avoir qu'un seul passeport à la fois et qu'un passeport ne peut appartenir qu'à une seule personne, vous créeriez un Objet Personnalisé pour « Passport » avec des attributs pour « passport_number » et « expiry_date », puis créeriez une référence qui le lie à la personne avec l'option 'Allow referencing to multiple people' désactivée (off).
Et du côté de l'attribut People, vous créez une référence à l'objet « Passport » avec l'option désactivée (off) également.
Dans votre Objet Personnalisé appelé "Passport" :
Dans votre attribut People :
Modifier les types de références
Les références peuvent toujours être modifiées une fois enregistrées, sauf leurs noms. Veuillez noter que si vous modifiez l'option, toutes les associations existantes peuvent être supprimées. Cela signifie que les bots et les Data connectors qui utilisent cet attribut pourraient échouer.
Utilisation des Objets Personnalisés dans les boutons de workflow
Lors de l'utilisation des Objets Personnalisés dans les boutons de workflow, vous avez besoin de deux attributs de conversation qui référencent votre type d'Objet Personnalisé : un pour afficher les options ; et un pour stocker la sélection de l'utilisateur.
Avant de commencer
Créez deux attributs de conversation qui référencent tous deux votre type d'Objet Personnalisé :
Attribut d'affichage — réglé sur « reference many » pour pouvoir stocker toutes les options renvoyées par votre data connector. Il est utilisé pour générer les boutons affichés au client.
Attribut de sélection — réglé sur « reference one » pour stocker le choix unique du client.
Configurer le connecteur de données
Lors de la création de votre connecteur de données, la configuration suit cet ordre :
Nom et description — donnez un nom clair au connecteur (par exemple, « Get order options ») et décrivez quand vos collègues doivent l'utiliser. Cela se configure au début de la configuration.
Mapping des objets — mappez les champs de réponse de votre API aux attributs pertinents de l'Objet Personnalisé. Assurez-vous de mapper l'ID au champ
external_idpour éviter les doublons.Mettre à jour les références depuis People ou Conversations — c'est la dernière étape de la section de mapping des objets. Sélectionnez ici l'attribut d'affichage (« reference many ») pour que le data connector remplisse les options des boutons dans votre workflow.
Configurer l'étape du workflow
Dans l'étape de sélection d'Objet Personnalisé de votre workflow :
Génération des boutons — utilisez l'attribut d'affichage (« reference many ») pour lire et afficher toutes les options.
Sélection de l'utilisateur — utilisez l'attribut de sélection (« reference one ») pour enregistrer le choix du client.