Integrações – 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.

Isso não é uma limitação da plataforma, é uma limitação do provedor. E a orientação prática é a mesma de outros casos assim: se a sua empresa usa acesso único, a exigência de autenticação forte é imposta pelo provedor de identidade, e é lá que ela se comprova. Se você precisa de evidência da configuração no próprio HubSpot, ela vai por captura de tela como evidência manual.

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:

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.

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.