Conecta-seEntrar na plataforma

Dropbox

Enviar, baixar, compartilhar e administrar arquivos no Dropbox.

Integrações e ferramentasArquivos e documentosConexão: OAuth

O que faz

Integre o Dropbox ao seu fluxo para gerenciar, compartilhar e colaborar em arquivos. Envie arquivos, baixe conteúdos, crie pastas, gerencie links compartilhados e muito mais.

Quando usar: Use quando o seu fluxo precisar enviar, baixar, compartilhar e administrar arquivos no Dropbox.

Exemplo de situação: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

  1. Adicione Dropbox ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
  3. Escolha a operação. O painel mostra só os campos que essa operação usa.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Operações

OperaçãoO que faz
Enviar arquivoEnvia arquivo com o bloco Dropbox.
Baixar arquivoBaixa arquivo com o bloco Dropbox.
Listar pastaLista pasta com o bloco Dropbox.
Criar pastaCria pasta com o bloco Dropbox.
Excluir arquivo/pastaExclui arquivo/pasta com o bloco Dropbox.
Copiar arquivo/pastaCopia arquivo/pasta com o bloco Dropbox.
Mover arquivo/pastaMove arquivo/pasta com o bloco Dropbox.
Obter metadadosObtém metadados com o bloco Dropbox.
Criar link compartilhadoCria link compartilhado com o bloco Dropbox.
Buscar arquivosBusca arquivos com o bloco Dropbox.

Campos

Mostrar campos de

  • Operação

    Escolhe qual ação este bloco executará.

    Opções:
    Enviar arquivo · Baixar arquivo · Listar pasta · Criar pasta · Excluir arquivo/pasta · Copiar arquivo/pasta · Mover arquivo/pasta · Obter metadados · Criar link compartilhado · Buscar arquivos
    Padrão:
    Enviar arquivo

  • Conta do Dropbox

    Obrigatório

    Seleciona a conta já conectada que autoriza o acesso ao serviço.

    Exemplo:
    (escolha a conta conectada)

  • Conta do Dropbox

    ObrigatórioEm campos adicionais

    Informa manualmente a credencial usada pela integração no modo avançado.

  • Caminho de destino

    Obrigatório conforme a operação

    Caminho no Dropbox usado pela operação, começando com /: onde o arquivo enviado será salvo, ou qual arquivo ou pasta baixar, listar, excluir, consultar ou compartilhar (ex.: /Financeiro/notas/nf-1234.pdf).

    Aparece em:
    Enviar arquivo
    Exemplo:
    /documentos/exemplo.pdf

  • Arquivo

    Obrigatório conforme a operação

    Envie o arquivo que vai para o Dropbox.

    Aparece em:
    Enviar arquivo
    Exemplo:
    (selecione um arquivo de teste)

  • Arquivo

    Obrigatório conforme a operaçãoEm campos adicionais

    Referência a um arquivo de blocos anteriores.

    Aparece em:
    Enviar arquivo
    Exemplo:
    Referência a um arquivo de blocos anteriores

  • Modo de gravação

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Enviar arquivo
    Opções:
    Adicionar (criar novo) · Sobrescrever (substituir o existente)
    Padrão:
    Adicionar (criar novo)

  • Renomear automaticamente em caso de conflito

    Define o nome ou título usado para identificar o recurso.

    Aparece em:
    Enviar arquivo
    Exemplo:
    false

  • Incluir subpastas

    Ativa ou desativa este comportamento.

    Aparece em:
    Listar pasta
    Exemplo:
    false

  • Máximo de resultados

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Listar pasta
    Exemplo:
    10

  • Caminho de origem

    Obrigatório conforme a operação

    Caminho atual, no Dropbox, do arquivo ou pasta que será copiado ou movido (ex.: /Contratos/contrato-cliente.pdf).

    Aparece em:
    Copiar arquivo/pasta
    Exemplo:
    cliente@exemplo.com

  • Caminho de destino

    Obrigatório conforme a operação

    Caminho no Dropbox para onde o arquivo ou pasta vai ser copiado ou movido, já com o nome final (ex.: /Contratos/2025/contrato-cliente.pdf).

    Aparece em:
    Copiar arquivo/pasta
    Exemplo:
    /documentos/exemplo.pdf

  • Incluir informações de mídia

    Informa ou seleciona o arquivo usado nesta operação.

    Aparece em:
    Obter metadados
    Exemplo:
    false

  • Visibilidade

    Escolhe uma das opções aceitas por este campo.

    Aparece em:
    Criar link compartilhado
    Opções:
    Público (qualquer pessoa com o link) · Só a equipe · Protegido por senha
    Padrão:
    Público (qualquer pessoa com o link)

  • Senha do link

    Dado protegido

    Informe a senha do link.

    Aparece em:
    Criar link compartilhado
    Padrão:
    Segredo protegido

  • Data de expiração

    Data e hora em que o link compartilhado deixa de funcionar, no formato ISO 8601 em UTC (ex.: 2025-12-31T23:59:59Z); deixe vazio para um link que não expira.

    Aparece em:
    Criar link compartilhado
    Exemplo:
    2025-12-31T23:59:59Z

  • Consulta de busca

    Obrigatório conforme a operação

    Informa a consulta usada para localizar ou transformar dados.

    Aparece em:
    Buscar arquivos
    Exemplo:
    SELECT * FROM clientes WHERE status = 'ativo'

  • Extensões de arquivo

    Informa ou seleciona o arquivo usado nesta operação.

    Aparece em:
    Buscar arquivos
    Exemplo:
    pdf,xlsx,docx (separadas por vírgula)

  • Máximo de resultados

    Define um valor numérico, quantidade ou limite da operação.

    Aparece em:
    Buscar arquivos
    Exemplo:
    10

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <dropbox.file>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<dropbox.file>fileArquivo baixado, guardado nos arquivos da execução.
<dropbox.content>stringConteúdo do arquivo (base64).
<dropbox.temporaryLink>stringLink temporário para baixar o arquivo.
<dropbox.entries>jsonLista de arquivos e pastas (Listar pasta) ou de revisões do arquivo (Listar revisões).
<dropbox.cursor>stringCursor de paginação.
<dropbox.hasMore>booleanIndica se há mais resultados.
<dropbox.folder>jsonMetadados da pasta criada.
<dropbox.deleted>booleanIndica se a exclusão foi concluída com sucesso.
<dropbox.metadata>jsonMetadados do item.
<dropbox.sharedLink>jsonDetalhes do link compartilhado.
<dropbox.matches>jsonResultados da busca.
<dropbox.links>jsonLista de links compartilhados (url, name, path_lower, expires).
<dropbox.isDeleted>booleanIndica se a revisão mais recente foi excluída ou movida.

Exemplo de uso

Objetivo: Localizar ou produzir um documento e repassar seu conteúdo ao fluxo.

InícioDropboxpróxima etapa
Operação
Enviar arquivo
Conta do Dropbox
(escolha a conta conectada)
Caminho de destino
/documentos/exemplo.pdf
Arquivo
(selecione um arquivo de teste)
Modo de gravação
Adicionar (criar novo)
Renomear automaticamente em caso de conflito
false

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa
Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal
Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte
Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <dropbox.file>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece
Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403)
A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro
Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

Blocos relacionados