Como Fazer Upload de um Arquivo Excel no FlowHunt Sem Integração com Excel: Importação CSV Passo a Passo e Solução de Problemas

O que é o Recurso de Upload de CSV do FlowHunt e Quando Utilizá-lo?

O FlowHunt oferece várias formas de trazer seus dados para a plataforma, incluindo integrações diretas (como Excel, Google Sheets) e uploads manuais de arquivos. Se você deseja fazer upload de um único documento do Excel ou de poucos arquivos—sem configurar a integração completa com o Excel—o upload manual via CSV é uma solução simplificada. Essa abordagem é especialmente útil para importações de dados pontuais, para testar rapidamente um novo fluxo de trabalho ou para evitar conectar sua conta Microsoft.

O recurso de upload de CSV permite que você converta sua planilha Excel (.xlsx ou .xls) em um arquivo CSV (Comma-Separated Values) universalmente aceito, que pode ser enviado pelo painel do FlowHunt. No entanto, lembre-se de que esse método não permite sincronização em tempo real; qualquer alteração no documento original do Excel deve ser exportada e enviada novamente manualmente.

Como Exportar Meu Arquivo Excel para o Formato CSV para o FlowHunt?

Exportar seus dados do Excel para CSV garante compatibilidade com os requisitos de upload do FlowHunt. Veja um passo a passo para usuários de Windows e Mac:

1. Abra seu arquivo Excel no Microsoft Excel ou em um editor de planilhas compatível (Google Sheets, LibreOffice Calc).
2. Limpe seus dados:
   • Remova qualquer formatação extra, células mescladas, fórmulas ou caracteres especiais que possam não ser bem convertidos para CSV.
   • Garanta que todas as colunas tenham cabeçalhos claros e consistentes.
   • Inclua apenas os dados que você deseja enviar.
3. Exporte como CSV:
   • No Excel: Vá em Arquivo > Salvar como.
   • Escolha a pasta de destino.
   • No menu suspenso ‘Salvar como tipo’, selecione CSV (delimitado por vírgulas) (*.csv).
   • Dê um nome ao arquivo e clique em Salvar.
   • Se solicitado, escolha manter apenas a planilha atual (cada planilha deve ser salva como um CSV separado se houver mais de uma).
   • Se estiver usando o Google Sheets: Vá em Arquivo > Fazer download > Valores separados por vírgula (.csv, planilha atual).
4. Verifique seu arquivo CSV:
   • Abra o CSV em um editor de texto (como Bloco de Notas ou VS Code) para garantir que não existam caracteres estranhos, vírgulas extras ou problemas de codificação.
   • Certifique-se de que a primeira linha contenha os cabeçalhos das colunas e que cada linha tenha o mesmo número de colunas.
5. Utilize codificação UTF-8:
   • Alguns sistemas usam outras codificações por padrão; se seus dados tiverem caracteres não ingleses, salve seu CSV como UTF-8.

Como Fazer Upload de um Arquivo CSV no FlowHunt Sem Integração?

Com o arquivo CSV limpo, o upload para o FlowHunt é simples:

1. Faça login no painel do FlowHunt: Entrar no FlowHunt
2. Navegue até a seção de uploads de dados ou fontes de conhecimento (pode aparecer como ‘Upload CSV’, ‘Adicionar Fonte de Dados’ ou similar, dependendo da configuração do seu workspace).
3. Clique no botão ‘Upload’ ou ‘Selecionar Arquivo’.
4. Escolha seu arquivo CSV no computador e confirme o upload.
5. Aguarde a conclusão do upload e processamento. Arquivos grandes podem demorar mais e exibir uma barra de progresso ou mensagem de confirmação.
6. Revise os dados importados no FlowHunt para garantir que estejam como esperado.

Consulte a documentação oficial para um tutorial visual:

• Documentação de Output CSV do FlowHunt
• Componente de Pesquisa em Documentos CSV

Alterações no Meu Documento Excel Serão Atualizadas Automaticamente no FlowHunt?

Ao usar o método manual de upload CSV, o FlowHunt trata cada upload como um instantâneo estático. Isso significa:

• Sem sincronização automática: Editar seu arquivo Excel original (ou o CSV baixado) NÃO atualizará os dados no FlowHunt.
• É preciso reenviar manualmente: Toda vez que você fizer alterações no documento Excel, repita os passos de exportação e upload para atualizar os dados no FlowHunt.
• Considere integração para atualizações frequentes: Se precisar de sincronização automática, avalie configurar a integração completa com o Excel no FlowHunt.

O Que Fazer Se Eu Receber um Erro ‘API Failed’ ao Fazer Upload do Meu Arquivo CSV?

Se o upload do seu CSV falhar com erro ‘API failed’, o problema provavelmente está relacionado à formatação do arquivo, codificação ou tamanho. Veja como solucionar:

Causas Comuns e Soluções

• Problemas de Formatação do Arquivo:

  • Certifique-se de que não existam células mescladas, colunas ocultas ou formatação especial no arquivo Excel original.
  • Todas as linhas devem ter o mesmo número de colunas dos cabeçalhos.
  • O arquivo não deve conter fórmulas nem caracteres não suportados.

• Problemas de Codificação do CSV:

  • O FlowHunt exige codificação UTF-8 para arquivos CSV. Regrave seu arquivo usando UTF-8 caso haja caracteres especiais (especialmente em idiomas que não o inglês).
  • Abra seu CSV em um editor de texto, selecione ‘Salvar como’ e escolha codificação UTF-8.

• Limites de Tamanho:

  • Verifique na documentação do FlowHunt ou no seu plano os limites máximos de tamanho do arquivo e número de linhas.
  • Tente fazer upload de um arquivo menor como teste.

• Delimitador e Quebra de Linha:

  • Certifique-se de que seu CSV use vírgulas como delimitador (não ponto e vírgula ou tabulação).
  • Garanta que as quebras de linha sejam consistentes (LF ou CRLF).

• Arquivo Corrompido ou Problemas de Upload:

  • Baixe novamente seu CSV do Excel ou Google Sheets.
  • Renomeie o arquivo e tente fazer upload novamente.

Checklist Passo a Passo para Solução de Problemas

1. Abra seu CSV em um editor de texto e verifique:
   • Linhas em branco extras no final.
   • Número inconsistente de colunas.
   • Caracteres incomuns ou não impressos.
2. Valide o arquivo CSV usando uma ferramenta validadora online (opcional).
3. Divida um arquivo grande em partes menores e faça upload de uma parte para isolar o problema.
4. Limpe o cache do navegador ou utilize outro navegador caso haja problemas de sessão.
5. Revise logs ou mensagens de erro no FlowHunt (se disponíveis) para obter detalhes específicos.

Se nenhuma dessas etapas resolver seu problema, salve uma cópia do arquivo e entre em contato com o suporte do FlowHunt, fornecendo detalhes sobre o erro e as ações realizadas.

Onde Encontrar Mais Ajuda ou Documentação?

• Documentação de Output CSV do FlowHunt
• Componente de Pesquisa em Documentos CSV
• Página de Contato do Suporte FlowHunt
• Base de Conhecimento FlowHunt

Para problemas técnicos persistentes, entre em contato com o suporte do FlowHunt, anexando seu arquivo CSV e uma descrição do problema para receber assistência especializada.