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.

Antes de usar este módulo: é necessário ter uma integração do tipo FTP/SFTP já cadastrada, com o protocolo (FTP ou SFTP), host, porta, usuário e senha do servidor.

🔍 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.