Hubspot - Integração de consentimentos
- Nicole de Marchi Leite
- Henrique Bernst
- Luiz Leite
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.
Documentação oficial de API’s do Hubspot:
Premissas para integração
Você possui uma conta criada no Hubspot
Você possui uma conta criada na Privacy Tools
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 fluxo
Agora vamos configurar o fluxo na Privacy Tools para notificar o Hubspot sempre que um consentimento de alguém mudar.
1 - Crie um fluxo 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"
}
Cabeçalhos:
Nome: content-type
Valor: application/json
Salve o fluxo.
1.1 - Crie um gatilho para disparar o fluxo
Com o fluxo criado agora vamos configurar uma trigger para executar o fluxo quando acontecer algum evento. Acesse o menu “Meus gatilhos” e crie uma nova conforme o exemplo abaixo. Nesse caso é uma trigger que vai executar o fluxo 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.
IMPORTANTE: Quando haver um consentimento revogado o Hubspot não permite que seja aceito novamente.
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.
Será necessário criar a trigger de consentimento aceito e consentimento revogado separadamente pois o Hubspot não permite mais de uma ação por gatilho.