> 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/nodes/action-node.md).

# e

Use nós de Ação no IoT Logic para enviar comandos automatizados a dispositivos GPS, como alternar saídas ou enviar comandos GPRS quando acionados por fluxos de dados.

## Visão geral técnica e recursos

{% columns %}
{% column width="58.333333333333336%" %}
**Ação** os nós no IoT Logic permitem o controle automatizado de dispositivos ao executar comandos específicos quando acionados por fluxos de dados recebidos. Esses nós transformam o monitoramento passivo da frota em sistemas de automação ativos, realizando operações críticas como comutação de saídas e transmissão de comandos GPRS.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-27fd0fcd59006fe239613efa78b54104a09ef845%2Fiot-logic-action-node-tile.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Embora os nós de Ação possam receber dados de qualquer tipo de nó, eles geralmente são conectados a [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós que avaliam condições e acionam ações somente quando critérios específicos são atendidos, como limites de temperatura, movimento não autorizado ou incidentes de condução agressiva.

{% hint style="info" %}
O **Ação** os nós são configurados separadamente para cada fluxo na interface da plataforma Navixy. Cada nó pode conter várias ações que são executadas sequencialmente quando acionadas por dados recebidos.
{% endhint %}

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5d9dcc9b57c4508e018fe783c48f11bd5eaa4d65%2Fiot-logic-action-node-in-flow.png?alt=media" alt=""><figcaption></figcaption></figure>

### Como os nós de Ação funcionam

Quando os dados chegam a um **Ação** nó, o sistema identifica quais dispositivos forneceram os dados recebidos e executa as ações configuradas somente para esses dispositivos. Para detalhes completos sobre a sequência de execução e o direcionamento, consulte [Execução e direcionamento das ações](#action-execution-and-targeting) abaixo.

{% hint style="info" %}
**Requisito de conectividade do dispositivo**: As ações são enviadas somente para dispositivos confirmados on-line (aqueles que fornecem dados recentes), garantindo a entrega confiável dos comandos.
{% endhint %}

Cada **Ação** resultado de acionamento do nó aparece em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md) como um atributo nomeado de acordo com o **ID do nó** (mostrado na caixa de diálogo de configuração do nó, por exemplo `action_1a2b3c4d`). O valor é `0` quando o nó não foi acionado e `1` quando foi, permitindo confirmar a execução e diferenciar vários nós de Ação no mesmo fluxo.

### Integração da arquitetura do fluxo

**Ação** os nós funcionam como nós terminais dentro da arquitetura do fluxo, recebendo acionamentos de nós anteriores sem encaminhar dados adiante. Os recursos de automação se integram ao sistema mais amplo de gerenciamento de dispositivos da Navixy por meio de:

* **Automação condicional**: Integração com [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós permite fluxos de trabalho sofisticados de Lógica, em que as ações são executadas somente quando condições específicas são validadas
* **Controle de dispositivos em tempo real**: Os comandos são transmitidos em segundos após o recebimento dos acionamentos, garantindo resposta imediata a condições críticas
* **Coordenação em toda a frota**: Quando conectadas a múltiplas fontes de dispositivos, as ações podem coordenar respostas em grupos inteiros de veículos simultaneamente
* **Respeito às capacidades do dispositivo**: As limitações individuais de cada dispositivo são respeitadas, e os comandos não suportados são recebidos, mas não executados

## Opções de configuração

{% columns %}
{% column valign="middle" %}
Configurar um **Ação** nó determina quais comandos serão executados e, opcionalmente, quais dispositivos adicionais receberão esses mesmos comandos.

A caixa de diálogo de configuração está organizada em duas abas:

* **Padrão**: define quais comandos executar. Funciona de forma independente, sem depender da aba Avançado.
* **Avançado**: define quais dispositivos adicionais receberão os mesmos comandos quando o nó for acionado. Opcional.
  {% endcolumn %}

{% column %}

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3f77e43d4a2477ef91c54020c2a1d25dcee7371a%2Faction-node-edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Vamos ver quais elementos este nó usa e o que você pode configurar ao trabalhar com ele:

### Etapas de configuração

{% stepper %}
{% step %}

#### Especificar nome do nó

Insira um nome descritivo que identifique as ações automatizadas que este nó executará

1. Use nomes como "Resposta de emergência de refrigeração" ou "Ações de alerta de segurança" para maior clareza
2. Este nome aparece no diagrama do fluxo para fácil identificação
   {% endstep %}

{% step %}

#### ID do nó (gerado automaticamente)

Abaixo do campo Nome, a caixa de diálogo exibe um **ID do nó** (por exemplo, `action_1a2b3c4d`). Este campo é somente leitura — você não pode editar nem definir seu valor.

1. O ID é gerado automaticamente quando o nó é criado e permanece o mesmo durante toda a vida útil do nó
2. Use-o para diferenciar os resultados deste nó de outros nós de Ação em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md), onde ele aparece como um atributo mostrando `0` (não acionado) ou `1` (acionado)
   {% endstep %}

{% step %}

#### Selecionar tipo de ação

No **Padrão** aba, escolha o tipo de resposta automatizada no menu suspenso

1. **Alternar saída**: Controle as saídas do dispositivo ligando-as ou desligando-as
2. **Enviar comando GPRS**: Transmita comandos personalizados diretamente para os dispositivos
   {% endstep %}

{% step %}

#### Configurar parâmetros da ação

Configure os detalhes específicos com base no tipo de ação selecionado:

<details>

<summary>Configuração de Alternar saída</summary>

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-d9244e7ff7f15d31b6ad7f2f0c565102b4fd8856%2Faction-node-switch-output.png?alt=media" alt=""><figcaption></figcaption></figure>

Ao configurar ações de Alternar saída:

* **Número da saída**: Selecione qual saída do dispositivo controlar no menu suspenso
  * Os números de saída disponíveis dependem das capacidades específicas do seu dispositivo
  * Consulte a documentação do dispositivo para entender as funções das saídas
* **Alternância ligar/desligar**: Defina se a ação liga ou desliga a saída
  * Use o alternador para selecionar o estado desejado

</details>

<details>

<summary>Configuração de Enviar comando GPRS</summary>

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-fe1b0fa64db4572c41b21eaff3d76c7add2c5c03%2Faction-node-gprs.png?alt=media" alt=""><figcaption></figcaption></figure>

Ao configurar ações de Enviar comando GPRS:

* **String do comando**: Insira o texto exato do comando a ser enviado aos dispositivos
  * Os comandos devem corresponder à sintaxe de comando suportada pelo seu dispositivo
  * Consulte a documentação do dispositivo para verificar os comandos disponíveis e a formatação correta
  * Não há restrições de caracteres no campo de entrada

</details>
{% endstep %}

{% step %}

#### Adicionar ações adicionais (opcional)

Clique em **Adicionar ação** para criar várias ações no mesmo nó.

{% hint style="info" %}

* Os comandos da ação são enviados ao receber um pacote de dados do dispositivo, de acordo com a configuração do fluxo
* Os comandos são executados sequencialmente na ordem em que aparecem na configuração
* Cada ação pode ser de um tipo diferente (Alternar saída ou Enviar comando GPRS)
* Use o ícone da lixeira para remover ações desnecessárias
  {% endhint %}
  {% endstep %}

{% step %}

#### Configurar mapeamentos de destinatários (opcional)

Abra o **Avançado** aba para definir quais dispositivos adicionais receberão os mesmos comandos quando o nó for acionado.

<figure><img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e918338f9aa10b70216ab071e7b77e77ae6202c8%2Faction-node-advanced-tab.png?alt=media" alt=""><figcaption></figcaption></figure>

1. Use o **Dispositivo de origem** menu suspenso para selecionar o dispositivo cujos dados recebidos acionam o nó. Esse deve ser um dispositivo presente no **nó Fonte de Dados**.
2. Use o **Dispositivos de destino** menu suspenso para selecionar um ou mais dispositivos que receberão os mesmos comandos.
3. Clique em **+ Mapeamento personalizado** para adicionar pares adicionais de origem para destino se diferentes dispositivos de origem precisarem propagar comandos para conjuntos diferentes de dispositivos de destino.

{% hint style="info" %}
A aba Avançado é opcional. Sem ela, o nó se comporta exatamente como antes — os comandos são executados somente para o dispositivo que acionou.
{% endhint %}
{% endstep %}

{% step %}

#### Salvar configuração

Clique em **Aplicar alterações** para salvar a configuração do seu nó
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Observação sobre compatibilidade do dispositivo:** A execução da ação depende das capacidades individuais do dispositivo. Certifique-se de que seus dispositivos suportem as saídas ou os comandos específicos que você está configurando. Procure os comandos suportados em recursos do fabricante, como a documentação do dispositivo. A lista de dispositivos compatíveis está disponível em [Dispositivos integrados do Navixy](https://www.navixy.com/devices/).
{% endhint %}

## Execução e direcionamento das ações

O **Ação** o nó fornece controle preciso sobre quando e onde os comandos são executados, garantindo respostas de automação eficientes e direcionadas.

### Sequência de execução

Quando acionado, o **Ação** nó segue este padrão de execução:

1. **Direcionamento do dispositivo**: As ações são enviadas somente para os dispositivos que forneceram dados no evento de acionamento atual
   1. Isso garante que os comandos cheguem apenas aos dispositivos específicos envolvidos na condição
   2. Evita comandos desnecessários para dispositivos da frota que não foram afetados
2. **Processamento sequencial**: Várias ações dentro de um nó são executadas na ordem configurada, de cima para baixo
   1. Cada ação conclui a transmissão antes que a próxima ação comece
   2. O tempo total de execução geralmente fica em segundos após o recebimento do acionamento
3. **Validação do dispositivo**: Os dispositivos individuais processam os comandos recebidos de acordo com suas capacidades
   1. Os comandos suportados são executados imediatamente após o recebimento
   2. Os comandos não suportados são recebidos, mas ignorados pelo dispositivo
   3. Mecanismos de segurança do dispositivo podem impedir comandos inadequados (por exemplo, desligamento do motor enquanto o veículo estiver em movimento)

### Comportamento da conexão

**Integração do nó de Lógica**: Quando conectado a [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós, as ações são executadas somente para os dispositivos para os quais a condição lógica foi avaliada como `true`. Isso fornece automação condicional precisa.

**Conexões diretas**: Quando conectado diretamente a outros tipos de nó (Fonte de Dados, Iniciar Atributo), as ações são executadas para todos os dispositivos no fluxo de dados sempre que dados são recebidos.

## Perguntas frequentes

#### Como sei se minhas ações foram executadas com sucesso?

Verifique [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md): selecione o dispositivo acionador e procure o atributo correspondente ao ID deste nó. Veja [Como os nós de Ação funcionam](#how-device-action-nodes-work) para mais detalhes.

Os comandos são enviados para dispositivos confirmados on-line (aqueles que fornecem dados recentes), sem intervalo de tempo entre o acionamento e a entrega. Isso elimina a possibilidade de o dispositivo ficar off-line entre o acionamento e a execução.

#### Posso conectar vários nós ao mesmo nó de ação?

Sim. Os nós de Ação podem receber acionamentos de vários nós anteriores, mas tenha em mente que as ações serão executadas para qualquer dispositivo que acione qualquer nó conectado. Ao projetar fluxos complexos, considere o efeito cumulativo de várias fontes de acionamento para garantir que as ações sejam executadas apenas nos cenários pretendidos. Para confirmar que o nó é acionado apenas nos cenários desejados, acompanhe seu atributo ID do nó em [Analisador de dados](/docs/user/pt-br/guide/account/iot-logic/data-stream-analyzer.md): ele mostra `1` em cada acionamento e `0` caso contrário.

#### O que acontece se eu conectar um nó de ação diretamente a uma Fonte de Dados?

O nó de ação executará suas ações configuradas toda vez que qualquer dispositivo na Fonte de Dados enviar dados. Isso cria uma execução contínua de ações, em vez de respostas condicionais. Para a maioria dos casos de uso, conectar nós de ação a nós de Lógica oferece melhor controle sobre quando as ações devem ser executadas. [Lógica](/docs/user/pt-br/guide/account/iot-logic/nodes/logic-node.md) nós de Lógica fornece melhor controle sobre quando as ações devem ser executadas.


---

# 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/nodes/action-node.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.
