Dernière modification : 12 septembre 2025
‘Les objets CRM peuvent être demandés et rendus 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.’; 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 fonction HubL crm_object, crm_objects et crm_associations, 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.

​
Exemple de cas d’utilisation

Un exemple d’utilisation des données d’un objet CRM dans des pages est celui d’une page d’annonces immobilières. 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 répertoire 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. 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.

​
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’objetNom de l’objetNom entièrement qualifié
ProduitsproductPRODUCT
Événements marketingmarketing_eventMARKETING_EVENT
Objets personnalisésContent 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é Cars, vous ne pouvez pas le référencer avec cars ou Car. Vous devez utiliser le nom entièrement qualifié si l’objet personnalisé partage un nom avec un objet standard. Il est également fortement recommandé d’utiliser le nom entièrement qualifié si le nom de l’objet est entièrement en majuscules afin d’éviter tout conflit potentiel avec les objets standard de HubSpot.

​
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’objetNom de l’objetNom entièrement qualifié
ContactscontactCONTACT
EntreprisescompanyCOMPANY
TransactionsdealDEAL
TicketsticketTICKET
DevisquoteQUOTE
Lignes de produitline_itemLINE_ITEM

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

Utilisez la fonction crm_object 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 }}

​
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>

​
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>

​
Obtenir les détails d’un type d’objet personnalisé

Pour obtenir les éléments 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.

​
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

​
Tutoriels et ressources concernant les objets CRM