For the complete documentation index, see llms.txt. This page is also available as Markdown.

Servidor FTP/SFTP

O módulo Servidor FTP/SFTP permite ler ou enviar arquivos em um servidor FTP ou SFTP, diretamente do fluxo. É útil para integrar com sistemas que trocam arquivos por esse método, como sistemas legados de fornecedores e parceiros.

🧭 Como acessar

  1. No menu lateral, clique em Gerenciamento de aplicativos.

  2. Em seguida, clique em Fluxos.

  3. Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

  4. No painel de módulos, localize a categoria Integração (identificada pela cor azul).

  5. Arraste o módulo Servidor FTP/SFTP para a área de trabalho do fluxo.

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

📋 Campos de configuração

Campo
O que preencher

Nome da integração

Selecione a integração FTP/SFTP já cadastrada

Tipo

Escolha a operação: Read (ler um arquivo existente) ou Write (enviar um arquivo)

Arquivo

Conteúdo do arquivo a enviar — visível apenas quando o Tipo é Write

Caminho do arquivo

Caminho completo do arquivo no servidor (ex.: pasta/arquivo.txt)

O protocolo usado (FTP ou SFTP) é definido no cadastro da integração, não neste módulo. O campo Tipo aqui se refere à operação (ler ou enviar), não ao protocolo de conexão.

🔀 Saídas do módulo

O módulo tem duas saídas:

  • Sucesso — a operação foi concluída, com o conteúdo do arquivo (na leitura) disponível para os próximos módulos do fluxo.

  • Erro — não foi possível concluir a operação (por exemplo, arquivo não encontrado, falha de conexão ou permissão negada).

💡 Caso de uso

Cenário: uma empresa precisa ler um arquivo de status atualizado diariamente por um parceiro em um servidor SFTP.

Configuração:

  1. Adicione o módulo Servidor FTP/SFTP ao fluxo.

  2. Selecione a integração já cadastrada com os dados do servidor.

  3. No campo Tipo, selecione Read.

  4. No campo Caminho do arquivo, informe o caminho do arquivo a ser lido.

  5. Conecte a saída Sucesso a um módulo que use o conteúdo do arquivo na conversa.

Resultado: o fluxo lê automaticamente o conteúdo do arquivo do servidor sempre que necessário.

📌 Dicas úteis

  • Confirme o caminho exato do arquivo no servidor antes de configurar o módulo — caminhos incorretos resultam em erro.

  • Sempre conecte a saída Erro a algum tratamento, já que conexões com servidores externos podem falhar por diversos motivos.

  • O conteúdo do arquivo lido é entregue como texto bruto — cuidado ao manipular esse valor em módulos seguintes caso o arquivo contenha caracteres especiais ou dados binários.

📝 Resumo

  • O módulo Servidor FTP/SFTP lê ou envia arquivos em um servidor FTP ou SFTP.

  • O protocolo é definido na integração cadastrada; o módulo define a operação (Read ou Write) e o caminho do arquivo.

  • O módulo tem uma saída de Sucesso, com o conteúdo disponível na leitura, e uma saída de Erro.