> 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 fornece um ambiente de canvas flexível em que você pode criar fluxos de dados personalizados para processar, transformar e encaminhar a telemetria dos dispositivos. Cada fluxo é composto por nós interconectados que executam funções específicas em seu pipeline de processamento de dados, desde o recebimento de dados brutos do dispositivo até o encaminhamento de informações enriquecidas para sistemas externos.

## Criar 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 abre com a **Fluxos criados** tabela.
2. Clique em **Criar fluxo**.
3. Insira um nome e uma descrição para o fluxo e defina seu estado inicial de ativação.
4. Clique em **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 desativados não enviam nenhum dado! As leituras dos dispositivos envolvidos em um fluxo desativado não chegam a nenhum destino, incluindo a plataforma Navixy. Isso significa que desativar um fluxo pode interromper seus recursos de monitoramento e a coleta de dados dos dispositivos afetados. Desative fluxos apenas quando você quiser deliberadamente interromper totalmente a transmissão de dados.
{% endhint %}

## Configurar 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 de automação e integração.

Essa arquitetura modular oferece suporte tanto ao encaminhamento de dados simples 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ócio específicos.

Para a referência completa de 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 no modo **Ponto de extremidade padrão** modo para enviar dados à 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 %}

## Montar seu fluxo

O **Nós** o painel à esquerda agrupa os tipos de nós disponíveis em quatro seções identificadas: **Iniciar com** e **Encerrar com** (ambos obrigatórios), e **Processamento** e **Ação** (ambos opcionais). Para a lista completa de 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 em paralelo
* Múltiplos **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

## Editar fluxos existentes

Depois de criar um fluxo, você pode modificar sua configuração à medida que seus requisitos evoluem.

### Modificar detalhes do fluxo

Você pode editar o nome, a descrição e o estado de ativação 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 de ativação na caixa de diálogo.
4. Clique em **Salvar** para confirmar as alterações.

### Remover elementos

{% columns %}
{% column %}
Quando precisar reestruturar seu fluxo, você 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 em **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ê excluir 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 em **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 %}

### Gerenciar 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, o número de dispositivos conectados e o status atual.

Cada linha oferece um botão de alternância de status para ativar ou desativar 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 no nome dele na tabela ou selecione **Editar** no **...** 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:

* **Etiqueta do Objeto**: o nome do dispositivo
* **Modelo**: o modelo do dispositivo
* **ID do dispositivo**: o identificador único 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 %}

## Importar e exportar fluxos

O IoT Logic permite exportar 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 novos fluxos rapidamente.

Aqui está um exemplo de arquivo JSON de fluxo exportado/pronto para importar:

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

### Exportar 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 fazer isso, abra o "**..."** menu próximo ao nome do fluxo e selecione **Download**.
{% endhint %}

#### O que é exportado

A tabela a seguir mostra o que está incluído e excluído nas exportações de fluxo:

<table data-search="false"><thead><tr><th>Componente</th><th align="center">Exportado</th></tr></thead><tbody><tr><td>Estrutura dos nós e conexões</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 dispositivos (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 de 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 dispositivos, 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 dispositivos 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 dispositivos do nó, portanto também são excluídos junto com elas. Os dados de autenticação são excluídos para proteger informações confidenciais.

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

### Importar um fluxo

Para importar uma configuração de fluxo:

1. Na página inicial do IoT Logic, clique em **Carregar fluxo**
2. Selecione o arquivo JSON que contém a configuração do fluxo exportado
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 utilizavam, pois ele depende de seleções de dispositivos que não são exportadas
   * Adicione cabeçalhos de autenticação aos nós de 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.

## Salvar e ativar fluxos

Depois de configurar seu fluxo:

1. Clique no **Salvar fluxo** botão para armazenar a configuração do seu fluxo
2. Certifique-se de que o fluxo esteja ativado para começar a processar dados

Depois de ativado, seu fluxo:

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

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

## Exemplos de configuração

Você pode encontrar descrições detalhadas, passo a passo, da criação de um fluxo de exemplo 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.