Conectores
Finança e Conta

BTG-ID

7min

Objetivo/Resumo

A BTG é uma instituição financeira brasileira que oferece uma variedade de serviços e produtos relacionados ao mercado financeiro. O conector BTG-ID foi projetado para oferecer aos usuários facilidades em suas integrações com a plataforma.

Criando um fluxo utilizando Conector BTG-ID

Para criar um fluxo utilizando o conector BTG-ID, é preciso criar uma conexão e em seguida configurar o fluxo.

Criando conexão BTG-ID

OBS: Acesse aqui nosso passo a passo criar uma conexão.

Estes são os seguintes parâmetros de configuração da conexão BTG-ID que serão requisitados em sua criação:

  • Nome: parâmetro padrão em qualquer criação de uma conexão, te ajudará a identificar melhor sua conexão (campo obrigatório);
  • Descrição: parâmetro padrão e opcional em qualquer criação de uma conexão, aqui você pode relatar detalhadamente para quais fins servirá sua conexão;
  • ID do Cliente: informe o client_id da aplicação (campo obrigatório);
  • Chave Secreta do Cliente: informe o client_secret da aplicação (campo obrigatório);
  • URL do ambiente que será usado a conexão: informe o ambiente de acesso da conexão (campo obrigatório);

Configurando fluxo com BTG-ID

Crie um fluxo (passo a passo aqui) e arraste o conector BTG-ID para o canvas.

Document image


Selecione o conector e na aba de Parametrização preencha os seguintes parâmetros de configuração:

  • Operação: ação que será realizada.
    • Obter Credenciais: requer o preenchimento do campo Grant Type (tipo de concessão), e dos campos Type, Resource, Locations e Privileges, que serão mapeados no Authorizations Details (detalhes de autorização) esperado na api da BTG;

Nota: Alguns desses campos podem ser preenchidos usando Fluid Expression Language.

Na aba Propriedades , selecione a conexão desejada, dê um nome ao 'Passo' e se necessário detalhe uma descrição.

Na prática

Neste tópico criaremos um fluxo para demonstrar o conector BTG-ID na prática. O fluxo terá apenas um passo com nome credentials, que terá como responsabilidade buscar um token JWT válido com dados de autenticação de um determinado usuário da BTG.

Document image


Passo credentials

Assim ficará a Parametrização do nosso primeiro e único passo:

Document image


Preencha os campos requeridos (*). Para mais informações sobre dados de parametrização acesse a documentação oficial da BTG pactual.

Na aba Propriedades informamos o nome do passo e a conexão criada para o conector BTG-ID:

Document image


Disparando o Fluxo

Com os passos configurados basta disparar o fluxo. Nesse caso não precisaremos informar um payload de entrada, pois os dados que estamos usando no exemplo estão fixos no conector. Após o disparo, o resultado do fluxo será apresentado em tempo real no canvas:

Document image


Abrindo os detalhes do passo temos o retorno do token jwt com os dados das credenciais criptografados pelo BTG:

Document image