Hubspot - Integração de consentimentos

Objetivo da integração: Cada vez que um usuário der ou revogar consentimento na plataforma da PrivacyTools isso deve se refletir no Hubspot.

O Hubspot utiliza “tags” para segmentar os usuários. Logo, vamos considerar que a existência de uma tag significa que o usuário possui consentimento e a remoção da tag significa que não possui consentimento.

Premissas para integração

1. Você possui uma conta criada no Hubspot

2. Você possui uma conta criada na Privacy Tools

3. Você criou uma finalidade no recurso de finalidades de consentimento e copiou o hash da finalidade.

Passo 1 - Criando uma chave de integração no Hubspot

Na página de configuração da sua conta em “Perfil e Preferencias → abra integrações → Chave de API” conforme imagem abaixo.

Clique no botão “Criar ou Mostrar chave de API ativa”. Ao final a sua chave aparecerá na coluna conforme abaixo. Copie essa chave e guarde em segurança.

Passo 2 - Configurando o webhook

Agora vamos configurar o webhook na Privacy Tools para notificar o Hubspot sempre que um consentimento de alguém mudar.

1 - Crie um webhook com os seguintes valores:

• Método - POST

• Endpoint - https://api.hubapi.com/communication-preferences/v3/subscribe?hapikey=

• Senha - A sua API key copiada no passo anterior

Corpo da requisição em JSON:

{
  "emailAddress": "${email}",
  "subscriptionId": " ",
  "legalBasis": " ",
  "legalBasisExplanation": "Teste"
}

 Para adquirir o subscriptionId

Será necessário acesssar https://developers.hubspot.com/docs/api/marketing-api/subscriptions-preferences

Aba endpoints → clicar em “Test call” → API key (inserir a mesma) → Send request

Cabeçalhos:

Nome: content-type

Valor: application/json

Salve o webhook.

1.1 - Crie uma trigger para disparar o webhook

Com o webhook criado agora vamos configurar uma trigger para executar o webhook quando acontecer algum evento. Acesse o menu “Minhas triggers” e crie uma nova conforme o exemplo abaixo. Nesse caso é uma trigger que vai executar o webhook de consentimento positivo quando o usuário conceder um consentimento em qualquer lugar na PrivacyTools.

As condições para execução serão estabelecidas pela hash template será coletada na finalidade que está cadastrada com o consentimento que será coletada.

Pronto! Agora cada vez que um usuário der ou revogar um consentimento no seu portal da privacidade ou mesmo via API a atualização será feita no Hubspot.