> 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/devices-and-settings/object-management/commands.md). # Comandos Cómo guardar Comandos para un dispositivo GPS, como un reinicio, la inmovilización del vehículo o una alerta de chat del equipo, y enviarlos desde Seguimiento o X-GPS Mobile. Un comando es una acción que usted guarda en un dispositivo y luego envía con un clic. Por ejemplo, puede reiniciar un dispositivo GPS que dejó de enviar datos, inmovilizar un vehículo o publicar la ubicación del vehículo en el chat de su equipo. Usted configura los comandos para cada dispositivo en el **Dispositivos** módulo. Luego los envía desde el [widget Objeto](/docs/user/es/guide/tracking/objects-list/object-widget.md) en el módulo Seguimiento, o desde la [X-GPS Mobile](/docs/user/es/guide/x-gps-mobile-apps/x-gps-mobile.md) aplicación. ## Qué puede hacer con los comandos Estas son tareas típicas que un comando guardado realiza con un solo clic. La segunda columna indica el tipo de comando que realiza la tarea. Un comando del dispositivo se envía al dispositivo GPS. Un comando de software envía una solicitud a otro servicio, como un chat de equipo. [Comandos del dispositivo y comandos de software](#device-commands-and-software-commands) describe ambos. | Tarea | Tipo de comando | Qué sucede | | ---------------------------------------------------------------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Reiniciar un dispositivo que dejó de enviar datos | Comando del dispositivo | El dispositivo recibe su comando de reinicio y se reinicia. | | Inmovilizar un vehículo | Comando del dispositivo | El dispositivo activa la salida que está conectada al inmovilizador del vehículo. Consulte [Inmovilización del vehículo](#vehicle-immobilization). | | Desbloquear una puerta o activar una alarma | Comando del dispositivo | El dispositivo activa la salida que controla la cerradura o la alarma. | | Cambiar la configuración de un dispositivo a un nuevo valor cada vez | Comando del dispositivo | Usted ingresa el valor cuando envía el comando, y el dispositivo lo aplica. Consulte [Solicitar un valor cada vez que envía un comando](#ask-for-a-value-each-time-you-send-a-command). | | Publicar la ubicación y la velocidad del vehículo en un chat de equipo | Comando de software | Navixy envía el mensaje al chat. Consulte [Enviar la ubicación y la velocidad a Slack](#send-location-and-speed-to-slack). | | Enviar la ubicación del vehículo a su CRM o sistema de despacho | Comando de software | Navixy envía la ubicación actual del dispositivo a la dirección del sistema. | ## Comandos del dispositivo y comandos de software Navixy tiene dos tipos de comandos. Se diferencian en el destino de la acción: * **Comando del dispositivo**: Navixy envía una instrucción al dispositivo GPS, y el dispositivo la ejecuta. El dispositivo puede reiniciarse, activar o desactivar una salida, o cambiar una de sus configuraciones. La instrucción es un texto llamado cadena de comando. Cada modelo de dispositivo tiene sus propias cadenas de comando, que su fabricante enumera en la documentación del modelo. * **Comando de software**: Navixy envía una solicitud a otro servicio, como un chat de equipo, un CRM o su propio servidor. No se envía nada al dispositivo GPS. La solicitud puede incluir los datos actuales del dispositivo, como su ubicación y velocidad. Cada dispositivo tiene su propia lista de comandos. Un comando aparece solo en los dispositivos donde usted lo agrega o [lo copia en](#copy-commands-to-other-devices). Esto también aplica a un comando de software: no envía nada al dispositivo, pero sí envía los propios datos de ese dispositivo, como su ubicación actual. Si alguien agregó un comando de software solo a un dispositivo, solo ese dispositivo lo muestra. ## Inmovilización del vehículo Para inmovilizar un vehículo con un comando, el vehículo necesita un inmovilizador o un relé de inmovilización conectado a una de las salidas del dispositivo GPS. El comando activa esa salida. La cadena de comando proviene de la documentación del fabricante del dispositivo. Lo que haga luego el vehículo depende del inmovilizador y de cómo esté instalado, y ambos difieren de un vehículo y un dispositivo a otro. Por ejemplo, con una instalación común, el vehículo sigue moviéndose, pero después de que se detiene y la ignición se apaga, no puede volver a arrancar. Para liberar el vehículo, usted puede agregar un comando separado que vuelva a activar la salida. Decida cómo configurar la inmovilización y la liberación para sus vehículos, tareas y situaciones. {% hint style="warning" %} Un comando que activa una salida puede ser inseguro para un vehículo en algunas situaciones, por ejemplo mientras el vehículo está en movimiento. Envíe esos comandos con precaución adicional y verifique primero la situación del vehículo. Navixy no comprueba la velocidad ni la ignición del vehículo antes de enviar un comando. Algunos dispositivos GPS tienen su propia lógica de seguridad, que se describe en [Control de salidas](/docs/expert-center/es/faq-and-troubleshooting/gps-devices/outputs-control.md). {% endhint %} ## Cuándo usar IoT Logic en su lugar Los comandos son para acciones manuales: usted decide cuándo enviar un comando y lo envía para un dispositivo a la vez. Para enviar comandos automáticamente, por ejemplo cuando el valor de un sensor cruza un límite, o para enviar el mismo comando a muchos dispositivos, use [IoT Logic](/docs/user/es/guide/account/iot-logic.md). Sus **Acción del dispositivo** y **Webhook** nodos realizan las mismas tareas que los comandos del dispositivo y los comandos de software, dentro de un flujo automatizado. Automatice los comandos que activan salidas, como la inmovilización, con precaución adicional. Un flujo automatizado envía el comando cuando se cumplen sus condiciones, y nadie verifica la situación del vehículo en ese momento. ## Enviar un comando Usted envía un comando desde el widget Objeto del dispositivo [widget Objeto](/docs/user/es/guide/tracking/objects-list/object-widget.md) en el módulo Seguimiento. Su **Comandos** bloque enumera los comandos del dispositivo. Un icono de control remoto marca un comando del dispositivo, y un icono de corchetes angulares marca un comando de software. Navixy envía un comando en cuanto usted hace clic en su botón de envío, sin confirmación. La única excepción es un comando que [solicita un valor](#ask-for-a-value-each-time-you-send-a-command): abre primero un campo para el valor. Antes de enviar un comando que activa una salida, como la inmovilización, verifique que sea seguro para el vehículo en su situación actual. Consulte [Inmovilización del vehículo](#vehicle-immobilization). Para enviar un comando, siga estos pasos: 1. En el módulo Seguimiento, abra el widget Objeto del dispositivo. 2. Expanda el **Comandos** bloque. 3. Haga clic en el botón de envío junto al comando. 4. Si el comando solicita un valor, ingrese hasta 500 caracteres y haga clic en **Enviar**.
Object widget in the Tracking module with the Commands block expanded. It lists a device command named Device reboot and a software command named Notify Slack, each with a send button.

Comandos en el widget Objeto

La aplicación X-GPS Mobile muestra los mismos comandos. Consulte [Información del activo](/docs/user/es/guide/x-gps-mobile-apps/x-gps-mobile/assets-list/asset-information.md#gps-device) para saber dónde los lista la aplicación. No puede agregar ni cambiar comandos en la aplicación. ## Resultados de los comandos Después de enviar un comando desde el widget Objeto, Navixy muestra una notificación con el resultado: * Para un comando del dispositivo, la notificación indica si Navixy envió el comando. Un resultado exitoso significa que el comando salió de Navixy. No confirma que el dispositivo lo haya ejecutado. * Para un comando de software, la notificación muestra el nombre del comando y la respuesta del servicio receptor. La respuesta tiene un código de estado, un número que muestra si el servicio aceptó la solicitud, por ejemplo `200` cuando lo hizo. También tiene el texto que devolvió el servicio. Cada comando enviado también aparece en el [Eventos recientes](/docs/user/es/guide/tracking/objects-list/object-widget.md#data-blocks) bloque del widget Objeto. Expanda la entrada para ver el resultado. Si el comando solicitó un valor, el título de la entrada muestra el valor que usted ingresó junto al nombre del comando, por ejemplo `Actualizar estado `.
Recent events entry with the value that was sent shown in angle brackets next to the command name

Un comando enviado en Eventos recientes

## Configurar comandos para un dispositivo Para abrir los comandos de un dispositivo, siga estos pasos: 1. Vaya a **Dispositivos** en la barra lateral. 2. Seleccione el dispositivo. 3. Expanda el **Comandos** bloque.
Devices and settings module with a device selected. The Commands block is expanded and has no commands yet. It shows the Add device command and Add software command buttons.

El bloque Comandos de un dispositivo sin comandos

Un dispositivo puede tener hasta 10 comandos, comandos del dispositivo y comandos de software en conjunto. Cuando un dispositivo tiene 10 comandos, **Agregar comando del dispositivo** y **Agregar comando de software** no están disponibles. Para eliminar un comando, haga clic en **Eliminar** en su formulario. ### Agregar un comando del dispositivo Un comando del dispositivo necesita la cadena de comando para su modelo de dispositivo, que encuentra en la documentación del modelo. {% hint style="warning" %} Las cadenas de comando son diferentes para cada modelo de dispositivo. Una cadena de comando incorrecta puede cambiar la configuración o el comportamiento del dispositivo de una manera que usted no planeó. Verifique la cadena en la documentación de su modelo antes de guardar el comando. {% endhint %} Para agregar un comando del dispositivo, siga estos pasos: 1. Haga clic **Agregar comando del dispositivo**. 2. Ingrese un **nombre del comando**, por ejemplo `Reinicio del dispositivo`. 3. Ingrese la **cadena de comando**, por ejemplo `cpureset`. 4. Haga clic **Guardar**.
Device command form with the Command name and Command string fields, and the Delete and Save buttons

Un comando del dispositivo

### Solicitar un valor cada vez que envía un comando Un comando puede pedirle un valor cuando usted lo envía, en lugar de enviar siempre el mismo texto. Para hacer que un comando del dispositivo pida un valor, agregue el `<>` marcador de posición al **cadena de comando** donde va el valor, por ejemplo `relay,<>`. Un comando de software también puede pedir un valor: consulte [Agregar un comando de software](#add-a-software-command). Un comando puede tener solo un `<>` marcador de posición. Si agrega un segundo, el campo muestra un error y Navixy no guarda el comando. Para leer un breve resumen de la `<>` sintaxis en el producto, haga clic en el icono de ayuda en el **Comandos** bloque. ### Copiar comandos a otros dispositivos Para dar a varios dispositivos los mismos comandos, configúrelos en un dispositivo y cópielos: 1. En el **Comandos** bloque, haga clic en el icono de copiar. Su información sobre herramientas es **Aplicar estos ajustes a otros objetos**. 2. Seleccione los dispositivos. 3. Haga clic **Aplicar**. Navixy agrega los comandos guardados del dispositivo a cada dispositivo seleccionado. Los comandos que un dispositivo seleccionado ya tenga permanecen tal como están. ### Agregar un comando de software Un comando de software conecta Navixy con otro servicio, como un chat de equipo, un CRM o su propio servidor. Envía una solicitud HTTP POST con un cuerpo JSON a una dirección que usted elija. La dirección puede pertenecer a cualquier servicio que acepte esas solicitudes, como Slack, un receptor de webhook o una API REST. Para agregar un comando de software, siga estos pasos: 1. Haga clic **Agregar comando de software**. 2. En la **General** pestaña, ingrese un **Título** y la **URL** que recibe la solicitud. 3. Si el servicio receptor necesita encabezados HTTP, haga clic en **Agregar encabezado** e ingrese la clave y el valor de cada encabezado. 4. En la **Cuerpo** pestaña, ingrese el cuerpo JSON en el formato que espera el servicio receptor. 5. Haga clic **Guardar**. {% columns %} {% column width="58.333333333333336%" %} La **URL** es la dirección completa del servicio receptor, por ejemplo `https://hooks.slack.com/services/...`. Para un servicio que usa autenticación por token, agregue el encabezado `Authorization` con el valor `Bearer your_token`. Un servicio que toma una clave de API en la URL no necesita encabezado. {% endcolumn %} {% column width="41.666666666666664%" %}
General tab of a software command with the Title, URL, and Headers fields

La pestaña General de un comando de software

{% endcolumn %} {% endcolumns %} {% columns %} {% column width="58.333333333333336%" %} Para agregar los datos actuales del dispositivo al cuerpo, use marcadores de posición de atributos en el formato `{{attribute_name}}` . Haga clic en Attribute picker junto al campo y seleccione un atributo. Navixy inserta su marcador de posición donde está el cursor. Cuando envía el comando, Navixy reemplaza cada marcador de posición de atributo con el valor actual del atributo. {% endcolumn %} {% column width="41.666666666666664%" %}
Body tab of a software command with a JSON body and the attribute picker button

La pestaña Cuerpo de un comando de software

{% endcolumn %} {% endcolumns %} La lista de atributos muestra solo los atributos que el dispositivo envía a Navixy, por lo que difiere de un dispositivo a otro. Seleccione atributos de la lista para evitar errores al escribir sus nombres. Para hacer que un comando de software [pida un valor](#ask-for-a-value-each-time-you-send-a-command) cuando usted lo envía, agregue el `<>` marcador de posición al **Cuerpo**, por ejemplo `{"value": "<>"}`. ### Enviar la ubicación y la velocidad a Slack Un comando de software puede publicar la ubicación y la velocidad del dispositivo en un canal de Slack mediante un webhook entrante de Slack. Slack espera un cuerpo JSON con un campo `text` . Este cuerpo envía el ID del dispositivo, la velocidad y las coordenadas: {% code overflow="wrap" %} ```json { "text": "Device {{device_id}}: speed {{speed}} km/h at {{latitude}}, {{longitude}}" } ``` {% endcode %} Para configurar el comando, siga estos pasos: 1. En Slack, configure un webhook entrante y copie su URL. La [guía de webhooks entrantes de Slack](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/) describe cómo. 2. En el bloque del dispositivo **Comandos** haga clic en **Agregar comando de software**. 3. En la **General** la pestaña, ingrese `Notificar a Slack` como el **Título**. 4. En **URL**, pegue la URL del webhook, por ejemplo `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX`. 5. En la **Cuerpo** pestaña, ingrese el cuerpo JSON. 6. Haga clic **Guardar**. Cuando envía el comando, Navixy reemplaza los cuatro marcadores de posición de atributos con los valores actuales del dispositivo. El mensaje aparece en el canal de Slack al que pertenece el webhook. --- # 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/devices-and-settings/object-management/commands.md?ask=&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.