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

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.

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