ImaraDocs

Como adicionar uma integração com o HubSpot

A integração com o HubSpot tem um propósito focado: confirmar que o seu sistema de relacionamento com clientes não está superprovisionado de super administradores.

Ela é rápida de configurar e tem cobertura deliberadamente estreita. Vale saber disso antes de investir tempo.

O que ela monitora#

Contagem de super administradores, para o controle de privilégio mínimo.

Disponibilidade do registro de auditoria, quando o plano incluir.

O que ela não monitora, e por quê#

A plataforma é explícita: autenticação forte e acesso único não são verificados, porque o HubSpot não oferece interface de programação que exponha essas configurações.

Por que essa integração ainda importa#

Poderia parecer pouco, e há um motivo para ela existir: o sistema de relacionamento com clientes é onde ficam os dados de clientes.

Em muitas empresas de tecnologia, o inventário de dados pessoais aponta o CRM como um dos maiores repositórios de informação de pessoas identificáveis. Quem tem super administrador ali pode exportar tudo.

Então a pergunta que esta integração responde, *quantas pessoas têm acesso total à sua base de clientes*, é uma das mais relevantes de um programa de privacidade, mesmo sendo apenas uma.

O que criar do lado do HubSpot#

Crie um aplicativo privado na sua conta, na área de integrações.

Conceda a ele dois escopos de leitura:

Escopo

Para quê

Leitura de usuários das configurações

A lista de usuários e seus papéis

Leitura de contatos

Necessário para a autenticação do aplicativo

Ao criar o aplicativo privado, o HubSpot gera um token de acesso.

O campo a preencher#

Apenas um: o token de acesso do aplicativo privado.

Captura de tela

configuração da integração com o HubSpot.

Dependências de plano#

Duas, e as duas se comportam corretamente:

O escopo de leitura de usuários é restrito a planos pagos. Em plano gratuito ele não está disponível, e a verificação de administradores fica de conferência manual.

O registro de auditoria é recurso de plano corporativo. Em planos inferiores, a verificação aparece como não aplicável, e explicitamente não como falha.

Como sempre na plataforma, você não é penalizado por não ter contratado o plano mais alto do seu fornecedor.

Boas práticas#

Revise os super administradores hoje. Este é o trabalho de maior retorno aqui, e não depende de integração nenhuma. É comum encontrar pessoas de marketing, vendas e liderança com acesso total ao CRM por conveniência histórica.

Considere o CRM no seu inventário de tratamento. Se ele guarda dados de clientes, ele deveria estar no seu registro de atividades de tratamento e no seu cadastro de fornecedores. A integração ajuda a lembrar que ele existe.

Nomeie o aplicativo privado de forma reconhecível.

Revogar é imediato. Apagar o aplicativo privado interrompe a coleta.

Depois de conectar#

Use Testar Conexão antes de salvar, aguarde o primeiro ciclo e confira os testes.

Não estranhe se poucas verificações mudarem de estado. A cobertura desta integração é estreita por natureza.

Problemas comuns#

Teste de conexão falhou. Token incorreto, ou o aplicativo privado não recebeu os escopos necessários.

Não consigo conceder o escopo de leitura de usuários. Ele depende de plano pago.

Registro de auditoria não aplicável. Depende de plano corporativo. Não é falha.

Não existe verificação de autenticação forte. É esperado. O HubSpot não expõe isso. Comprove pelo provedor de identidade ou por evidência manual.

Funcionava e parou. O aplicativo privado foi excluído ou o token foi regenerado.

Atualizado em Encontrou um problema? Fale com a Imara ↗