> ## Documentation Index
> Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Objetos del CRM en las páginas del CMS

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

'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`](/cms/reference/hubl/functions#crm-object), [`crm_objects`](/cms/reference/hubl/functions#crm-objects) y [`crm_associations`](/cms/reference/hubl/functions#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](https://developers.hubspot.com/docs).

<Alert type="info">
  Puedes obtener más información sobre la creación de páginas del CMS basadas en datos en el curso de [Contenido basado en datos del CMS](https://app.hubspot.com/academy/tracks/1148948/intro) de HubSpot Academy.
</Alert>

### 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](https://github.com/HubSpot/cms-custom-objects-example) para ver el ejemplo completo.

Para obtener un resumen de este ejemplo, consulta la [grabación del día del desarrollador de HubSpot 2020](https://developers.hubspot.com/community/developer-day-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 objeto                                                             | Nombre del tipo de objeto                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Nombre totalmente cualificado |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| [Productos](/api-reference/crm-products-v3/guide)                          | `product`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | `PRODUCT`                     |
| [Eventos de marketing](/api-reference/marketing-marketing-events-v3/guide) | `marketing_event`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | `MARKETING_EVENT`             |
| [Objetos personalizados](/api-reference/crm-custom-objects-v3/guide)       | ***Solo Content Hub** Enterprise*. Puedes utilizar el [nombre totalmente cualificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) 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](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) 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](https://knowledge.hubspot.com/es/website-pages/password-protect-a-page) o un [inicio de sesión con membresía.](https://knowledge.hubspot.com/es/website-pages/require-member-registration-to-access-private-content)

| Tipo de objeto                                                | Nombre del tipo de objeto | Nombre totalmente cualificado |
| ------------------------------------------------------------- | ------------------------- | ----------------------------- |
| [Contactos](/api-reference/crm-contacts-v3/guide)             | `contact`                 | `CONTACT`                     |
| [Empresas](/api-reference/crm-companies-v3/guide)             | `company`                 | `COMPANY`                     |
| [Negocios](/api-reference/crm-deals-v3/guide)                 | `deal`                    | `DEAL`                        |
| [Tickets](/api-reference/crm-tickets-v3/guide)                | `ticket`                  | `TICKET`                      |
| [Cotizaciones](/api-reference/crm-quotes-v3/guide)            | `quote`                   | `QUOTE`                       |
| [Elementos de pedido](/api-reference/crm-line-items-v3/guide) | `line_item`               | `LINE_ITEM`                   |

## Visualizar los datos de un solo registro del CRM con la función crm\_object

Utiliza la función [`crm_object`](/cms/reference/hubl/functions#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.

<Tabs defaultSelected="0">
  <Tab tabId="0" title="Input">
    ```hubl theme={null}
    {# 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 }}
    ```
  </Tab>

  <Tab tabId="1" title="Output">
    ```html theme={null}
    <p>Defensive Health</p>

    <p>Defensive Health</p>
    ```
  </Tab>
</Tabs>

<Alert type="info">
  Si una consulta devuelve una colección de registros, la función devolverá el primer registro de la colección.
</Alert>

## Visualización de datos de varios registros del CRM con la función crm\_objects

Utiliza la función [`crm_objects()`](/cms/reference/hubl/functions#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.

<Tabs defaultSelected="0">
  <Tab tabId="0" title="Input">
    ```hubl theme={null}
    {# 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>
    ```
  </Tab>

  <Tab tabId="1" title="Output">
    ```html theme={null}
    <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></ul>
                </ul>
              </h3>
            </h3>
          </ul>
        </ul>
      </h3>
    </h3>
    ```
  </Tab>
</Tabs>

## Mostrar los registros asociados

Utiliza la función de HubL [`crm_associations`](/cms/reference/hubl/functions#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.[](#getting-a-custom-object-s-details)

Los registros aparecerán en un dicc. de propiedades y valores.

<Tabs defaultSelected="0">
  <Tab tabId="0" title="Input">
    ```hubl theme={null}
    {% 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>
    ```
  </Tab>

  <Tab tabId="1" title="Output">
    ```html theme={null}
    <h3>
      Contacts Associated With Event
      <h3>
        <ul>
          <li>Name: Brian Halligan</li>

          <li>Name: Dharmesh Shah</li>

          <li>Name: Yamini Rangan</li>
        </ul>
      </h3>
    </h3>
    ```
  </Tab>
</Tabs>

## 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](https://developers.hubspot.com/docs).

<Alert type="warning" titleText="Nota:">
  `fullyQualifiedName` para los tipos de objetos de la cuenta en específico incluye el ID de la cuenta de HubSpot, por lo que se recomienda evitar su uso cuando se desarrolle el código para varias cuentas de HubSpot.
</Alert>

## 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](https://developers.hubspot.es/docs/cms/reference/fields/module-theme-fields#crm-object).

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](https://f.hubspotusercontent00.net/hubfs/53/CRM%20Object%20Field.png)

## Tutoriales y recursos relacionados con objetos del CRM

* [Elementos básicos para empezar a usar los objetos personalizados](https://developers.hubspot.com/blog/essentials-for-getting-started-with-custom-objects)
* [Diseña con una visión de arquitectura: crea objetos personalizados escalables](https://developers.hubspot.com/blog/how-to-think-like-an-architect-by-building-scalable-custom-objects)
* [Crea páginas dinámicas con objetos del CRM](https://developers.hubspot.com/docs)
