> 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/quick-start-guide.md).
# Guia de início rápido
Este guia ajudará você a configurar rapidamente seu primeiro fluxo de dados no IoT Logic e começar a processar seus dados de telemetria.
## Pré-requisitos
Antes de prosseguir com a criação do seu primeiro fluxo, certifique-se de ter:
* Uma **Proprietário** função em sua conta Navixy
* Dispositivos ativados em sua conta
* Compreensão de quais fontes de dados você deseja processar
{% hint style="info" %}
O espaço de trabalho do IoT Logic está disponível apenas para a conta **Proprietários** e não é exibido para usuários comuns **Usuários**. Para detalhes sobre as funções de usuário, consulte [Usuários e Papéis](/docs/user/pt-br/guide/account/users-and-roles.md).
{% endhint %}
## Começando a partir de um modelo
Os modelos são uma alternativa à criação manual de um fluxo do zero. Cada modelo é uma estrutura de fluxo pré-configurada para um cenário comum de processamento de dados que você pode selecionar na página inicial do IoT Logic e adaptar às suas necessidades. Para detalhes sobre os modelos disponíveis e como usá-los, consulte [Modelos](/docs/user/pt-br/guide/account/iot-logic/quick-start-guide/templates.md).
## Configuração do fluxo
Agora, vamos detalhar o processo básico de configuração do fluxo passo a passo.
{% stepper %}
{% step %}
#### Abrir o IoT Logic
No menu principal, navegue até **IoT Logic**. A página inicial é aberta com duas seções: **Modelos de fluxo**, uma galeria de estruturas de fluxo pré-configuradas, e **Fluxos criados**, uma tabela que lista todos os fluxos existentes em sua conta.
{% endstep %}
{% step %}
#### Criar um novo fluxo
1. Clique em **Criar fluxo**. Na caixa de diálogo que se abre, digite um nome e uma descrição para o seu fluxo e defina seu estado ativado.
2. Clique em **Confirmar** para abrir a tela e começar a montar o fluxo.
{% hint style="info" %}
Se preferir começar a partir de uma estrutura pré-configurada, você pode usar um modelo em vez de criar um fluxo do zero. Os modelos são fluxos pré-configurados para cenários comuns de processamento de dados. Veja [Modelos](/docs/user/pt-br/guide/account/iot-logic/quick-start-guide/templates.md) para a lista completa e as instruções de configuração.
{% endhint %}
{% endstep %}
{% step %}
#### **Configurar um nó de Fonte de dados**
Esta etapa define quais dispositivos enviarão suas leituras para este fluxo. É essencial fornecer ao pipeline dados reais.
1. Do **Nós** painel, arraste um **Fonte de dados** nó para a tela
2. Clique no nó para exibir ações rápidas ou dê um duplo clique para abrir imediatamente o painel de configuração
3. Configure as seguintes definições:
1. **Nome do nó** - Insira um nome descritivo, especificando a origem dos dados enviados (por exemplo, *Veículos da equipe*)
2. **Fontes** - Selecione os dispositivos cujas leituras você deseja enviar para este fluxo.
4. Clique em **Aplicar alterações** para aplicar a configuração
{% hint style="info" %}
Para detalhes sobre a configuração do nó, consulte [nó Fonte de dados](/docs/user/pt-br/guide/account/iot-logic/nodes/data-source-node.md).
{% endhint %}
{% endstep %}
{% step %}
#### **Adicionar enriquecimento de dados**
Nesta etapa, configuramos os cálculos para enriquecer os dados brutos ou até criar matematicamente atributos de dados completamente novos.
1. Arraste um **Initiate Attribute** nó para a tela
2. Clique no nó para exibir ações rápidas ou dê um duplo clique no nó para abrir seu painel de configuração
3. Adicione um descritivo **Nome do nó** para especificar sua finalidade e os cálculos que ele realiza (por exemplo, *Temperatura °F para °C*)
4. Defina seu atributo:
1. **Nome do atributo** - Um nome claro e descritivo (por exemplo, "speed\_mph")
2. **campo Fórmula** - A expressão de cálculo (por exemplo, `speed/1.609` para converter km/h em mph)\
:bulb:**Observação**: A sintaxe curta é a opção principal. Use a sintaxe completa quando precisar de valores históricos/indexados ou verificações explícitas de validade (por exemplo, `value('speed', 1, 'valid')`).\
Os nomes dos atributos [podem ser preenchidos automaticamente](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) para evitar erros de digitação.
5. Adicione atributos adicionais, se necessário, clicando em **Adicionar atributo**. Para remover um atributo, clique no ícone de exclusão ao lado dele.
6. Clique em **Aplicar alterações** para aplicar a configuração
7. Crie uma conexão:
1. Clique no conector de saída do **Fonte de dados** nó
2. Arraste a transição para o conector de entrada do **Initiate Attribute** nó
{% hint style="info" %}
Para detalhes sobre a configuração do nó, consulte [Nó Iniciar atributo](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md).
Para detalhes sobre ações com atributos, consulte [Gerenciamento de atributos](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md).
Para fórmulas de cálculo de exemplo, consulte [Exemplos de cálculo](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).
{% endhint %}
{% endstep %}
{% step %}
#### **Configurar saída de dados**
Esta etapa define para onde os dados serão enviados a partir deste fluxo. Você pode direcioná-los para a Navixy ou para um sistema de terceiros por meio de MQTT.
1. Arraste um **Endpoint de saída** nó para a tela
2. Passe o mouse sobre o nó para exibir ações rápidas ou dê um duplo clique no nó para abrir seu painel de configuração
3. Selecionar endpoint **Modo**:
* **Endpoint padrão** - uma saída padrão para enviar dados do fluxo para a plataforma Navixy. Ela vem pré-configurada e não pode ser editada.
* **Endpoint MQTT** - uma saída personalizada para enviar dados do fluxo para destinos de terceiros via MQTT.
4. Configure as configurações específicas da predefinição. A saída padrão vem pré-configurada; para instruções sobre outras configurações e parâmetros da predefinição, consulte [Configurações específicas do modo](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md#mode-specific-configurations).
5. Clique em **Aplicar alterações** para aplicar a configuração
6. Conecte seus outros nós a este na ordem necessária para finalizar a estrutura do fluxo
{% hint style="info" %}
Cada fluxo deve incluir um **Endpoint padrão** nó para garantir que os dados sejam enviados à plataforma. Sem essa conexão, os dados do dispositivo não ficarão visíveis na interface da Navixy.
Para detalhes sobre a configuração do nó, consulte [nó de Output Endpoint](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md).
{% endhint %}
{% endstep %}
{% step %}
#### **Salve e ative seu fluxo**
1. Verifique se todos os nós estão conectados corretamente em seu fluxo
2. Clique no **Salvar fluxo** botão na **Nós** painel
{% hint style="success" %}
Seu fluxo agora está ativo e processando dados em tempo real!
{% endhint %}
{% endstep %}
{% endstepper %}
## Validação do fluxo
A estrutura e as fórmulas do fluxo são validadas automaticamente pelo IoT Logic, exibindo avisos e mensagens de erro se a configuração estiver incompleta ou com falhas.
Para confirmar que os dados estão sendo processados corretamente, use a **Analisador de fluxo de dados** ferramenta:
1. Clique no **Analisador de Dados** aba na parte superior da tela
2. Selecione os dispositivos que você deseja monitorar na lista suspensa
3. Observe os atributos dos dados recebidos e seus valores
4. Use as opções de filtro para focar em parâmetros específicos
5. Verifique se quaisquer atributos calculados exibem os valores corretos
Para detalhes sobre o uso da ferramenta, consulte [Analisador de fluxo de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md).
{% hint style="success" %}
Parabéns! Seu primeiro fluxo de dados do IoT Logic está em funcionamento.
{% endhint %}
## Próximas etapas
Agora que você criou seu primeiro fluxo do IoT Logic, você pode:
* Adaptar este exemplo de início rápido às necessidades do seu negócio
* Criar transformações de dados mais complexas com múltiplos [nós Initiate Attribute](/docs/user/pt-br/guide/account/iot-logic/nodes/initiate-attribute-node.md)
* Configurar adicionais [destinos de saída](/docs/user/pt-br/guide/account/iot-logic/nodes/output-endpoint-node.md) para seus dados, que podem se tornar perfis reutilizáveis para configurações consistentes
* [Gerenciar fluxos já criados](/docs/user/pt-br/guide/account/iot-logic/flow-management.md) para ajustar o processamento de dados a quaisquer mudanças que você enfrente
* [Projetar fluxos avançados](/docs/user/pt-br/guide/account/iot-logic/flow-management/flow-configuration-example.md) para cenários de negócios específicos usando diferentes combinações e configurações de nós
## Perguntas frequentes
#### O que acontece com os dispositivos não atribuídos a um fluxo personalizado?
A Navixy garante automaticamente que os dados deles cheguem à plataforma no nível do sistema. Não é necessário nenhum fluxo personalizado ou configuração adicional para a transmissão básica de dados. Os fluxos personalizados servem para ir além dessa base — enriquecendo dados, aplicando lógica condicional ou roteando para sistemas externos.
#### Posso usar o mesmo dispositivo em vários fluxos?
Sim. Um dispositivo pode pertencer a vários fluxos ao mesmo tempo. Todos os fluxos que incluem o dispositivo processam seus dados simultaneamente, e os resultados são mesclados para evitar perda de dados. Não há restrições quanto ao número de fluxos aos quais um dispositivo pode pertencer.
#### Meu fluxo continuará funcionando se eu sair?
Sim. Depois de ativados, os fluxos operam independentemente da sua sessão de usuário. Enquanto o fluxo estiver habilitado, ele processará dados mesmo quando você não estiver conectado.
#### Como sei se meu fluxo está funcionando corretamente?
Use o Analisador de Fluxo de Dados para monitorar a transmissão de dados em tempo real. Esta ferramenta mostra tanto os dados brutos do dispositivo quanto os atributos calculados, permitindo que você verifique se suas transformações estão funcionando como esperado.
#### O que acontece se eu desativar um fluxo?
Quando você desativa um fluxo, toda a transmissão de dados dos dispositivos atribuídos a ele é interrompida — inclusive a entrega para a plataforma Navixy. Os dispositivos não ficarão mais visíveis nem serão atualizados na interface até que o fluxo seja reativado. Desative um fluxo apenas quando você quiser deliberadamente interromper completamente a transmissão de dados dos dispositivos afetados.
---
# 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/quick-start-guide.md?ask=&goal=
```
`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.