Última modificación: 12 de septiembre de 2025
‘Los objetos del CRM se pueden consultar y renderizar en el contenido alojado en HubSpot, lo que permite compartir datos entre tus operaciones comerciales, el sitio web y los correos electrónicos.’; Puedes consultar los objetos del CRM para utilizar sus datos en el contenido alojado en HubSpot, lo que permite compartir los datos entre tus operaciones comerciales, el sitio web y los correos electrónicos. Utilizando las funciones de HubL crm_object, crm_objects y crm_associations, puedes mostrar y controlar la lógica basada en los datos de tu objeto del CRM. Utilizar los datos del CRM en tu sitio web significa que tus datos de ventas, marketing y sitio web se encuentran en el mismo lugar y siempre reflejarán la misma información. Además, ya que puedes asociar registros del CRM entre sí, también puedes extraer datos asociados en las páginas de tu sitio web. Del mismo modo, puedes crear conjuntos de páginas dinámicas que se generen automáticamente utilizando los datos del objeto del CRM o de HubDB.

​
Ejemplo de uso

Un ejemplo de uso de los datos de los objetos del CRM en las páginas es una página de índice de bienes raíces. Con un objeto personalizado llamado propiedad, se pueden crear registros de objetos individuales para cada casa que necesite ser listada. Los agentes de bienes raíces pueden agregar información a las propiedades del objeto para almacenar detalles, como la ubicación, el número de habitaciones y los precios de venta. Las páginas del sitio web pueden entonces extraer los datos de los registros de cada propiedad para crear una página de índice y páginas de detalles para cada propiedad. Consulta el repositorio de GitHub para ver el ejemplo completo. Para obtener un resumen de este ejemplo, consulta la grabación del día del desarrollador de HubSpot 2020.

​
Tipos de objetos del CRM compatibles

A continuación se muestran los tipos de objetos del CRM de los que puedes extraer datos para tus páginas del CMS. La posibilidad de utilizar los datos en todas las páginas o solo en las páginas privadas depende del tipo de objeto. En las siguientes tablas, puedes obtener más información sobre los tipos de objetos disponibles para el contenido CMS junto con los nombres del tipo de objeto y nombres totalmente cualificados.

​
Datos del objeto del CRM disponibles para todas las páginas

Los datos de los siguientes objetos del CRM pueden utilizarse en cualquier página del CMS.
Tipo de objetoNombre del tipo de objetoNombre totalmente cualificado
ProductosproductPRODUCT
Eventos de marketingmarketing_eventMARKETING_EVENT
Objetos personalizadosSolo Content Hub Enterprise. Puedes utilizar el nombre totalmente cualificado del objeto o el nombre que se introdujo en el momento de la creación. Por ejemplo, si creas un objeto llamado Cars, no puedes hacer referencia a él con cars o Car. Debes utilizar el nombre completo si el objeto personalizado comparte nombre con un objeto estándar. También se recomienda utilizar el FQN si el nombre del objeto está completamente en mayúsculas para evitar posibles conflictos con los objetos estándar de HubSpot.

​
Datos del objeto del CRM disponibles para las páginas privadas

Los datos de los siguientes objetos del CRM solo pueden utilizarse en páginas que requieran una contraseña o un inicio de sesión con membresía.
Tipo de objetoNombre del tipo de objetoNombre totalmente cualificado
ContactoscontactCONTACT
EmpresascompanyCOMPANY
NegociosdealDEAL
TicketsticketTICKET
CotizacionesquoteQUOTE
Elementos de pedidoline_itemLINE_ITEM

​
Visualizar los datos de un solo registro del CRM con la función crm_object

Utiliza la función crm_object para obtener un único registro del CRM de HubSpot por consulta o por el ID del registro del CRM. Los registros de los objetos se devuelven como un dictado de propiedades y valores. 
{# 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 }}

​
Visualización de datos de varios registros del CRM con la función crm_objects

Utiliza la función crm_objects() para obtener registros del CRM por tipo de objeto desde el CRM de HubSpot por consulta o por el ID de registro. Los registros aparecerán en un dicc. de propiedades y valores. El registro devuelto contiene una propiedad results que se puede recorrer en bucle para mostrar la información de los elementos del registro. 
{# 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>

​
Mostrar los registros asociados

Utiliza la función de HubL crm_associations para obtener una lista de registros asociados del CRM de HubSpot basada en el ID del registro, la categoría de la asociación y el ID de definición de la asociación. Los registros aparecerán en un dicc. de propiedades y valores. 
{% 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>

​
Obtener los detalles de un tipo de objeto personalizado

Para obtener un tipo de objeto personalizado el name, el id, el fullyQualifiedName, los ID de asociación y otros detalles, puedes realizar una solicitud GET a la API del esquema de objetos del CRM.

​
Campo del módulo de objetos del CRM

Para proporcionar una forma para que los creadores de contenido seleccionen los registros del CRM para mostrar o ejecutar la lógica, puedes crear módulos que incluyan el campo de objeto del CRM. Por ejemplo, puedes mostrar información de un producto específico, contacto, empresa, negocio, cotización, ticket u objeto personalizado. Campo de objeto del CRM

​
Tutoriales y recursos relacionados con objetos del CRM