> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management.md).

# Gerenciamento de fluxo

O IoT Logic oferece um ambiente flexível de canvas, no qual você pode criar fluxos de dados personalizados para processar, transformar e rotear a telemetria dos dispositivos. Cada fluxo consiste em nós interconectados que executam funções específicas dentro do seu pipeline de processamento de dados, desde o recebimento de dados brutos dos dispositivos até o encaminhamento de informações enriquecidas para sistemas externos.

## Criando um novo fluxo

Você cria fluxos na página inicial do IoT Logic usando o **Criar fluxo** botão.

1. Abra o IoT Logic. A página inicial é exibida com a **fluxos criados** tabela.
2. Clique **Criar fluxo**.
3. Insira um nome e uma descrição para o fluxo e defina seu estado inicial como habilitado.
4. Clique **Confirmar**. O canvas é aberto e o novo fluxo fica pronto para edição.

<figure><img src="/files/8dcf63bd73e065c9ab07ceb95dde6ff614ededf5" alt="Create Flow dialog with name, description, and enabled state fields"><figcaption></figcaption></figure>

{% hint style="danger" %}
Fluxos desabilitados não enviam nenhum dado! As leituras dos dispositivos envolvidos em um fluxo desabilitado não chegam a nenhum destino, incluindo a plataforma Navixy. Isso significa que desabilitar um fluxo pode interromper suas capacidades de monitoramento e a coleta de dados dos dispositivos afetados. Desabilite fluxos apenas quando você quiser deliberadamente interromper a transmissão de dados completamente.
{% endhint %}

## Configurando os componentes do fluxo

Os fluxos do IoT Logic são construídos a partir de nós interconectados que definem como os dados se movem pelo seu sistema. Os dados entram por **Fonte de Dados** nós, podem ser transformados por nós de processamento como **Iniciar Atributo**, e saem por **Ponto de Extremidade de Saída** nós. Nós especializados adicionais, como **Ação** e **Webhook** fornecem funções específicas para automação e integração.

Essa arquitetura modular oferece suporte tanto ao simples encaminhamento de dados quanto a transformações complexas em várias etapas. Todo fluxo funcional requer pelo menos um nó de entrada e um nó de saída, com nós de processamento opcionais entre eles para enriquecer seus dados de acordo com requisitos de negócios específicos.

Para a referência completa dos nós e as instruções de configuração, consulte [Nós](/docs/user/pt-br/guide/account/iot-logic/nodes.md).

{% hint style="info" %}
Seu fluxo deve incluir um **Ponto de Extremidade de Saída** nó configurado para **Ponto de extremidade padrão** modo para enviar dados para a plataforma. Manter essa conexão garante que os dados do seu dispositivo permaneçam disponíveis para visualização e gerenciamento na interface da Navixy.
{% endhint %}

## Construindo seu fluxo

O **Nós** painel à esquerda agrupa os tipos de nós disponíveis em quatro seções rotuladas: **Comece com** e **Termine com** (ambos obrigatórios) e **Processamento** e **Ação** (ambos opcionais). Para a lista completa dos nós em cada grupo, consulte [Nós](/docs/user/pt-br/guide/account/iot-logic/nodes.md).

Para montar sua sequência de processamento de dados:

1. Arraste nós do menu à esquerda e solte-os na área de trabalho.
2. Clique em cada nó para abrir seu painel de configuração e definir os parâmetros necessários.
3. Conecte os nós clicando no conector de saída de um nó e arrastando-o até o conector de entrada do nó de destino.

<figure><img src="/files/02dbf8fed6f2fc46e4d3aaee05fddd8ce8139f63" alt="Flow workspace showing connected nodes with visible connectors between them"><figcaption></figcaption></figure>

Seu fluxo deve começar com pelo menos um **Fonte de Dados** nó e terminar com um ou mais **Ponto de Extremidade de Saída** nós. Entre eles, você pode adicionar nós de transformação para manipular os dados de acordo com seus requisitos.

Os nós podem ser conectados em várias configurações:

* Um único **Nó de Fonte de Dados** pode alimentar vários nós para processamento paralelo
* Vários **nós de Fonte de Dados** podem se conectar a um único **nó de Ponto de Extremidade de Saída** para consolidar fluxos de dados
* **Nós de Iniciar Atributo** podem ser encadeados sequencialmente para cálculos em várias etapas

## Editando fluxos existentes

Após criar um fluxo, você pode modificar sua configuração conforme seus requisitos evoluem.

### Modificando os detalhes do fluxo

Você pode editar o nome, a descrição e o estado habilitado de um fluxo na página inicial do IoT Logic.

1. Abra o IoT Logic. Localize o fluxo no **fluxos criados** tabela.
2. Clique no **...** menu desse fluxo e selecione **Editar**.
3. Atualize o nome, a descrição ou o estado habilitado na caixa de diálogo.
4. Clique **Salvar** para confirmar as alterações.

### Removendo elementos

{% columns %}
{% column %}
Quando você precisar reestruturar seu fluxo, pode remover nós ou conexões:

**Excluindo um nó:**

1. Clique no nó que você deseja remover para exibir suas ações rápidas
2. Clique **Excluir** na barra de ações que aparece acima do nó
   {% endcolumn %}

{% column %}

<figure><img src="/files/6a93d79e01bbe86f33c33b0bbd6d32b311c6fc77" alt="Node showing Edit and Delete quick actions"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Quando você exclui um nó, todas as suas conexões também serão removidas.
{% endhint %}

{% columns %}
{% column %}
**Excluindo uma conexão:**

* Clique na linha de conexão que você deseja remover
* Clique **Desvincular** ou pressione a tecla Backspace no seu teclado
  {% endcolumn %}

{% column %}

<figure><img src="/files/ee707ad9a5d432df550a714f2672a087d45026f5" alt="Selected connection highlighted for deletion"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

### Gerenciando vários fluxos

Todos os fluxos estão listados na **fluxos criados** tabela na página inicial do IoT Logic. A tabela mostra o nome de cada fluxo, a data da última modificação, a quantidade de dispositivos conectados e o status atual.

Cada linha oferece um alternador de status para habilitar ou desabilitar o fluxo sem abri-lo, um ícone de download para exportar o fluxo como arquivo e um **...** menu com as opções **Editar**, **Download**, e **Excluir**.

Para abrir um fluxo no canvas, clique em seu nome na tabela ou selecione **Editar** em seu **...** menu.

### Tabela de mapeamento

Ao lado do título da página na página inicial do IoT Logic, o **Tabela de mapeamento** botão abre a **Mapeamento de dispositivos** caixa de diálogo, uma tabela pesquisável em toda a conta que lista todos os dispositivos e para onde seus dados vão.

<figure><img src="/files/ff1be2e1ba16664d04111843853b95d728048085" alt="Devices mapping dialog listing devices with their model, device ID, connected flows, and data source"><figcaption></figcaption></figure>

Para cada dispositivo, a caixa de diálogo mostra:

* **Rótulo do objeto**: o nome do dispositivo
* **Modelo**: o modelo do dispositivo
* **ID de dispositivo**: o identificador exclusivo do dispositivo
* **Fluxos conectados**: o(s) fluxo(s) ao(s) qual(is) o dispositivo está atribuído, como links clicáveis que abrem cada fluxo
* **Fonte de Dados**: o nó de Fonte de Dados que alimenta o dispositivo

Use o campo de pesquisa acima da tabela para filtrá-la por dispositivo.

{% hint style="info" %}
As mesmas atribuições de dispositivo para fluxo também estão disponíveis programaticamente. Consulte [Navixy User MCP](/docs/navixy-mcp/navixy-mcp-server/navixy-user-mcp.md) para a ferramenta MCP equivalente.
{% endhint %}

## Importando e exportando fluxos

O IoT Logic permite que você exporte configurações de fluxo para fins de backup ou para compartilhá-las com outras contas. Você também pode importar configurações exportadas anteriormente para configurar rapidamente novos fluxos.

Aqui está um exemplo de um arquivo JSON de fluxo exportado/pronto para importação:

{% file src="/files/b7d657308035b5e06a9375ca76f86d89957c0e0a" %}

### Exportando um fluxo

Para exportar a configuração do seu fluxo:

1. Localize o fluxo na **fluxos criados** tabela.
2. Clique no **...** menu desse fluxo e selecione **Download**.
3. A configuração do fluxo é baixada como um arquivo JSON

{% hint style="info" %}
Você também pode exportar um fluxo a partir do canvas. Para isso, abra o \\"**..."** menu perto do nome do fluxo e selecione **Download**.
{% endhint %}

#### O que é exportado

A tabela a seguir mostra o que é incluído e excluído das exportações de fluxo:

<table data-search="false"><thead><tr><th>Componente</th><th align="center">Exportado</th></tr></thead><tbody><tr><td>Estrutura e conexões dos nós</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></td></tr><tr><td>Cálculos e expressões de atributos</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></td></tr><tr><td>Nomes e descrições dos nós</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></td></tr><tr><td>Metadados do fluxo</td><td align="center"><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span></td></tr><tr><td>Seleções de dispositivo (nós de Fonte de Dados)</td><td align="center">❌</td></tr><tr><td>Configuração de envio da aba Software (nós de Fonte de Dados)</td><td align="center">❌</td></tr><tr><td>Cabeçalhos de autenticação (nós Webhook)</td><td align="center">❌</td></tr><tr><td>Credenciais MQTT (nós de Ponto de Extremidade de Saída)</td><td align="center">❌</td></tr></tbody></table>

{% hint style="info" %}
As seleções de dispositivo, a configuração de envio da aba Software e os dados de autenticação são excluídos das exportações. As seleções de dispositivo e a configuração de envio da aba Software são excluídas para evitar conflitos ao importar para outra conta. Os mapeamentos da aba Software fazem referência às seleções de dispositivo do nó, por isso são excluídos juntamente com elas. Os dados de autenticação são excluídos para proteger informações sensíveis.

Após importar um fluxo, você precisa adicionar manualmente os dados excluídos antes de poder salvar o fluxo.
{% endhint %}

### Importando um fluxo

Para importar uma configuração de fluxo:

1. Na página inicial do IoT Logic, clique em **Fazer upload do fluxo**
2. Selecione o arquivo JSON que contém a configuração exportada do fluxo
3. Revise a estrutura do fluxo importado
4. Configure os elementos excluídos:
   * Atribua dispositivos aos nós de Fonte de Dados
   * Reconfigure o enriquecimento de envio da aba Software nos nós de Fonte de Dados que o usavam, pois ele depende de seleções de dispositivo que não são exportadas
   * Adicione cabeçalhos de autenticação aos nós Webhook (se aplicável)
   * Insira credenciais MQTT para nós de Ponto de Extremidade de Saída (se aplicável)
5. Salve o fluxo

O processo de importação cria um novo fluxo com a estrutura e os cálculos da configuração exportada, permitindo que você replique rapidamente pipelines complexos de processamento de dados em diferentes ambientes.

## Salvando e ativando fluxos

Depois de configurar seu fluxo:

1. Clique no **Salvar fluxo** para armazenar a configuração do seu fluxo
2. Verifique se o fluxo está habilitado para começar a processar dados

Uma vez ativado, seu fluxo:

* Recebe dados em tempo real dos dispositivos configurados
* Aplica quaisquer transformações definidas por meio dos nós Iniciar Atributo
* Encaminha os dados processados para os endpoints especificados no [Navixy Generic Protocol](/docs/iot-logic-api/technologies/navixy-generic-protocol.md) formato

Se você precisar desabilitar temporariamente o processamento de dados, poderá alternar o estado habilitado do fluxo sem perder sua configuração.

## Exemplos de configuração

Você pode encontrar descrições detalhadas passo a passo de um exemplo de criação de fluxo em [Exemplo de configuração de fluxo](/docs/user/pt-br/guide/account/iot-logic/flow-management/flow-configuration-example.md). O exemplo também contém explicações sobre algumas opções comuns de enriquecimento de dados. Sinta-se à vontade para usar este exemplo como modelo para seus fluxos personalizados.

{% hint style="info" %}
Para documentação de referência sobre tipos individuais de nós, incluindo recursos e opções de configuração, consulte a [Nós](/docs/user/pt-br/guide/account/iot-logic/nodes.md) página de referência.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/pt-br/guide/account/iot-logic/flow-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.