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.

Premissas para integração

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

2. Ter uma conta na Privacy Tools

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

1. 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.
   

   

2. 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:

   

3. Clicar no link e realizar login no RD Station Marketing.

4. Após login e confirmação de acesso, enviaremos o code para a URL de callback.

5. 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"
   }

6. Guarde o refresh_token para usá-lo na configuração do webhook

Passo 2 - Configurar webhook

2.1 Crie um webhook na Privacy Tools, em Webhooks -> Meus webhooks. 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 webhook clicando no botão “Testar Webhook”. 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 Staus (200)

2.2 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. A trigger 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 a sua trigger seja executada. Por exemplo, você possui 10 finalidades na gestão de consentimentos mas apenas uma delas é a que deve acionar a trigger, 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.

Após realizar as alterações, clique em salvar no botão abaixo.

Para mais detalhes de como criar uma trigger, acesse: https://privacyts.atlassian.net/wiki/spaces/GSD/pages/554500097/Webhooks#Trigger