> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/servidor-ftp-sftp.md).

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

**📷 Inserir print:** visão geral do módulo Servidor FTP/SFTP na área de trabalho do fluxo

***

### 🧭 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.

**📷 Inserir print:** painel de módulos com a categoria Integração expandida e o módulo Servidor FTP/SFTP visível

{% hint style="warning" %}
**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.
{% endhint %}

***

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

**📷 Inserir print:** painel de configuração do módulo Servidor FTP/SFTP aberto

***

#### 📋 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: **Ler** (obter um arquivo existente) ou **Escrever** (enviar um arquivo) |
| **Arquivo**            | Conteúdo do arquivo a enviar — visível apenas quando o Tipo é **Escrever**                   |
| **Caminho do arquivo** | Caminho completo do arquivo no servidor (ex.: `pasta/arquivo.txt`)                           |

{% hint style="info" %}
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.
{% endhint %}

{% hint style="danger" %}
**Atenção com a segurança da conexão:** ao usar o protocolo **SFTP**, o Hyperflow não confirma automaticamente se o servidor de destino é realmente o servidor esperado — por isso, cadastre apenas servidores de confiança. Ao usar o protocolo **FTP**, a conexão acontece sem nenhuma criptografia, ou seja, os dados trafegam expostos pela rede. Sempre que possível, prefira **SFTP** e evite usar este módulo para trafegar informações sensíveis (como senhas ou dados de clientes) por FTP comum.
{% endhint %}

**📷 Inserir print:** campos preenchidos com Tipo, Arquivo e Caminho do arquivo

***

#### 🔀 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).

**📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

***

### 💡 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 **Ler**.
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 (**Ler** ou **Escrever**) 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**.