Ignorar e ir ao conteúdo principal

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 crm_object, crm_objects e crm_associations do HubL, 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.

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 para ver o exemplo completo.

Para uma visão geral deste exemplo, confira a gravação do HubSpot Developer Day 2020.

Abaixo estão os tipos de objetos do CRM dos quais você pode extrair dados para suas páginas do CMS Hub. 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.

Os dados a seguir de objetos do CRM podem ser usados em qualquer página do CMS.

Tipo de objetonome object_typeNome totalmente qualificado
ProdutosproductPRODUCT
Eventos de marketingmarketing_eventMARKETING_EVENT
Objetos personalizadosSomente o CMS Hub Enterprise. Você pode usar o nome totalmente qualificado do objeto ou o nome que foi inserido no momento da criação. Por exemplo, se você criar um objeto chamado "Carros", não poderá referenciá-lo com "carros" ou "Carro".Você deverá usar o nome totalmente qualificado se o objeto personalizado tiver o mesmo nome de um objeto padrão.

Os dados dos objetos do CRM a seguir somente podem ser usados em páginas que exigem senha ou login de membro.

Tipo de objetonome object_typeNOME TOTALMENTE QUALIFICADO
ContatoscontactCONTACT
EmpresascompanyCOMPANY
NegóciosdealDEAL
TicketsticketTICKET
OrçamentosquoteQUOTE
Objetos integradoresPara obter o nome de um objeto integrador, use a API do esquema de objetos do CRM.Para objetos integradores que têm nomes idênticos aos dos objetos padrão, use o nome totalmente qualificado do objeto integrador.

Use a função 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.

Use a função 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.

Use a função HubL 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.

Os registros são retornados como um dicionário de propriedades e valores.

Para obter o nome, o id, o fullyQualifiedName, os IDs de associação e outros detalhes de um tipo de objeto personalizado, você pode fazer uma solicitação GET para a API do esquema 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.

Por exemplo, você pode querer exibir informações de um produto específico, contato, empresa, negócio, orçamento, ticket ou objeto personalizado.

Campo de objeto do CRM