DT Exportação clientes para plataforma RD Station via integração por API.

01. DADOS GERAIS

02. SITUAÇÃO/REQUISITO

Cliente utiliza a plataforma de marketing da RD STATION, sendo que atualmente o mesmo cadastra os clientes no TOTVS Moda e depois de forma manual cadastra este mesmo cliente na plataforma. Haja visto que a RD Station possui API de integração, foi solicitado implementação da integração entre TOTVS Moda e RD Station para automatizar o cadastro na plataforma.

03. SOLUÇÃO

Para a realização do envio do clientes para plataforma foi criando o componente PESFP079, onde no mesmo serão selecionados os clientes que irão ser enviados. Ao realizar a seleção de um ou mais clientes e solicitar o processamento, os respectivos clientes serão envidados para a plataforma.

Para que o sistema realizar a integração com a RD Station, deverão ser configurados algumas informações no componente INTFM010, sendo:

1. URL de requisição: 
   • DS_URL=https://api.rd.services/platform/contacts/{identifier}:{value}
   • Caso queira que seja gravado o log da requisição deverá ser acrescentado o parâmetro IN_LOG=TRUE
2. Dados de requisição do token:
   • DS_URL=https://api.rd.services/auth/token
   • CLIENT_ID={Id fornecido pela plataforma}
   • CLIENT_SECRET={Secret fornecido pela plataforma}
   • CODE={Code fornecido pela plataforma}
   • Para obtenção das credencias para geração do token de autenticação deverá ser seguido os passos conforme documentação da API em: https://developers.rdstation.com/pt-BR/authentication
3. Parâmetros para depara de informações do cliente:
   • CD_TIPOFONEPESSOAL={Tipo cadastrado no componente PESFL019}
   • CD_TIPOFONECELULAR={Tipo cadastrado no componente PESFL019}
   • CD_TIPOEMAIL={Tipo cadastrado no componente PESFL018}
   • CD_TIPORSFACEBOOK={Tipo cadastrado no componente PESFM095}
   • CD_TIPORSLINKEDIN={Tipo cadastrado no componente PESFM095}
   • CD_TIPORSTWITER={Tipo cadastrado no componente PESFM095}
   • CD_CAMPOADICRDSTATION={Código cadastrado no componente PESFL101}
   • CD_TIPOCLASTAG={Tipos cadastrados no componente PESFL030}

Ao realizar a configuração para separação dos parâmetros deverá ser usado o carácter "·;".

Os dados enviados para a plataforma serão os seguintes:

{
"name":"RD Station Developer",
"email": "contact@example.com"
"website":"https://developers.rdstation.com/",
"bio":"This documentation explains the RD Station API.",
"job_title":"Developer",
"linkedin":"rd_station",
"facebook":"rd_station",
"twitter":"rd_station",
"city":"Florianópolis",
"state":"SC",
"country":"Brasil",
"personal_phone":"+55 48 3037-3600",
"mobile_phone":"+55 48 3037-3600",
"tags": ["developer", "rdstation", "api"]
}

Para o envio do campo "bio" será considerado as observações gravadas pelo componente  PESFM023.

Para o envio dos campos "city, state, country" será considerado o primeiro endereço cadastrado para a pessoa.