RDStation - Integração com Consentimentos

Objetivo da integração: Quando o titular aceitar um consentimento o sistema deve chamar API do RDStation para registro de aceite em uma lista. Quando o titular revogar o sistema deve chamar a API do RDStation para retirar o usuário de determinada lista.

Documentação da API RDStation:
https://developers.rdstation.com/pt-BR/overview

Premissas para integração

Ter uma conta no RDStation ( https://app.rdstation.com.br/dashboard )
Ter uma conta na Privacy Tools

Passo 1 - Pegar as chaves de integração no RDStation

Criar um aplicativo em https://appstore.rdstation.com/pt-BR/publisher

É necessário informar uma url de callback a qual o RDStation usará para enviar o código de autenticação.
Após, é necessário substituir os campos da URL abaixo pelos dados que você vai obter do aplicativo.
https://api.rd.services/auth/dialog?client_id={client_id}&redirect_uri={redirect_uri}. Após substituir o CLIENT ID e a REDIRECT URI na url acima, irá aparecer a seguinte tela:
Clicar no link e realizar login no RD Station Marketing.
Após login e confirmação de acesso, enviaremos o code para a URL de callback.
Solicitar o access_token e refresh_token a partir do code gerado, enviando uma requisição para API do RDStation. Substitua <CLIENT_ID>, <CLIENT_SECRET> e <CODE> pelos valores obtidos anteriormente.

curl --request POST --url 'https://api.rd.services/auth/token' --header 'Content-Type: application/json' --data '{ "code": "<CODE>", "client_id": "<CLIENT_ID>", "client_secret":"<CLIENT_SECRET>"}'
Exemplo de retorno:
{
"access_token":"eyJ0eXAiOiJKV1QiL……w",
"expires_in":86400,
"refresh_token":"9YORmXH…….8JDCQIQhBEUY"
}
Guarde o refresh_token para usá-lo na configuração do fluxo

Passo 2 - Configurar workflow

2.1 Crie um fluxo na Privacy Tools, em Workflow -> Meus fluxos. Preenchas os seguintes valores:

Método: PATCH
Endpoint: https://api.rd.services/platform/contacts/email:${identifier}
Método de autenticação: OAuth2- Client Credentials
Request Token URL: https://api.rd.services/auth/token
Refresh Token: refresh_token obtido no item 5 do passo 1
Client Id: obtido na criação do app, no passo 1
Client Secret: obtido na criação do app, no passo 1
Na aba “Corpo da requisição”, escolha “JSON”. Cole o seguinte json no editor de Json:

{

  "name": "${identifier}",

  "tags": [

    "privacytools",

    "receber email marketing"

  ],

  "legal_bases": [

    {

      "category": "communications",

      "type": "consent",

      "status": "granted"

    }

  ]

}

Onde: ${identifier} é o email que a Privacy Tools substituirá pelo email do usuário que deu consentimento.

Após preencher o formulário, é possível e recomendado testar o fluxo clicando no botão “Testar fluxo”. Na modal seguinte, preencha o formulário com valores de teste. Clique no botão “Testar”.

Se a configuração funcionou, deve mostrar o resultado com Http Status (200)

2.2 Crie um gatilho para disparar o fluxo:

Com o fluxo criado agora vamos configurar um gatilho para executar o fluxo quando acontecer algum evento. Acesse o menu “Meus gatilhos” e crie uma nova conforme o exemplo abaixo. O gatilho vai executar sempre que algum titular/usuário dar aceite em algum consentimento.

Condições para execução: No campo “Condições para execução” você pode definir condicionais para que o seu gatilho seja executado. Por exemplo, você possui 10 finalidades na gestão de consentimentos mas apenas uma delas é a que deve acionar o gatilho, basta você usar o hash da finalidade como comparador na sua condição conforme exemplo acima.

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 RD Station.