Como exportar dados do Dropbox Forms para um arquivo CSV

Atualizado Oct 23, 2025

In this article

warning icon

Observação importante: o Dropbox Forms será descontinuado em 30 de setembro de 2025. A partir de 2 de setembro de 2025, você não poderá mais criar novos fluxos de trabalho com o o Dropbox Forms, mas poderá visualizar os fluxos de trabalho existentes e exportá-los até o prazo de 30 de setembro.

Saiba mais sobre o fim do suporte para o Dropbox Forms.

Você pode usar o Dropbox Forms para baixar seus dados em um arquivo CSV. Esse recurso está disponível apenas para planos pagos do Dropbox Forms. 

Os administradores da equipe podem baixar dados de até 25.000 formulários preenchidos. Cada linha contém todas as informações fornecidas por um destinatário, de todas as páginas do seu formulário.

Como exportar dados para um arquivo CSV

Você só pode baixar dados de formulários enviados e preenchidos.

Para exportar dados do Dropbox Forms para um arquivo CSV:
  1. Entre no Dropbox Forms. 
  2. Clique em Enviados na barra de menu à esquerda. 
  3. Clique em Baixar CSV.
  4. Selecione um intervalo de datas para preencher os formulários enviados. 
  5. Marque a caixa ao lado dos formulários que deseja baixar. Cada formulário selecionado será baixado separadamente. 
  6. Clique em Continuar.

Seus dados são salvos em um arquivo ZIP como um arquivo CSV. Você pode usar o programa que preferir para visualizar essas informações.

highlighter icon

Observação: PDFs, trilhas de auditoria e quaisquer anexos enviados não aparecerão quando você baixar os dados para um arquivo CSV. Para encontrar essas informações, você precisa baixar os formulários individualmente. Para fazer isso, clique em Baixar em Ações.

Como exportar dados em massa usando a Dropbox Forms API

Você pode usar a Dropbox Forms API para exportar dados de fluxo de trabalho em massa. A Dropbox Forms API é uma API REST que permite que você trabalhe com fluxos de trabalho automatizados no Dropbox Forms. Você pode criar e gerenciar instâncias de fluxo de trabalho, verificar o status delas e receber notificações quando os fluxos de trabalho forem concluídos. 

Você pode usar application/x-www-form-urlencoded ou application/json para suas solicitações e todas as respostas da API são retornadas no formato JSON.
 

 

Como configurar a Dropbox Forms API

Para começar a exportar com a Dropbox Forms API, você precisará de uma chave de API e de um fluxo de trabalho existente.

  1. Entre no portal do Dropbox Forms.
  2. Clique em chaves de API na barra lateral esquerda.
  3. No canto superior direito, clique em Nova chave .
  4. Digite um nome exclusivo para a chave de API para que sua equipe possa identificá-la.
  5. Escolha se a chave será usada para solicitações de teste ou ao vivo.
  6. Quando a chave for criada, você receberá:
    • Um ID de chave pública
    • Um valor de chave privada
warning icon

Importante: registre o valor da chave privada imediatamente e armazene-o em um local seguro. Você não poderá recuperar o valor da chave privada mais tarde, mas poderá gerar novas chaves a qualquer momento.

A Dropbox Forms API usa sua chave de API e um JSON Web Token (JWT) para autenticação. Sua chave de API é usada para recuperar um JWT de curta duração, que pode ser usado para autenticar chamadas de API.
 

Como fazer uma exportação em massa

Depois de ter uma chave de API, você precisará: 

  1. Adicionar seu JWT ao cabeçalho em todas as chamadas subsequentes:
Authorization: Bearer <YOUR_JWT>
  • Observação: substitua <YOUR_JWT> pelo seu JWT. 

2. Obtenha uma lista dos seus fluxos de trabalho executando este comando em um terminal: 

curl -s -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflows

3. Anote cada workflow_id na saída. 

4. Execute este comando para baixar um arquivo ZIP contendo dados CSV para um intervalo de datas escolhido:

curl -L -H "Authorization: Bearer <YOUR_JWT>" \
"https://api.helloworks.com/v3/workflows/<WORKFLOW_ID>/csv?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD" \
-o workflow_<WORKFLOW_ID>.zip
highlighter icon

Observação: substitua <WORKFLOW_ID> pelo seu ID e AAAA-MM-DDT00:00:00Z na URL com suas datas de início e término, por exemplo, start_date=2020-01-01T00:00:00Z.

6. Execute este comando para extrair o CSV: 
unzip -p workflow_<WORKFLOW_ID>.zip "*.csv" > workflow_<WORKFLOW_ID>.csv
highlighter icon

Observações: 

  • Se houver vários CSVs, você precisará extrair e processar todos eles.
  • Você só pode baixar até 183 dias por vez. Se precisar de mais, você precisará fazer várias chamadas.

Como baixar documentos para cada instância 

Depois de baixar e abrir o CSV, você precisa:

  1. Procurar a coluna com IDs de instância ("workflow_instance_id" ou "instance_id").
  2. Execute este comando para baixar um arquivo ZIP que contém os documentos para cada ID de instância: 
curl -L -H "Authorization: Bearer <YOUR_JWT>" \
https://api.helloworks.com/v3/workflow_instances/<INSTANCE_ID>/documents \
3. Descompacte o arquivo ZIP para visualizar os arquivos. 
Este artigo foi útil?

Conte-nos como e por que isso não ajudou:

Obrigado por nos informar!

Agradecemos sua opinião!

Artigos relacionados

Como adicionar campos de mesclagem a um modelo no Dropbox Sign

Como adicionar uma assinatura do Dropbox Sign em smartphones

Como criar e salvar assinaturas no Dropbox Sign

Como criar um link para modelo no Dropbox Sign

Outras maneiras de obter ajuda

Ícone representando duas pessoas
Comunidade
Twitter Icon
X
Ícone representando um balão de diálogo
Entrar em contato com o atendimento