> ## Documentation Index
> Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Objetos de CRM em páginas de CMS
> Os objetos do CRM podem ser consultados e renderizados no conteúdo hospedado pela HubSpot, o que permite compartilhar dados entre suas operações de negócio, sites e e-mails.
'Os objetos do CRM podem ser consultados e renderizados no conteúdo hospedado pela HubSpot, o que permite compartilhar dados entre suas operações de negócio, sites e e-mails.';
Você pode consultar objetos do CRM para usar dados dos registros no conteúdo hospedado pela HubSpot, permitindo que os dados sejam compartilhados entre suas operações de negócios, site e e-mails. Usando as funções do HubL [`crm_object`](/cms/reference/hubl/functions#crm-object), [`crm_objects`](/cms/reference/hubl/functions#crm-objects) e [`crm_associations`](/cms/reference/hubl/functions#crm-associations), você pode exibir e controlar a lógica com base nos dados do objeto do CRM.
Utilizar dados do CRM no seu site significa que as suas vendas, marketing e dados do site residem todos no mesmo lugar e refletirão sempre as mesmas informações. Além disso, como você pode associar registros de CRM uns aos outros, também poderá obter os dados associados para as páginas do seu site.
Da mesma forma, você pode [criar conjuntos de páginas dinâmicas que são geradas automaticamente usando o objeto do CRM ou os dados do HubDB](https://developers.hubspot.com/docs).
Saiba mais sobre como criar páginas do CMS baseadas em dados no curso de [Conteúdo baseado em dados do CMS](https://app.hubspot.com/academy/tracks/1148948/intro) no HubSpot Academy.
### Exemplo de caso de uso
Um exemplo de utilização de dados de objeto do CRM em páginas é uma página de listagem de imóveis. Com um objeto personalizado chamado *propriedade*, podem ser criados registros de objetos individuais para cada casa que precisa ser listada. Os agentes imobiliários podem então adicionar informações às propriedades do objeto para armazenar detalhes, tais como localização, número de quartos e consultas de preço.
As páginas do site podem então obter os dados de registro para cada propriedade a fim de criar uma página de listagem e páginas de detalhes para cada propriedade.
[Confira o repositório GitHub](https://github.com/HubSpot/cms-custom-objects-example) para ver o exemplo completo.
Para uma visão geral deste exemplo, confira a [gravação do HubSpot Developer Day 2020](https://developers.hubspot.com/community/developer-day-2020).
## Tipos de objetos de CRM suportados
Abaixo estão os tipos de objetos do CRM dos quais você pode extrair dados para suas páginas do CMS. Você pode usar os dados em todas as páginas ou apenas em páginas privadas, dependendo do tipo de objeto.
Nas tabelas abaixo, saiba quais tipos de objetos estão disponíveis para o conteúdo do CMS, além de seus nomes de tipo de objeto e nomes totalmente qualificados.
### Dados de objetos de CRM disponíveis para todas as páginas
Os dados a seguir de objetos do CRM podem ser usados em qualquer página do CMS.
| Tipo de objeto | object\_type\_name | Nome totalmente qualificado |
| -------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [Produtos](/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) | ***Content Hub** Enterprise* apenas. Você pode usar o [nome totalmente qualificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) do objeto ou o nome que foi inserido no momento da criação. Por exemplo, se você criar um objeto chamado `Cars`, não é possível referenciá-lo com `cars` ou `Car`.Você deve usar o [nome totalmente qualificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) se o objeto personalizado compartilha um nome com um objeto padrão. Também é altamente recomendável usar o FQN se o nome do objeto estiver totalmente em maiúsculas para evitar possíveis conflitos com os objetos padrão da HubSpot. | |
### Dados de objetos do CRM disponíveis para páginas privadas
Os dados dos objetos do CRM a seguir somente podem ser usados em páginas que exigem [senha](https://knowledge.hubspot.com/pt/website-pages/password-protect-a-page) ou [login de membro](https://knowledge.hubspot.com/pt/website-pages/require-member-registration-to-access-private-content).
| Tipo de objeto | object\_type\_name | Nome totalmente qualificado |
| -------------------------------------------------------- | ------------------ | --------------------------- |
| [Contatos](/api-reference/crm-contacts-v3/guide) | `contact` | `CONTACT` |
| [Empresas](/api-reference/crm-companies-v3/guide) | `company` | `COMPANY` |
| [Negócios](/api-reference/crm-deals-v3/guide) | `deal` | `DEAL` |
| [Tickets](/api-reference/crm-tickets-v3/guide) | `ticket` | `TICKET` |
| [Orçamentos](/api-reference/crm-quotes-v3/guide) | `quote` | `QUOTE` |
| [Itens de linha](/api-reference/crm-line-items-v3/guide) | `line_item` | `LINE_ITEM` |
## Exibir dados de um único registro do CRM com a função crm\_object
Use a função [`crm_object`](/cms/reference/hubl/functions#crm-object) para obter um único registo do HubSpot CRM por consulta ou por ID de registo do CRM.
Os registros de objeto são retornados como um dicionário de propriedades e valores.
```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 }}
```
```html theme={null}
Defensive Health
Defensive Health
```
Se uma consulta retornar um conjunto de registros, a função retornará o primeiro registro do conjunto.
## Exibir dados de um único registro do CRM com a função crm\_objects
Use a função [`crm_objects()`](/cms/reference/hubl/functions#crm-objects) para obter registros do CRM por tipo de objeto do HubSpot CRM por consulta ou por ID de registo. Os registros são retornados como um dicionário de propriedades e valores.
O registro retornado contém uma propriedade `results` que pode ser executada em loop para exibir as informações dos itens do registro.
```hubl theme={null}
{# Render custom objects by query #}
{% set events = crm_objects("event", "limit=3&type=virtual") %}
{{events.total}} New Events:
{% for event in events.results %}
- Name: {{ event.name }}
{% endfor %}
{# Render custom objects by ids #}
{% set events = crm_objects("event", [289236,289237,289238]) %}
{{events.total}} New Events:
{% for event in events.results %}
- Name: {{ event.name }}
{% endfor %}
```html theme={null}
3 New Events:
- Name: Defensive Health
- Name: Body Balance
- Name: Happy Heart
3 New Events:
- Name: Defensive Health
- Name: Body Balance
- Name: Happy Heart
```
## Exibir registros associados
Use a função HubL [`crm_associations`](/cms/reference/hubl/functions#crm-associations) para obter uma lista de registros associados do HubSpot CRM com base no ID do registro, categoria de associação e ID de definição de associação.[](#getting-a-custom-object-s-details)
Os registros são retornados como um dicionário de propriedades e valores.
```hubl theme={null}
{% set associated_objects = crm_associations(289236, "USER_DEFINED", 3) %}
Contacts Associated With Event
{% for contact in associated_objects.results %}
- Name: {{ contact.firstname }} {{ contact.lastname }}
{% endfor %}
```
```html theme={null}
Contacts Associated With Event
- Name: Brian Halligan
- Name: Dharmesh Shah
- Name: Yamini Rangan
```
## Obter os detalhes de um tipo de objeto personalizado
Para obter um tipo de objeto personalizado `name`, `id`, `fullyQualifiedName`, IDs de associações e outros detalhes, você pode criar um pedido `GET` à [API de esquema de objetos de CRM](https://developers.hubspot.com/docs).
`fullyQualifiedName` para tipos de objetos específicos da conta inclui o ID da conta da HubSpot; por isso, é recomendado evitar usá-lo ao desenvolver código para várias contas da HubSpot.
## Campo do módulo de objetos do CRM
Para fornecer uma forma de os criadores de conteúdo selecionarem registros do CRM para exibir ou executar lógica, você pode criar módulos que incluam o [campo de objeto do CRM](https://br.developers.hubspot.com/docs/cms/reference/fields/module-theme-fields#crm-object).
Por exemplo, você pode querer exibir informações de um produto específico, contato, empresa, negócio, orçamento, ticket ou objeto personalizado.
## Tutoriais e recursos sobre objetos do CRM
* [Introdução aos Objetos personalizados](https://developers.hubspot.com/blog/essentials-for-getting-started-with-custom-objects)
* [Pense como um arquiteto: crie objetos personalizados escaláveis](https://developers.hubspot.com/blog/how-to-think-like-an-architect-by-building-scalable-custom-objects)
* [Crie páginas dinâmicas com objetos do CRM](https://developers.hubspot.com/docs)