Utilizar los datos de los objetos del CRM en CMS Hub

Last updated:

Puedes consultar los objetos de CRM para utilizar los datos de registros del objeto 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 de CRM en tu sitio web significa que tus datos de ventas, marketing y sitio web se encuentran todos en el mismo lugar y siempre reflejarán la misma información. Además, debido a que puedes asociar registros de CRM entre sí, también puedes extraer datos asociados en las páginas de tu sitio web.

Del mismo modo, puede crear conjuntos de páginas dinámicas que se generen automáticamente utilizando los datos del objeto de CRM o de HubDB.

Puedes obtener más información sobre la creación de páginas de CMS basadas en datos en el curso de Contenido basado en datos de CMS de HubSpot Academy.

Caso de uso de ejemplo

Un ejemplo de uso de los datos de los objetos de CRM en las páginas es una página de contenido 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 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 contenido y páginas de detalles para cada propiedad. 

Consulta el repositorio de GitHub para ver el ejemplo completo.

Para obtener una visión general de este ejemplo, consulta la grabación del día del desarrollador de HubSpot 2020. 

Tipos de objetos del CRM admitidos

A continuación se muestran los tipos de objetos del CRM de los que puedes extraer datos para tus páginas de CMS Hub. La posibilidad de utilizar los datos en todas las páginas o sólo en las páginas privadas depende del tipo de objeto.

En las tablas siguientes, obtén más información sobre los tipos de objetos disponibles para el contenido CMS junto con sus nombres de tipo de objeto y nombres totalmente cualificados. 

Nota: los nombres de objetos estándar, como "contacto", no distinguen entre mayúsculas y minúsculas, pero deben ser singulares.

Datos del objeto CRM disponibles para todas las páginas

Los datos de los siguientes objetos del CRM pueden utilizarse en cualquier página de CMS.

Tipo de objeto object_type name Nombre totalmente cualificado
Productos product PRODUCT
Eventos de marketing marketing_event MARKETING_EVENT
Objetos personalizados

Solo CMS Hub Enterprise.

Puedes utilizar el nombre 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 Autos", no puedes hacer referencia a él con autos" o Auto".

Debes usar el  nombre totalmente cualificado si el objeto personalizado comparte un nombre con un objeto estándar.

 

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 de miembro.

Tipo de objeto object_type name NOMBRE TOTALMENTE CUALIFICADO
Contactos contact CONTACT
Empresas company COMPANY
Negocios deal DEAL
Tickets ticket TICKET
Cotizaciones quote QUOTE
Objetos integradores

Para obtener el nombre de un objeto integrador, utilice la API del esquema de objetos del CRM.

Para los objetos integradores con el mismo nombre que los objetos estándar, utiliza el objeto integrador nombre completamente calificado.

 

Visualizar los datos de un solo registro de 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 }}<p>Defensive Heatlh</p> <p>Defensive Heatlh</p>

Si una consulta devuelve una colección de registros, la función devolverá el primer registro de la colección.

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 HubSpot CRM por consulta o por ID de registro. Los registros se devuelven como un dictado 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> <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>

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 se devuelven como un dictado 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> <h3>Contacts Associated With Event<h3> <ul> <li>Name: Brian Halligan</li> <li>Name: Dharmesh Shah</li> <li>Name: Yamini Rangan</li>

Obtener los detalles de un tipo de objeto personalizado

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

Nota: fullyQualifiedName para los tipos de objetos de la cuenta especifica incluye el ID de la cuenta de HubSpot, por lo que se recomienda evitar su uso cuando se desarrolle tu código para varias cuentas de HubSpot.

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

¿Te resultó útil este artículo?
Con este formulario puedes enviar tu opinión sobre nuestros documentos para desarrolladores. Si tienes comentarios sobre el producto de HubSpot, puedes enviarlos al Foro de ideas.