Ignorar e ir ao conteúdo principal

A base da sua conta da HubSpot é um banco de dados dos seus relacionamentos e processos de negócios, denominado CRM (Gerenciamento de relacionamento com o cliente). Para gerenciar esses dados, as contas da HubSpot incluem objetos, que representam tipos de relacionamentos ou processos. As instâncias individuais de objetos, chamadas de registros, representam as entidades individuais sob cada tipo de objeto (por exemplo, John Smith é um contato). Para armazenar dados em cada registro, você usará propriedades (por exemplo, a propriedade de e-mail) e, para representar as relações entre entidades individuais, você poderá associar registros entre si (por exemplo, associar John Smith a uma empresa Smith & Co.) Além disso, os registros do CRM também podem armazenar informações sobre interações por meio de engajamentos/atividades associadas, como e-mails, chamadas e reuniões. Abaixo, saiba mais sobre objetos, registros, propriedades, associações, pipelines e pesquisas no CRM. Para saber mais sobre como gerenciar seu banco de dados de CRM no HubSpot, confira a Central de Conhecimento da HubSpot.

As APIs de objetos fornecem acesso a registros e atividades. Para objetos suportados, você pode usar pontos de extremidade de objeto e substituir {objectTypeId} na URL de solicitação com o objeto desejado. Por exemplo, para criar contatos, você faria um POST pedido para crm/v3/objects/0-1 e para criar cursos, a solicitação seria crm/v3/objects/0-410. Consulte este artigo para obter mais informações sobre como usar os pontos de extremidade do objeto para vários objetos.

Ao usar CRM e outras APIs, você precisará usar o campo objectTypeId, que é um valor numérico exclusivo atribuído a cada objeto. Por exemplo, para recuperar registros, você faria um pedido GET para /crm/v3/objects/{objectTypeId}, ou ao criar uma propriedade para um objeto, você faria um POST pedido para /crm/v3/properties/{objectTypeId}Os valores de ID do tipo de objeto estão listados na tabela abaixo:

Tipo de IDObjetoDescrição
0-2EmpresasArmazena informações sobre uma empresa ou organização. Veja a API de empresas
0-1Contatos: armazenam informações sobre uma única pessoa. Veja a API de contatos
0-3NegóciosRepresentam oportunidades de vendas e transações, rastreadas por estágios do pipeline. Veja a API de negócios
0-5TicketsRepresentam solicitações de ajuda ou suporte do cliente, rastreadas por meio de status de pipeline. Veja a API de tickets
0-421CompromissosRepresentam encontros ou serviços agendados para um indivíduo. Veja a API de objetos
0-48ChamadasUm tipo de atividade que representa interações telefônicas associadas aos seus registros. Veja a API de chamadas
0-18ComunicaçõesUm tipo de atividade que representa interações de mensagens SMS, LinkedIn e WhatsApp associadas aos seus registros. Veja a API de comunicações
0-410CursosRepresentam programas estruturados ou séries de lições, treinamentos ou módulos educacionais. Veja a API de objetos
2-XXXObjetos personalizadosArmazenam dados que não se encaixam nos objetos existentes. Para encontrar o objectTypeId para um objeto personalizado, faça um pedido GET para /crm/v3/schemas. Veja a API de objetos personalizados
0-49E-mailsUm tipo de atividade que representa interações de e-mail individuais associadas aos seus registros. Veja a API de e-mail
0-19Envios de feedbackArmazena informações enviadas para uma pesquisa de feedback. Os envios de feedback são associados aos registros de contatos. Veja a API de envio de feedback
0-52FaturasRepresentam as faturas enviadas para transações de vendas. As faturas podem ser associadas a contatos, empresas, negócios, itens de linha, descontos, impostos e taxas. Veja a API de faturas
0-136LeadsRepresentam clientes em potencial que demonstraram interesse em seus produtos ou serviços. Veja a API de leads
0-8Itens de linha: representam produtos e serviços individuais vendidos em um negócio. Os itens de linha podem ser criados de produtos existentes na sua biblioteca de produtos ou como itens independentes. Veja a API de itens de linha
0-420ListagensRepresentam propriedades ou unidades a serem compradas, vendidas ou alugadas. Veja a API de objetos
0-54Eventos de marketingRepresentam eventos relacionados aos seus esforços de marketing, incluindo especificamente eventos de integrações conectadas. Você pode especificar se um contato compareceu, se registrou ou cancelou a participação em um evento de marketing. Veja a API de eventos de marketing
0-47ReuniõesUm tipo de atividade que representa interações de reunião associadas aos seus registros. Veja a API de reuniões
0-46NotasUm tipo de atividade que representa notas associadas aos seus registros. Veja a API de notas
0-101PagamentosOs pagamentos feitos pelos compradores por meio de faturas, links de pagamento e orçamentos. Os pagamentos podem ser associados a contatos, empresas, negócios, faturas, orçamentos, itens de linha, assinaturas, descontos, impostos e taxas. Veja a API de pagamentos
0-116Caixa de e-mailsUm tipo de atividade que representa interações de correio físico associadas aos seus registros. Veja a API de caixa de e-mails
0-7ProdutosRepresentam mercadorias ou serviços para venda. Os produtos não podem ser associados a outros objetos, mas você pode criar itens de linha com base em produtos e associá-los a negócios e orçamentos. Veja a API de produtos
0-14OrçamentosRepresentam as informações de preços compartilhadas com potenciais compradores. Os orçamentos podem ser associados a contatos, empresas, negócios e itens de linha. Veja a API de orçamentos
0-162ServiçosRepresentam ofertas intangíveis fornecidas aos clientes. Exemplos incluem integração e consultoria, reparos e manutenção e cuidados pessoais. Veja a API de objetos
0-69AssinaturasRepresentam pagamentos recorrentes programados por meio de links de pagamento e cotações. As faturas podem ser associadas a contatos, empresas, negócios, orçamentos, itens de linha, pagamentos, descontos, impostos e taxas. Veja a API de assinaturas
0-27TarefasUm tipo de atividade que representa tarefas associadas aos seus registros. Veja a API de tarefas
0-115UsuáriosRepresentam os usuários na sua conta da HubSpot. Os usuários não podem ser associados a outros objetos, mas podem ser recuperados e atualizados via API. Veja a API de detalhes do usuário

Você sempre pode usar o valor de ID do tipo numérico, mas, em alguns casos, também pode usar o nome do objeto para contatos, empresas, negócios, tickets ou notas. Por exemplo:

  • Ao iniciar uma importação com a API de importações, o columnObjectTypeId especifica a qual objeto pertencem os dados em seu arquivo. Para importar dados de contatos, seu valor para columnObjectTypeId pode ser contact ou 0-1.
  • Ao usar a API de associações, os valores fromObjectType e toObjectType especificam os objetos e a direção da associação. Para exibir os tipos de associação de contatos para empresas, seu URL de solicitação GET pode ser crm/v4/associations/contact/company/labels ou crm/v4/associations/0-1/0-2/labels.

Um identificador exclusivo é um valor que diferencia um registro em um CRM de outro, mesmo que eles tenham informações idênticas. Por exemplo, no banco pode haver registros de duas pessoas com o nome John Smith. Para evitar o envio acidental de dinheiro para o John Smith errado, cada registro recebe um número como seu _ID de Registro . Quando um registro é criado no HubSpot, seu _ID de Registro (hs_object_id) é gerado automaticamente e deve ser tratado como uma string. Os IDs de registro são exclusivos dentro de um objeto, portanto, pode haver um contato e uma empresa com o mesmo ID. Para contatos e empresas, há identificadores exclusivos adicionais, incluindo o email de um contato e o nome de domain de uma empresa. Para contatos, empresas, negócios, ingressos, compromissos, cursos, listagens, serviços e objetos personalizados, você também pode criar propriedades de identificador exclusivas personalizadasNas APIs de CRM, você usará valores de identificadores exclusivos para identificar e gerenciar registros específicos. Você sempre pode usar um registro hs_object_id valor, mas também pode usar propriedades de identificador exclusivo personalizadas para determinados pontos de extremidade, especificados pelo idProperty parâmetro. Por exemplo, para editar um contato, você pode fazer um PATCH pedido para /crm/v3/objects/0-1/{contactId} ou /crm/v3/objects/0-1/{contactEmail}?idProperty=email. Saiba mais sobre como o HubSpot lida com a desduplicação no Base de conhecimento.

Na HubSpot, você pode mostrar como os objetos estão relacionados entre si associando seus registros. Por exemplo, você pode associar vários contatos a uma empresa e, em seguida, associar a empresa e os contatos relevantes a um negócio. Ao usar o endpoints de API de associações, você pode substituir objetos por {toObjectTypeId} e {fromObjectTypeId} nas URLs e corpos de solicitação. Antes de associar registros entre objetos, para entender quais objetos podem ser associados uns aos outros, você pode recuperar tipos de associação. Por exemplo, os contatos podem ser associados à maioria dos objetos, enquanto as cotações podem ser associadas apenas a contatos, empresas, negócios e itens de linha. Dependendo da sua assinatura, você pode descrever os tipos de relacionamento específicos entre registros usando rótulos de associação, e sua conta pode ter objetos personalizados adicionais, que podem ser associados aos outros objetos padrão. Saiba mais sobre relacionamentos de objetos e gerenciamento de associações usando o associações endpoints. Se você tiver acesso a uma conta HubSpot, também poderá revisar os relacionamentos de objetos exclusivos da sua conta navegando até a ferramenta de modelo de dados.visão geral do modelo de dados atualizado

As informações sobre registros são armazenadas em campos chamados de propriedades, que são então organizados em grupos. O HubSpot fornece um conjunto de propriedades padrão para cada objeto. Além de cada propriedade padrão do objeto, você pode armazenar dados personalizados criando propriedades personalizadas. Ao usar a API de propriedades, você pode substituir objetos nos endpoints para criar e gerenciar as propriedades de um objeto. Por exemplo, /crm/v3/properties/0-1 para propriedades de contato ou /crm/v3/properties/0-5 para propriedades de tickets. Saiba mais sobre como usar a API de propriedades neste artigo.

Para filtrar e classificar registros e atividades com base em suas propriedades e associações, você pode usar a API de pesquisa. Ao usar os pontos de extremidade de pesquisa, substitua o valor {objectTypeId} para o objeto no qual você deseja pesquisar. Por exemplo, para pesquisar chamadas, você faria uma solicitação POST para /crm/v3/objects/0-48/search. Saiba mais sobre como usar a API de pesquisa do CRM neste artigo.

Na HubSpot, você pode usar pipelines para rastrear registros por estágios dos seus processos. Por exemplo, você pode rastrear negócios por meio de processos de vendas ou tickets por meio de status de suporte. Usando a API de pipelines, você pode criar, recuperar, editar e excluir pipelines e estágios de pipeline. Saiba quais objetos têm pipelines e como usar a API de pipelines neste artigo.