Contatos

No HubSpot, os contatos armazenam informações sobre pessoas. Da automação de marketing ao conteúdo inteligente, os dados específicos do lead encontrados nos registros de contato ajudam os usuários a aproveitar ao máximo a funcionalidade do HubSpot. Os endpoints de contatos permitem que você gerencie e sincronize esses dados entre o HubSpot e outros sistemas.

Os contatos, assim como as empresas, os negócios, os tickets, os itens de linha, os produtos e as cotações, são objetos no HubSpot CRM. Saiba mais sobre propriedades de objeto, associações, relacionamentos e muito mais em nosso guia Noções básicas do CRM. Para ver mais detalhes sobre os tipos de registro do HubSpot, use nosso Guia para registros.

Exemplo de caso de uso: Sua equipe está trabalhando com o HubSpot e outro sistema de software. Embora precisem ter informações de contato exatas nos dois sistemas, eles não querem perder tempo com atualizações manuais. Você pode usar os endpoints de contatos para integrar os dois sistemas e sincronizar as informações de contatos. 

Limites

Os registros de contatos têm alguns limites, o que pode afetar os testes feitos com os endpoints de contatos. Para obter mais informações, leia sobre limites de formulários e contatos.

As operações em lote para criação, atualização e arquivamento devem ser limitadas a lotes de 10.

Identificadores exclusivos e deduplicação

Um endereço de e-mail é o identificador principal exclusivo de um contato no HubSpot. Para contatos existentes, o ID do contato também é exclusivo e vai deduplicar contatos. Para atualizar um contato através da API, você pode usar o ID ou o e-mail do contato.

O parâmetro de consulta idProperty não aparece na guia Endpoints devido a limitações técnicas, mas pode ser usado para contatos exclusivamente com email. Para usar um endereço de e-mail como identificador exclusivo, defina idProperty como email e insira o endereço de e-mail no lugar do ID do contato. Ele deve ser definido como parâmetro de consulta em vez de adicionado ao corpo da solicitação.

Propriedades do contato

Os detalhes do contato são armazenados nas propriedades do contato. Além daspropriedades padrão, você pode armazenar dados personalizados criando propriedades de contato personalizadas. É possível gerenciá-las usando endpoints de propriedades de objetos do CRM.

Atualizações da fase do ciclo de vida

Se estiver usando uma API para transformar um contato em cliente (para refletir uma fase de negócio atualizada), defina o valor da propriedade lifecyclestage como “cliente”.

Verificando atualizações

Para possibilitar o uso de novas funcionalidades, ocasionalmente a HubSpot atualizará as propriedades padrão existentes. Além disso, de vez em quando, os usuários também podem alterar as propriedades personalizadas. Se sua integração for usada com contatos, é recomendável que você utilize os endpoints de propriedades de objetos para verificar periodicamente as atualizações.

Associações entre contatos e outros objetos

Os contatos podem ser associados a empresas, negócios, envolvimentos tickets e objetos personalizados. Você pode gerenciar associações de objeto usando endpoints de associações do CRM. 

Para ver como objetos se relacionam entre si no HubSpot, confira a seção Relacionamentos de objetos na página "Noções básicas do CRM".

Observação: O valor de archivedAt retornado para esses endpoints de contatos corresponde, de fato, à data da última modificação de determinado objeto. Atualizaremos o log de alterações e esta documentação quando esse valor refletir a data e a hora reais da exclusão do objeto.


Esse artigo foi útil?
Este formulário é para comentários sobre nossos documentos de desenvolvimento. Se tiver comentários sobre o produto da HubSpot, em vez disso compartilhe sua opinião no Fórum de Ideias.