> 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/es/guide/account/iot-logic/nodes/action-node.md).

# Acción del dispositivo

Use nodos Acción del dispositivo en IoT Logic para enviar comandos automáticos a dispositivos GPS, como activar salidas o enviar comandos GPRS cuando los activen los flujos de datos.

## Visión general técnica y capacidades

{% columns %}
{% column width="58.333333333333336%" %}
**Acción del dispositivo** Los nodos en IoT Logic permiten el control automatizado de dispositivos al ejecutar comandos específicos cuando se activan por flujos de datos entrantes. Estos nodos transforman la supervisión pasiva de la flota en sistemas de automatización activa, realizando operaciones críticas como el cambio de salidas y la transmisión de comandos GPRS.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="https://1900701122-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 %}

Aunque los nodos de acción del dispositivo pueden recibir datos de cualquier tipo de nodo, por lo general se conectan a [IF/THEN Lógica](/docs/user/es/guide/account/iot-logic/nodes/logic-node.md) nodos que evalúan condiciones y activan acciones solo cuando se cumplen criterios específicos, como umbrales de temperatura, movimiento no autorizado o incidentes de conducción peligrosa.

{% hint style="info" %}
El **Acción del dispositivo** Los nodos se configuran por separado para cada flujo en la interfaz de usuario de la plataforma Navixy. Cada nodo puede contener varias acciones que se ejecutan secuencialmente cuando las activa el flujo de datos entrante.
{% endhint %}

<figure><img src="https://1900701122-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>

### Cómo funcionan los nodos de acción del dispositivo

Cuando los datos llegan a un **Acción del dispositivo** nodo, el sistema identifica qué dispositivos proporcionaron los datos entrantes y ejecuta las acciones configuradas solo para esos dispositivos. Para obtener todos los detalles sobre la secuencia de ejecución y el direccionamiento, consulte [Ejecución de acciones y direccionamiento](#action-execution-and-targeting) a continuación.

{% hint style="info" %}
**Requisito de conectividad del dispositivo**: Las acciones se envían solo a dispositivos que están confirmados en línea (los que proporcionan datos recientes), lo que garantiza una entrega confiable de los comandos.
{% endhint %}

Cada **Acción del dispositivo** resultado de activación del nodo aparece en [Analizador de datos](/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md) como un atributo con el nombre del **ID del nodo** (que se muestra en el diálogo de configuración del nodo, por ejemplo `action_1a2b3c4d`). El valor es `0` cuando el nodo no se ha activado y `1` cuando se ha activado, lo que le permite confirmar la ejecución y distinguir varios nodos de acción del dispositivo en el mismo flujo.

### Integración con la arquitectura del flujo

**Acción del dispositivo** Los nodos funcionan como nodos terminales dentro de la arquitectura del flujo, recibiendo disparadores de nodos anteriores sin pasar datos hacia adelante. Las capacidades de automatización se integran con el sistema más amplio de gestión de dispositivos de Navixy a través de:

* **Automatización condicional**: Integración con [IF/THEN Lógica](/docs/user/es/guide/account/iot-logic/nodes/logic-node.md) nodos permite flujos de trabajo sofisticados de IF/THEN Lógica en los que las acciones se ejecutan solo cuando se validan condiciones específicas
* **Control de dispositivos en tiempo real**: Los comandos se transmiten en cuestión de segundos después de recibir los disparadores, lo que garantiza una respuesta inmediata a condiciones críticas
* **Coordinación de toda la flota**: Cuando se conecta a múltiples fuentes de dispositivos, las acciones pueden coordinar respuestas en grupos completos de vehículos simultáneamente
* **Respeto por las capacidades del dispositivo**: Se respetan las limitaciones de cada dispositivo, y los comandos no compatibles se reciben pero no se ejecutan

## Opciones de configuración

{% columns %}
{% column valign="middle" %}
Configurar un **Acción del dispositivo** nodo determina qué comandos se ejecutan y, opcionalmente, qué dispositivos adicionales reciben esos mismos comandos.

El diálogo de configuración se organiza en dos pestañas:

* **Estándar**: define qué comandos ejecutar. Funciona de forma independiente, sin depender de la pestaña Avanzado.
* **Avanzado**: define qué dispositivos adicionales reciben los mismos comandos cuando se activa el nodo. Opcional.
  {% endcolumn %}

{% column %}

<figure><img src="https://1900701122-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 %}

Veamos qué elementos utiliza este nodo y qué puede configurar al trabajar con él:

### Pasos de configuración

{% stepper %}
{% step %}

#### Especifique el nombre del nodo

Ingrese un nombre descriptivo que identifique las acciones automatizadas que realizará este nodo

1. Use nombres como "Respuesta de enfriamiento de emergencia" o "Acciones de alerta de seguridad" para mayor claridad
2. Este nombre aparece en el diagrama de flujo para facilitar su identificación
   {% endstep %}

{% step %}

#### ID del nodo (generado automáticamente)

Debajo del campo Nombre, el diálogo muestra un **ID del nodo** (por ejemplo, `action_1a2b3c4d`). Este campo es de solo lectura; no puede editarlo ni establecer su valor.

1. El ID se genera automáticamente cuando se crea el nodo y permanece igual durante toda su vida útil
2. Úselo para distinguir los resultados de este nodo de otros nodos de acción del dispositivo en [Analizador de datos](/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md), donde aparece como un atributo que muestra `0` (no activado) o `1` (activado)
   {% endstep %}

{% step %}

#### Seleccione el tipo de acción

En el **Estándar** pestaña, elija el tipo de respuesta automatizada del menú desplegable

1. **Salida conmutada**: Controle las salidas del dispositivo encendiéndolas o apagándolas
2. **Enviar comando GPRS**: Transmita comandos personalizados directamente a los dispositivos
   {% endstep %}

{% step %}

#### Configurar parámetros de la acción

Configure los detalles específicos según el tipo de acción seleccionado:

<details>

<summary>Configuración de salida conmutada</summary>

<figure><img src="https://1900701122-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>

Cuando configure acciones de salida conmutada:

* **Número de salida**: Seleccione qué salida del dispositivo controlar en el menú desplegable
  * Los números de salida disponibles dependen de las capacidades específicas de su dispositivo
  * Consulte la documentación de su dispositivo para entender las funciones de salida
* **Conmutador de encendido/apagado**: Defina si la acción enciende o apaga la salida
  * Use el conmutador para seleccionar el estado deseado

</details>

<details>

<summary>Configuración de envío de comando GPRS</summary>

<figure><img src="https://1900701122-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>

Cuando configure acciones de comando GPRS:

* **Cadena de comando**: Ingrese el texto exacto del comando que se enviará a los dispositivos
  * Los comandos deben coincidir con la sintaxis de comandos compatible con su dispositivo
  * Consulte la documentación del dispositivo para conocer los comandos disponibles y el formato correcto
  * No hay restricciones de caracteres en el campo de entrada

</details>
{% endstep %}

{% step %}

#### Agregar acciones adicionales (opcional)

Haga clic en **Agregar acción** para crear múltiples acciones dentro del mismo nodo.

{% hint style="info" %}

* Los comandos de acción se envían al recibir un paquete de datos del dispositivo de acuerdo con la configuración del flujo
* Los comandos se ejecutan secuencialmente en el orden en que aparecen en la configuración
* Cada acción puede ser de un tipo diferente (salida conmutada o comando GPRS)
* Use el icono de papelera para eliminar las acciones innecesarias
  {% endhint %}
  {% endstep %}

{% step %}

#### Configurar asignaciones de destinatarios (opcional)

Abra el **Avanzado** pestaña para definir qué dispositivos adicionales reciben los mismos comandos cuando se activa el nodo.

<figure><img src="https://1900701122-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 el encabezado **Dispositivo de origen** lista desplegable para seleccionar el dispositivo cuyos datos entrantes activan el nodo. Debe ser un dispositivo presente en la **nodo de Fuente de datos**.
2. Use el encabezado **Dispositivos de destino** lista desplegable para seleccionar uno o más dispositivos que recibirán los mismos comandos.
3. Haga clic en **+ Asignación personalizada** para agregar pares adicionales de origen a destino si distintos dispositivos de origen deben propagar comandos a diferentes conjuntos de dispositivos de destino.

{% hint style="info" %}
La pestaña Avanzado es opcional. Sin ella, el nodo se comporta exactamente como antes — los comandos se ejecutan solo para el dispositivo que activó el nodo.
{% endhint %}
{% endstep %}

{% step %}

#### Guardar configuración

Haga clic en **Aplicar cambios** para guardar la configuración de su nodo
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Nota sobre compatibilidad del dispositivo:** La ejecución de acciones depende de las capacidades individuales de cada dispositivo. Asegúrese de que sus dispositivos admitan las salidas o los comandos específicos que está configurando. Busque los comandos compatibles en recursos del fabricante, como la documentación del dispositivo. La lista de dispositivos compatibles está disponible en [dispositivos integrados de Navixy](https://www.navixy.com/devices/).
{% endhint %}

## Ejecución de acciones y direccionamiento

El **Acción del dispositivo** nodo proporciona un control preciso sobre cuándo y dónde se ejecutan los comandos, lo que garantiza respuestas de automatización eficientes y dirigidas.

### Secuencia de ejecución

Cuando se activa, el **Acción del dispositivo** nodo sigue este patrón de ejecución:

1. **Destino de dispositivos**: Las acciones se envían solo a los dispositivos que proporcionaron datos en el evento de activación actual
   1. Esto garantiza que los comandos lleguen solo a los dispositivos específicos involucrados en la condición
   2. Evita comandos innecesarios a los dispositivos no afectados de la flota
2. **Procesamiento secuencial**: Varias acciones dentro de un nodo se ejecutan en el orden configurado, de arriba hacia abajo
   1. Cada acción completa su transmisión antes de que comience la siguiente
   2. El tiempo total de ejecución suele ser de unos segundos desde la recepción del disparador
3. **Validación del dispositivo**: Los dispositivos individuales procesan los comandos recibidos según sus capacidades
   1. Los comandos compatibles se ejecutan inmediatamente al recibirse
   2. Los comandos no compatibles se reciben, pero el dispositivo los ignora
   3. Los mecanismos de seguridad del dispositivo pueden impedir comandos inapropiados (por ejemplo, apagar el motor mientras está en movimiento)

### Comportamiento de la conexión

**Integración con el nodo IF/THEN Lógica**: Cuando se conecta a [IF/THEN Lógica](/docs/user/es/guide/account/iot-logic/nodes/logic-node.md) nodos, las acciones se ejecutan solo para los dispositivos en los que la condición lógica se evaluó como `true`. Esto proporciona una automatización condicional precisa.

**Conexiones directas**: Cuando se conecta directamente a otros tipos de nodo (Fuente de datos, Iniciar atributo), las acciones se ejecutan para todos los dispositivos en el flujo de datos cada vez que se reciben datos.

## Preguntas frecuentes

#### ¿Cómo sé si mis acciones se ejecutaron correctamente?

Verifique [Analizador de datos](/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md): seleccione el dispositivo que activó el nodo y busque el atributo que coincida con el ID del nodo. Consulte [Cómo funcionan los nodos de acción del dispositivo](#how-device-action-nodes-work) para obtener detalles.

Los comandos se envían a dispositivos que están confirmados en línea (los que proporcionan datos recientes), sin intervalo de tiempo entre el disparador y la entrega. Esto elimina la posibilidad de que el dispositivo pase a estar fuera de línea entre el disparador y la ejecución.

#### ¿Puedo conectar varios nodos al mismo nodo de acción del dispositivo?

Sí. Los nodos de acción del dispositivo pueden recibir disparadores de varios nodos anteriores, pero tenga en cuenta que las acciones se ejecutarán para cualquier dispositivo que active cualquier nodo conectado. Al diseñar flujos complejos, considere el efecto acumulativo de múltiples fuentes de activación para asegurarse de que las acciones se ejecuten solo en los escenarios previstos. Para confirmar que el nodo se activa solo en los escenarios que usted pretende, observe su atributo de ID del nodo en [Analizador de datos](/docs/user/es/guide/account/iot-logic/data-stream-analyzer.md): muestra `1` en cada activación y `0` en caso contrario.

#### ¿Qué sucede si conecto un nodo de acción del dispositivo directamente a una Fuente de datos?

El nodo de acción del dispositivo ejecutará sus acciones configuradas cada vez que cualquier dispositivo en la Fuente de datos envíe datos. Esto crea una ejecución continua de acciones en lugar de respuestas condicionales. Para la mayoría de los casos de uso, conectar nodos de acción del dispositivo a [IF/THEN Lógica](/docs/user/es/guide/account/iot-logic/nodes/logic-node.md) nodos proporciona un mejor control sobre cuándo deben ejecutarse las acciones.


---

# 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/es/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.