Dropbox

9 min

Objetivo/Resumo

Este conector foi desenvolvido para facilitar a integração e a automação de tarefas com o Dropbox. Seu objetivo principal é permitir que usuários acessem, armazenem, transfiram e organizem arquivos e pastas diretamente em sua conta Dropbox a partir de outras aplicações e fluxos. Com esse conector, é possível centralizar documentos na nuvem, reduzir atividades manuais e garantir maior controle sobre arquivos usados em processos de negócio.

Recomendação: Para detalhes sobre escopos, fluxos OAuth e endpoints de API, consulte a documentação oficial da Dropbox API

Criando um fluxo utilizando o Conector Dropbox

Para criar um fluxo utilizando o conector Dropbox, é necessário primeiro criar uma conexão OAuth2.0, e depois configurar os passos do fluxo conforme as ações desejadas.

Criando conexão com o Dropbox

Registre seu aplicativo em: https://www.dropbox.com/developers/apps
No cadastro da aplicação, selecione:
- Scoped access
- Tipo de acesso: Full Dropbox ou App folder, conforme seu uso
Em Redirect URIs, adicione: https://console.fluidapi.io
Copie os seguintes dados do app:

App Key
App Secret

Em seguida, na plataforma Fluid, crie uma nova conexão com os seguintes campos:

Nome: Identificador da conexão (campo obrigatório)
Descrição: Descrição opcional sobre a finalidade da conexão
App Key: Obtido no registro do app
App Secret: Obtido no registro do app
Escopos sugeridos:
- files.content.read
- files.content.write
- files.metadata.read
- files.metadata.write
- account_info.read

Após preencher os campos, clique em Login OAuth2, autentique-se com a conta Dropbox e salve a conexão.

Configurando fluxo com Dropbox

Com a conexão criada, crie um novo fluxo e adicione o conector Dropbox ao canvas.

Parametrização

Na aba Parametrização, configure os seguintes parâmetros:

Recurso: entidade para qual será realizada a ação.
Operação: ação que será realizada para o recurso selecionado.
- Operações disponíveis para recurso Arquivo:
  - Criar: é obrigatório informar os campos 'Nome do Arquivo', 'Extensão' e o 'Conteúdo' podendo ser eviado utilizando De/para ou Template, caso não seja informado o campo 'ID da Pasta', o arquivo será inserido na raiz do onedrive;
  - Ler: informe o 'Caminho do Arquivo' que pretende fazer a leitura;
  - Excluir: informe o 'Caminho do Arquivo' que pretende excluir;
- Operações disponíveis para recurso Diretório:
  - Criar: informe o 'Nome da Pasta' que deseja criar;
  - Excluir: informe o 'Nome da Pasta' que deseja excluir;

Na aba Propriedades, selecione a conexão criada anteriormente, defina um nome para o passo e, se necessário, adicione uma descrição.

Na prática

Neste exemplo, criaremos um fluxo simples que cria uma nova pasta no Dropbox:

Passo criapasta

Assim ficará a Parametrização do nosso unico passo:

Na aba Propriedades informamos o nome do passo e a conexão criada para o Dropbox:

Disparando o Fluxo

Com o passo configurado 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: