Utiliser les données des objets CRM dans CMS Hub

Last updated:

Vous pouvez interroger les objets CRM pour utiliser les données des enregistrements de l'objet sur le contenu hébergé par HubSpot, ce qui permet de partager les données entre vos opérations commerciales, votre site Web et vos e-mails. En utilisant les crm_objet, crm_objets et crm_associations HubL, vous pouvez afficher et contrôler la logique basée sur les données de vos objets CRM. 

L'utilisation des données CRM sur votre site Web signifie que vos données sur les ventes, marketing et le site Web se trouvent toutes au même endroit et reflètent toujours les mêmes informations. En outre, comme vous pouvez associer des enregistrements CRM les uns aux autres, vous pouvez également intégrer les données associées dans les pages de votre site Web.

De même, vous pouvez créer des ensembles de pages dynamiques qui se génèrent automatiquement à l'aide d'objets CRM ou de données HubDB.

Découvrez-en davantage sur la création de pages CMS basées sur les données dans le cours CMS Data-Driven Content de HubSpot Academy.

Exemple de cas d'utilisation

Une liste d'annonces immobilières est un exemple d'utilisation de données d'objets CRM dans des pages. Avec un objet personnalisé appelé propriété, des enregistrements d'objets individuels peuvent être créés pour chaque maison qui doit être répertoriée. Les agents immobiliers peuvent ensuite ajouter des informations aux propriétés des objets afin de stocker des détails, tels que l'emplacement, le nombre de chambres et les prix demandés. 

Les pages du site Web peuvent alors extraire les données de l'enregistrement pour chaque propriété afin de créer une page d'inscription et des pages de détails pour chaque propriété. 

Consultez le dépôt GitHub pour voir l'exemple complet.

Pour avoir une vue d'ensemble de cet exemple, consultez l'enregistrement de la Journée des développeurs HubSpot 2020

Types d'objets CRM pris en charge

Vous trouverez ci-dessous les types d'objets CRM dont vous pouvez tirer des données pour les pages de votre CMS Hub. Le fait que vous puissiez utiliser les données sur toutes les pages ou uniquement sur les pages privées dépend du type d'objet.

Dans les tableaux ci-dessous, découvrez les types d'objets disponibles pour le contenu du CMS ainsi que leurs noms et noms entièrement qualifiés. 

Remarque : Les noms d'objets standard, tels que « contact », ne sont pas sensibles à la casse, mais doivent être au singulier.

Données des objets CRM disponibles pour toutes les pages

Les données des objets CRM suivants peuvent être utilisées sur n'importe quelle page du CMS.

Type d'objet Nom object_type Nom entièrement qualifié
Produits product PRODUCT
Événements marketing marketing_event MARKETING_EVENT
Objets personnalisés

CMS Hub Entreprise uniquement.

Vous pouvez utiliser le nom entièrement qualifié de l'objet ou le nom saisi au moment de la création. Par exemple, si vous créez un objet nommé « Voitures », vous ne pouvez pas le référencer avec « voitures » ou « Voiture ».

Vous devez utiliser le nom entièrement qualifié si l'objet personnalisé partage un nom avec un objet standard.

 

Données des objets CRM disponibles pour les pages privées

Les données des objets de CRM suivants ne peuvent être utilisées que sur les pages nécessitant un mot de passe ou une connexion de membre.

Type d'objet Nom object_type NOM ENTIÈREMENT QUALIFIÉ
Contacts contact CONTACT
Entreprises company COMPANY
Transactions deal DEAL
Tickets ticket TICKET
Devis quote QUOTE
Objets intégrateurs

Pour obtenir le nom d'un objet intégrateur, utilisez l'API schéma des objets CRM.

Pour les objets intégrateurs portant le même nom que les objets standards, utilisez le nom complet de l'objet intégrateur.

 

Afficher les données d'un seul enregistrement CRM avec la fonction crm_object

Utilisez la fonction crm_objet pour obtenir un enregistrement unique de la fonctionnalité CRM de HubSpot par requête ou par ID d'enregistrement CRM. 

Les enregistrements d'objets sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.

{# Render custom object by query #} {% set event = crm_object("event", "name=Defensive Health") %} {{ event.name }} {# Render custom objects specifying the id of the object #} {% set event = crm_object("event", 289236) %} {{ event.name }}<p>Defensive Heatlh</p> <p>Defensive Heatlh</p>

Si une requête renvoie une collection d'enregistrements, la fonction renvoie le premier enregistrement de la collection.

Afficher les données de plusieurs enregistrements CRM avec la fonction crm_objects

Utilisez la fonction crm_objects() pour obtenir des enregistrements CRM par type d'objet à partir de la fonctionnalité CRM de HubSpot par requête ou par ID d'enregistrement. Les enregistrements sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.

L'enregistrement renvoyé contient une propriété results qui peut être mise en boucle pour afficher les informations dans les éléments de l'enregistrement.

{# Render custom objects by query #} {% set events = crm_objects("event", "limit=3&type=virtual") %} <h3>{{events.total}} New Events:<h3> <ul> {% for event in events.results %} <li>Name: {{ event.name }}</li> {% endfor %} <ul> {# Render custom objects by ids #} {% set events = crm_objects("event", [289236,289237,289238]) %} <h3>{{events.total}} New Events:<h3> <ul> {% for event in events.results %} <li>Name: {{ event.name }}</li> {% endfor %} <ul> <h3>3 New Events:<h3> <ul> <li>Name: Defensive Health</li> <li>Name: Body Balance</li> <li>Name: Happy Heart</li> <ul> <h3>3 New Events:<h3> <ul> <li>Name: Defensive Health</li> <li>Name: Body Balance</li> <li>Name: Happy Heart</li> <ul>

Affichage des enregistrements associés

Utilisez la fonction crm_associations de HubL pour obtenir une liste d'informations associées à partir de la fonctionnalité CRM de HubSpot en fonction de l'ID d'enregistrement, de la catégorie d'association et de l'ID de définition de l'association.

Les enregistrements sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs.

{% set associated_objects = crm_associations(289236, "USER_DEFINED", 3) %} <h3>Contacts Associated With Event</h3> <ul> {% for contact in associated_objects.results %} <li>Name: {{ contact.firstname }} {{ contact.lastname }}</li> {% endfor %} </ul> <h3>Contacts Associated With Event<h3> <ul> <li>Name: Brian Halligan</li> <li>Name: Dharmesh Shah</li> <li>Name: Yamini Rangan</li>

Obtenir les détails d'un type d'objet personnalisé

Pour obtenir name, ID, fullyQualifiedName, les ID d'association et d'autres détails d'un type d'objet personnalisé, vous pouvez effectuer une requête GET sur l'API schéma d'objets CRM.

Remarque : fullyQualifiedName pour les types d'objets spécifiques au compte inclut l'ID du compte HubSpot, il est donc recommandé d'éviter de l'utiliser lorsque vous développez votre code pour plusieurs comptes HubSpot.

Champ Module d'objet CRM

Pour permettre aux créateurs de contenu de sélectionner les enregistrements CRM à afficher ou d'exécuter une logique, vous pouvez construire des modules qui incluent le champ d'objet CRM.

Par exemple, si vous souhaitez afficher les informations d'un produit, d'un contact, d'une entreprise, d'une transaction, d'un devis, d'un ticket ou d'un objet personnalisé.

Champ d'objet CRM

Cet article vous a-t-il été utile ?
Ce formulaire est destiné à recueillir les avis sur la documentation pour les développeurs. Si vous souhaitez faire part de votre avis sur les produits HubSpot, veuillez le partager sur le forum des idéesde la communauté.