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

# Gestão do fluxo

Crie fluxos personalizados do IoT Logic em uma tela visual: conecte nós para receber telemetria do dispositivo, processar e transformar dados e encaminhá-los para sistemas externos.

O IoT Logic oferece 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 consiste em nós interconectados que executam funções específicas em seu pipeline de processamento de dados, desde receber dados brutos do dispositivo até encaminhar 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 é aberta com a **Fluxos criados** tabela.
2. Salvar **Criar fluxo**.
3. Digite um nome e uma descrição para o fluxo e defina seu estado inicial como habilitado.
4. Salvar **Confirmar**. A tela de canvas é aberta e o novo fluxo fica pronto para edição.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3bb4a6bc33fd29a6ff2500ebcaa0f1ff887ef87e%2Fnew-flow.png?alt=media" alt="Create Flow dialog with name, description, and enabled state fields"><figcaption></figcaption></figure>

{% hint style="danger" %}
Os 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 seus recursos de monitoramento e a coleta de dados para os dispositivos afetados. Desabilite fluxos somente quando você quiser interromper deliberadamente a transmissão de dados por completo.
{% 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 trafegam 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** Webhook **nos nós do IoT Logic fornecem os mesmos recursos subjacentes com automação completa de fluxo e direcionamento para vários dispositivos.** fornecem funções específicas para 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 obter a referência completa dos nós e 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ó definido para **Ponto de extremidade padrão** nó 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 do Navixy.
{% endhint %}

## Construindo seu fluxo

O **Nós** painel à esquerda agrupa os tipos de nós disponíveis em quatro seções rotuladas: **Iniciar com** Webhook **Terminar com** (ambos obrigatórios) e **Processo** Webhook **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 os 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="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-de59945b3248fb0b2a497123a36e42c1904b57b4%2Fiot-logic-canvas-connected-nodes.jpg?alt=media" 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

Depois de criar um fluxo, você pode modificar sua configuração à medida que 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 na **Fluxos criados** tabela.
2. Enviar **...** menu desse fluxo e selecione **Editar**.
3. Atualize o nome, a descrição ou o estado habilitado na caixa de diálogo.
4. Salvar **para salvar o comando. Clique em** para confirmar as alterações.

### Removendo 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 as ações rápidas
2. Salvar **para removê-lo.** na barra de ações que aparece acima do nó
   {% endcolumn %}

{% column %}

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-da60b29ab606965c7feec9dd98d92e29579d3de9%2Fnode-delete.png?alt=media" alt="Node showing Edit and Delete quick actions"><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

{% hint style="info" %}
Ao 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
* Salvar **Desvincular** ou pressione a tecla Backspace no teclado
  {% endcolumn %}

{% column %}

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-6c0be372329b2bce03472bad611e738a9c1908ff%2Fnode-connection-delete.png?alt=media" 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, 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**{{longitude}} **para removê-lo.**.

Para abrir um fluxo no canvas, clique em seu nome na tabela ou selecione **Editar** de 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 caixa de diálogo **Mapeamento de dispositivos** caixa de diálogo, uma tabela pesquisável em toda a conta que lista cada dispositivo e para onde seus dados vão.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-f9ecfa88bea2d373c8092aedaffa0663381df4e0%2Fiot-logic-devices-mapping-dialog.png?alt=media" 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 do 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. Veja [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 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 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. Enviar **...** 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 é 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 dispositivos (nós de Fonte de Dados)</td><td align="center">❌</td></tr><tr><td>Configuração de push da guia 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 dispositivos, a configuração de push da guia Software e os dados de autenticação são excluídos das exportações. As seleções de dispositivos e a configuração de push da guia Software são excluídas para evitar conflitos ao importar para uma conta diferente. Os mapeamentos da guia Software fazem referência às seleções de dispositivos do nó, então eles 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 %}

### Importando um fluxo

Para importar uma configuração de fluxo:

1. Na página inicial do IoT Logic, clique em **Enviar fluxo**
2. Selecione o arquivo JSON contendo a configuração de fluxo exportada
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 por push da guia Software nos nós de Fonte de Dados que o usavam, pois ele depende de seleções de dispositivos 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. Salvar 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. Enviar **Salvar fluxo** botão para armazenar a configuração do seu fluxo
2. Garanta que o fluxo esteja habilitado 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 endpoints especificados em [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 status habilitado do fluxo sem perder sua configuração.

## Exemplos de configurações

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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.