Ir para o conteúdo principal
Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa. O texto oficial é a versão em inglês e sempre será o texto mais atualizado. Para ver a versão em inglês, clique aqui.

Criar e editar objetos personalizados

Ultima atualização: 16 de Janeiro de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Se o seu negócio exige um relacionamento ou processo além dos objetos padrão do CRM, crie e defina um objeto personalizado no modelo de dados ou via API. Eles permitem que você rastreie dados específicos da empresa que se encaixam fora dos objetos totalmente definidos da HubSpot. Uma vez definidas, você pode criar propriedades, gerenciar pipelines e personalizar as associações entre os objetos personalizados e outros objetos. Use objetos personalizados em outras ferramentas da HubSpot, como e-mails de marketing, fluxos de trabalho e relatórios .

Permissões necessárias As permissões de acesso à conta são necessárias para criar, editar e gerenciar objetos personalizados.

Observação: dependendo da sua assinatura, há limites no número de objetos e propriedades personalizadas que você pode ter. Saiba mais sobre seus limites em nosso Catálogo de produtos e serviços da HubSpot.

Antes de começar

Antes de definir um objeto personalizado, é importante avaliar se esta é a opção certa para o seu negócio e a qualidade dos seus dados no HubSpot.

Algumas perguntas a serem consideradas antes de criar seu próprio objeto incluem:

  • Você pode usar um objeto do CRM existente e suas propriedades para organizar seus dados em vez de um objeto personalizado?
  • É possível que haja dados sobrepostos ou inconsistentes entre o objeto personalizado e um objeto existente?
  • Há algum recurso exclusivo para objetos existentes que você deseja usar? Por exemplo, e-mails de marketing em massa só podem ser enviados para contatos, não para outros objetos.
  • Há algum relatório predefinido conectado aos objetos existentes que você deseja usar? Por exemplo, os relatórios de atribuição de negócio e as previsões de vendas estão conectados diretamente aos negócios, não a outros objetos.

Para compreender os dados e as relações de objeto existentes, você pode ver uma visão geral do modelo de dados da conta. Para obter mais orientações sobre quando criar um objeto personalizado, consulte esta lição no Hubspot academy ou entre em contato com seu Gerente de sucesso do cliente.

Glossário

Há alguns termos e conceitos com os quais você deve estar familiarizado antes de criar um objeto personalizado.

  • Nome do objeto: o título do seu objeto personalizado. Você será solicitado a definir um nome no plural e um nome no singular. Por exemplo, Empresas é um nome de objeto no plural e Empresa é o nome do objeto no singular.
  • Propriedade de exibição principal: a propriedade usada para nomear um registro do seu objeto. Esta é a principal propriedade de identificação do seu objeto e pode ser usada para pesquisar registros na página de índice. Por padrão, ela aparece como a primeira coluna na página de índice de objetos e no canto superior esquerdo em cada registro. Por exemplo, Nome da empresa é a propriedade de exibição principal das empresas.

Um exemplo de registro de empresa, mostrando o nome da empresa do registro como um exemplo de propriedade de exibição principal.

  • Rótulo: um nome de propriedade conforme aparece em seu CRM da HubSpot, como em registros ou páginas de índice. Por exemplo, a propriedade de Nome da empresa é o rótulo. Os rótulos das propriedades estão sujeitos a alterações e não devem ser usados por integrações ou APIs.
  • Nome interno: o valor interno de uma propriedade que é usado por integrações ou APIs. Por exemplo, o valor interno da propriedade de Nome da empresa é name. Os nomes internos não podem mudar e devem ser usados por integrações e APIs para fazer referência à propriedade.

Configurações da propriedade de nome da empresa, destacando o valor do nome interno da propriedade.

  • Propriedades secundárias: propriedades de identificação adicionais para um objeto. Essas propriedades são exibidas no cartão do perfil em um registro sob a propriedade de exibição principal. Também podem ser usadas para pesquisar registros na página de índice. Para objetos personalizados, também aparecem como filtros rápidos adicionais na página de índice. Por exemplo, as propriedades secundárias para Empresas são Nome de domínio da empresa e Número de telefone, enquanto uma propriedade secundária personalizada para Pets poderia ser Tipo de pet.

Um exemplo de registro de empresa, mostrando o domínio da empresa e o número de telefone do registro como exemplo de propriedades de exibição secundárias.

object-settings-secondary-property-type-of-pet-example

Exemplos

Os exemplos abaixo são baseados em casos de uso comuns para ajudá-lo a entender como um objeto personalizado pode afetar os dados de uma conta, mas eles não foram criados como um conselho para cada cenário. Para discutir se um objeto personalizado é adequado para seu caso de uso específico, entre em contato com seu Gerente de sucesso do cliente.

Estes são bons exemplos de um objeto personalizado:

  • Um canil quer registrar os animais que hospeda, associar cada um deles aos seus donos e acompanhar as atividades relacionadas a cada animal. Eles criam um objeto Pets com Nome do pet como a propriedade de exibição principal e Tipo de pet como uma propriedade secundária. Eles exibem e pesquisam os animais de estimação com os quais trabalham em uma página de índice, salvam exibições com base no tipo de animal de estimação, associam contatos a um animal de estimação e gerenciam atividades e compromissos dentro do registro de um animal de estimação.
  • Uma concessionária de carros quer manter um banco de dados dos carros que eles têm em estoque ou que venderam e manter o controle de consultas de vendas relacionadas a cada carro. Eles criam um objeto Carros com Modelo como a propriedade de exibição principal. Eles criam uma pipeline de objeto personalizado para rastrear carros à medida que eles passam de estágios como novos para inventário, no processo de compra e vendidos. Eles exibem chamadas de consulta ou e-mails registrados no registro de cada carro e associam contatos e negócios quando o carro está sendo vendido.

Estes são exemplos em que não é recomendado criar um objeto personalizado:

  • Uma escola tem um banco de dados de alunos, responsáveis e professores. Eles querem criar objetos personalizados para responsáveis e professores para ajudar a diferenciar os tipos de contato. Este não é um bom caso de uso porque um objeto personalizado não deve replicar um Objeto do CRM existente. Uma pessoa pode ser tanto um responsável quanto um professor, o que resultaria na sobreposição de dados. Além disso, a escola não poderia enviar e-mails em massa aos responsáveis e professores porque eles não são contatos. Em vez disso, eles poderiam incluir todos os tipos de contatos no objeto de contatos e criar uma propriedade personalizada de Tipo de contato com as opções Aluno, Responsável e Professor.
  • Uma empresa de melhoramento doméstico usa observações nos registros do HubSpot para fazer solicitações internas aos seus contratados. Eles desejam criar um objeto Observações para controlar todas as solicitações. Este não é um bom caso de uso porque o objeto personalizado não deve substituir as atividades. Isso adiciona etapas extras em comparação à marcação de usuários, outras atividades de registros não puderam se associar automaticamente aos registros de anotações personalizadas e não puderam usar relatórios de atividades pré-criados. Além disso, as informações sobre um projeto poderiam ser armazenadas em vários locais se os usuários estiverem atualizando o registro da observação personalizada e outro registro associado, possivelmente levando a dados duplicados ou conflitantes. Em vez disso, eles poderiam criar observações nos registros, associá-las a outros registros, marcar usuários do HubSpot nelas e usar relatórios predefinidos para rastrear a atividade das observações.

Criar um objeto personalizado

Para criar um objeto personalizado no HubSpot:

  1. Na sua conta da HubSpot, navegue até Gerenciamento de dados > Modelo de dados.
  2. No painel esquerdo, clique em Criar um objeto personalizado .
  3. No painel direito, configure o objeto personalizado:
    • Para definir o nome do objeto personalizado:
      • Nome do objeto (Singular): insira o título no singular do seu objeto personalizado (por exemplo, Pet).
      • Nome do objeto (Plural): insira o título no plural do seu objeto personalizado (por exemplo, Pets).
    • Insira uma descrição de objeto opcional que explique aos usuários da sua conta o que é o objeto e como ele deve ser usado.
    • Para criar a propriedade de exibição principal do objeto: 
      • Propriedade de exibição principal: insira um rótulo para a propriedade usada para nomear um registro do seu objeto (por exemplo, Nome do pet para pets). Esta propriedade é necessária para criar um registro de objeto personalizado.
      • Tipo de Propriedade: selecione o tipo da sua propriedade de exibição principal, como Texto de linha única, Número, Seletor de data, Caixa de seleção única ou Seleção de menu suspenso.  
      • Clique no edit ícone Editar abaixo do rótulo para editar o nome interno da propriedade e clique em Salvar para confirmar. O nome interno é usado pelas integrações ou APIs e não pode ser editado após a criação do objeto.
      • Marque a caixa de seleção para exigir valores exclusivos para a propriedade de exibição principal. Com essa opção ativada, os usuários não poderão inserir o mesmo valor para vários registros (por exemplo, para o objeto Pedidos, a propriedade principal Número do pedido deve exigir valores exclusivos).

Definições de configuração de objeto personalizado, mostrando valores de exemplo para a criação de um objeto personalizado e definição de propriedades de exibição principal.

    • Para criar uma propriedade secundária para seu objeto personalizado:
      • Propriedade de exibição secundária: insira um rótulo que é exibido abaixo da propriedade principal em um registro (por exemplo, Tipo de pet e Número de telefone do dono para Pets). As propriedades secundárias não são necessárias para criar um registro de objeto personalizado e podem ser adicionadas ou removidas posteriormente, editando o objeto personalizado.
      • Tipo de Propriedade: selecione o tipo da sua propriedade de exibição principal, como Texto de linha única, Número, Seletor de data, Caixa de seleção única ou Seleção de menu suspenso.
      • Clique no edit lápis abaixo do rótulo para editar o nome interno da propriedade e clique em Salvar para confirmar. O nome interno é usado pelas integrações ou APIs e não pode ser editado após a criação do objeto.
    • Clique em + Adicionar propriedade para adicionar mais uma propriedade de exibição secundária. Isso só aparecerá depois que você definir um rótulo e um tipo de propriedade para a primeira propriedade secundária.
    • Clique no delete ícone Excluir ao lado da propriedade para remover uma propriedade secundária existente.

Configuração de objeto personalizado, mostrando valores de exemplo para propriedades de exibição secundárias.

  1. Quando terminar, clique em Criar na parte inferior do painel.

Você também pode usar seu modelo de dados ou Breeze Copilot para criar um objeto personalizado.

Definir configurações adicionais

Depois de definir um objeto personalizado, você pode fazer o seguinte nas configurações de objeto personalizado:

Editar ou excluir um objeto personalizado

Depois de criar um objeto personalizado, você pode editar seu nome e propriedades ou excluir o objeto da conta da HubSpot. Você também pode editar e excluir objetos personalizados nas configurações de objeto personalizado ou por meio da API.

Para editar ou excluir no modelo de dados: 

  1. Na sua conta da HubSpot, navegue até Gerenciamento de dados > Modelo de dados.
  2. Navegue até seu objeto personalizado.
  3. No cartão de objeto personalizado, clique no ellipses ícone de três pontos horizontais e selecione:
    Cartão de Objeto personalizado no construtor de modelos de dados com o ícone de três pontos horizontais selecionado, exibindo opções como Editar objeto e Excluir objeto
    • Exibir uso do objeto: clique para expandir a seção que deseja exibir onde no HubSpot o objeto está sendo usado no momento. Clique no nome de um ativo para navegar até a ferramenta.
    • Editar objeto: você pode editar o nome no singular, o nome no plural e a descrição do objeto, bem como adicionar ou remover propriedades de exibição secundárias. Se precisar editar a propriedade de exibição principal, você poderá fazê-lo usando a API de objeto personalizado. Você não pode editar os nomes internos de objetos ou propriedades.
      • Para editar os nomes das propriedades de exibição primárias ou secundárias existentes, clique em Editar rótulo da propriedade para navegar até as configurações da propriedade.
      • Para adicionar uma propriedade secundária adicional, clique em + Adicionar propriedade, insira o nome da propriedade e selecione o tipo de propriedade.
      • Para remover uma propriedade secundária, passe o mouse sobre a propriedade e clique no ícone delete excluir. Se você remover uma propriedade secundária, ela ainda estará acessível nos registros de objeto personalizado, mas não será mais exibida nos filtros de cartão de perfil ou de página de índice. Se quiser excluir as propriedades, aprenda como arquivar e excluir propriedades nas configurações das propriedades.
      • Clique em Salvar para confirmar as alterações.
    • Excluir objeto: na caixa de diálogo, marque a caixa de seleção para confirmar que não é possível restaurar um objeto personalizado excluído e, em seguida, clique em Excluir objeto para confirmar. Você não pode excluir um objeto personalizado que está sendo usado no momento por outras ferramentas; será necessário remover referências ao objeto dessas ferramentas antes de excluí-lo.

Definir associações de objetos personalizados

Antes de adicionar registros associados a registros de objeto personalizado (por exemplo, contatos para animais de estimação), você precisa criar a relação de associação nas configurações. Você pode configurar associações com objetos como contatos, empresas, negócios e tickets. Saiba mais sobre as possibilidades de objetos associados.

  1. Na sua conta HubSpot, clique no ícone de configurações settings icon na barra de navegação superior.
  2. No menu da barra lateral esquerda, navegue até Objetos e selecione Objeto personalizado.
  3. Se você tiver vários objetos personalizados, clique no menu suspenso Selecionar um objeto e selecione o objeto personalizado para o qual deseja definir associações.
  4. Clique na guia Associações.
  5. Se você estiver adicionando a primeira associação do objeto, clique em Criar nova associação. Para adicionar mais uma associação, clique no menu suspenso Selecionar associações de objeto e selecione Criar nova associação.
  6. Na caixa de diálogo, clique no menu suspenso e selecione o objeto ao qual deseja associar o objeto personalizado.
  7. Clique em Criar.

Um GIF exibindo as configurações da associação de objeto personalizado, mostrando as etapas para criar uma nova associação.

Agora você pode associar os registros dos objetos selecionados e criar rótulos para descrever as associações.

Esse artigo foi útil?
Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.