> 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/fr/guide/devices-and-settings/object-management/commands.md). # Commandes Comment enregistrer des Commandes pour un appareil GPS, comme un redémarrage, l'immobilisation du véhicule ou une alerte de chat d’équipe, et les envoyer depuis Suivi ou X-GPS Mobile. Une commande est une action que vous enregistrez sur un traceur, puis que vous envoyez en un clic. Par exemple, vous pouvez redémarrer un traceur GPS qui a cessé d'envoyer des données, immobiliser un véhicule ou publier la position du véhicule dans le chat de votre équipe. Vous configurez les commandes pour chaque traceur dans le **Paramétrage des traceurs** module. Vous les envoyez ensuite depuis le [widget Traceur](/docs/user/fr/guide/tracking/objects-list/object-widget.md) dans le module Suivi, ou depuis l’ [X-GPS Mobile](/docs/user/fr/guide/x-gps-mobile-apps/x-gps-mobile.md) application. ## Ce que vous pouvez faire avec les commandes Voici des tâches types qu’une commande enregistrée effectue en un clic. La deuxième colonne indique le type de commande qui exécute la tâche. Une commande d’appareil est envoyée au traceur GPS. Une commande logicielle envoie une requête à un autre service, comme un chat d’équipe. [Commandes d'appareil et commandes logicielles](#device-commands-and-software-commands) décrivent les deux. | Tâche | Type de commande | Ce qui se passe | | ----------------------------------------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Redémarrer un traceur qui a cessé d'envoyer des données | Commande d'appareil | Le traceur reçoit sa commande de redémarrage et redémarre. | | Immobiliser un véhicule | Commande d'appareil | Le traceur active la sortie câblée à l'immobiliseur du véhicule. Voir [Immobilisation du véhicule](#vehicle-immobilization). | | Déverrouiller une porte ou activer une alarme | Commande d'appareil | Le traceur active la sortie qui commande la serrure ou l'alarme. | | Modifier un paramètre du traceur avec une nouvelle valeur à chaque fois | Commande d'appareil | Vous saisissez la valeur lorsque vous envoyez la commande, et le traceur l'applique. Voir [Demander une valeur à chaque envoi de commande](#ask-for-a-value-each-time-you-send-a-command). | | Publier la position et la vitesse du véhicule dans un chat d'équipe | Commande logicielle | Navixy envoie le message au chat. Voir [Envoyer la position et la vitesse à Slack](#send-location-and-speed-to-slack). | | Envoyer la position du véhicule à votre CRM ou à votre système de répartition | Commande logicielle | Navixy envoie la position actuelle du traceur à l'adresse du système. | ## Commandes d'appareil et commandes logicielles Navixy propose deux types de commandes. Elles se distinguent par la destination de l'action : * **Commande d'appareil**: Navixy envoie une instruction au traceur GPS, et le traceur l'exécute. Le traceur peut redémarrer, activer ou désactiver une sortie, ou modifier l'un de ses paramètres. L'instruction est un texte appelé chaîne de commande. Chaque modèle de traceur a ses propres chaînes de commande, que son fabricant répertorie dans la documentation du modèle. * **Commande logicielle**: Navixy envoie une requête à un autre service, comme un chat d'équipe, un CRM ou votre propre serveur. Rien n'est envoyé au traceur GPS. La requête peut inclure les données actuelles du traceur, comme sa position et sa vitesse. Chaque traceur possède sa propre liste de commandes. Une commande n'apparaît que sur les traceurs où vous l'ajoutez ou [la copiez vers](#copy-commands-to-other-devices). Cela s'applique aussi à une commande logicielle : elle n'envoie rien au traceur, mais elle envoie ses propres données, comme sa position actuelle. Si quelqu'un a ajouté une commande logicielle à un seul traceur, seul ce traceur l'affiche. ## Immobilisation du véhicule Pour immobiliser un véhicule avec une commande, le véhicule a besoin d'un immobiliseur ou d'un relais d'immobilisation connecté à l'une des sorties du traceur GPS. La commande active cette sortie. La chaîne de commande provient de la documentation du fabricant du traceur. Le comportement du véhicule ensuite dépend de l'immobiliseur et de son installation, et les deux varient d'un véhicule et d'un traceur à l'autre. Par exemple, avec une installation courante, le véhicule continue d'avancer, mais après son arrêt et contact coupé, il ne peut pas redémarrer. Pour libérer le véhicule, vous pouvez ajouter une commande distincte qui remet la sortie dans l'état précédent. Décidez comment configurer l'immobilisation et la remise en service pour vos véhicules, missions et situations. {% hint style="warning" %} Une commande qui active une sortie peut être dangereuse pour un véhicule dans certaines situations, par exemple lorsque le véhicule est en mouvement. Envoyez ce type de commandes avec une prudence accrue, et vérifiez d'abord la situation du véhicule. Navixy ne vérifie pas la vitesse du véhicule ni le contact avant d'envoyer une commande. Certains traceurs GPS ont leur propre logique de sécurité, décrite dans [Contrôle des sorties](/docs/expert-center/fr/faq-and-troubleshooting/gps-devices/outputs-control.md). {% endhint %} ## Quand utiliser IoT Logic à la place Les commandes servent aux actions manuelles : vous décidez quand envoyer une commande, et vous l'envoyez pour un seul traceur à la fois. Pour envoyer des commandes automatiquement, par exemple lorsqu'une valeur de capteur dépasse une limite, ou pour envoyer la même commande à plusieurs traceurs, utilisez [IoT Logic](/docs/user/fr/guide/account/iot-logic.md). Ses **Action de traceur** et **Webhook** font les mêmes tâches que les commandes d'appareil et les commandes logicielles, dans un flux automatisé. Automatisez avec une prudence accrue les commandes qui activent des sorties, comme l'immobilisation. Un flux automatisé envoie la commande lorsque ses conditions sont remplies, et personne ne vérifie l'état du véhicule à ce moment-là. ## Envoyer une commande Vous envoyez une commande depuis le [widget Traceur](/docs/user/fr/guide/tracking/objects-list/object-widget.md) dans le module Suivi. Son **Commandes** liste les commandes du traceur. Une icône de télécommande signale une commande d'appareil, et une icône en chevrons signale une commande logicielle. Navixy envoie une commande dès que vous cliquez sur son bouton d'envoi, sans confirmation. La seule exception est une commande qui [demande une valeur](#ask-for-a-value-each-time-you-send-a-command): elle ouvre d'abord un champ pour la valeur. Avant d'envoyer une commande qui active une sortie, comme l'immobilisation, vérifiez qu'elle est sans danger pour le véhicule dans sa situation actuelle. Voir [Immobilisation du véhicule](#vehicle-immobilization). Pour envoyer une commande, suivez ces étapes : 1. Dans le module Suivi, ouvrez le widget Traceur de l'appareil. 2. Développez le **Commandes** bloc. 3. Cliquez sur le bouton d'envoi à côté de la commande. 4. Si la commande demande une valeur, saisissez jusqu'à 500 caractères et cliquez sur **Envoyer**.
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.

Commandes dans le widget Traceur

L'application X-GPS Mobile affiche les mêmes commandes. Voir [Informations sur l'actif](/docs/user/fr/guide/x-gps-mobile-apps/x-gps-mobile/assets-list/asset-information.md#gps-device) pour savoir où l'application les affiche. Vous ne pouvez pas ajouter ni modifier de commandes dans l'application. ## Résultats des commandes Après l'envoi d'une commande depuis le widget Traceur, Navixy affiche une notification avec le résultat : * Pour une commande d'appareil, la notification indique si Navixy a envoyé la commande. Un résultat réussi signifie que la commande a quitté Navixy. Cela ne confirme pas que le traceur l'a exécutée. * Pour une commande logicielle, la notification affiche le nom de la commande et la réponse du service destinataire. La réponse comporte un code d'état, un nombre qui indique si le service a accepté la requête, par exemple `200` lorsque c'est le cas. Elle contient aussi le texte renvoyé par le service. Chaque commande envoyée apparaît aussi dans le [Événements récents](/docs/user/fr/guide/tracking/objects-list/object-widget.md#data-blocks) bloc du widget Traceur. Développez l'entrée pour voir le résultat. Si la commande demandait une valeur, le titre de l'entrée affiche la valeur que vous avez saisie à côté du nom de la commande, par exemple `Mettre à jour le statut `.
Recent events entry with the value that was sent shown in angle brackets next to the command name

Une commande envoyée dans Événements récents

## Configurer des commandes pour un traceur Pour ouvrir les commandes d'un traceur, suivez ces étapes : 1. Accédez à **Paramétrage des traceurs** dans la barre latérale. 2. Sélectionnez le traceur. 3. Développez le **Commandes** bloc.
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.

Le bloc Commandes d'un traceur sans commandes

Un traceur peut avoir jusqu'à 10 commandes au total, commandes d'appareil et commandes logicielles confondues. Lorsqu'un traceur a 10 commandes, **Ajouter une commande d'appareil** et **Ajouter une commande logicielle** ne sont pas disponibles. Pour supprimer une commande, cliquez sur **Supprimer** dans son formulaire. ### Ajouter une commande d'appareil Une commande d'appareil nécessite la chaîne de commande correspondant à votre modèle de traceur, que vous trouverez dans la documentation du modèle. {% hint style="warning" %} Les chaînes de commande sont différentes pour chaque modèle de traceur. Une mauvaise chaîne de commande peut modifier les paramètres du traceur ou son comportement d'une manière que vous n'aviez pas prévue. Vérifiez la chaîne dans la documentation de votre modèle avant d'enregistrer la commande. {% endhint %} Pour ajouter une commande d'appareil, suivez ces étapes : 1. Cliquez sur **Ajouter une commande d'appareil**. 2. Saisissez un **Nom de la commande**, par exemple `Redémarrage du traceur`. 3. Saisissez la **chaîne de commande**, par exemple `cpureset`. 4. Cliquez sur **Enregistrer**.
Device command form with the Command name and Command string fields, and the Delete and Save buttons

Une commande d'appareil

### Demander une valeur à chaque envoi de commande Une commande peut vous demander une valeur lors de son envoi, au lieu d'envoyer toujours le même texte. Pour qu'une commande d'appareil demande une valeur, ajoutez le `<>` placeholder à l’ **chaîne de commande** endroit où va la valeur, par exemple `relay,<>`. Une commande logicielle peut aussi demander une valeur : voir [Ajouter une commande logicielle](#add-a-software-command). Une commande ne peut avoir qu'un seul `<>` placeholder. Si vous en ajoutez un deuxième, le champ affiche une erreur et Navixy n'enregistre pas la commande. Pour lire un bref résumé de la `<>` syntaxe du produit, cliquez sur l'icône d'aide dans le **Commandes** bloc. ### Copier les commandes vers d'autres traceurs Pour donner les mêmes commandes à plusieurs traceurs, configurez-les sur un traceur puis copiez-les : 1. Dans le **Commandes** bloc, cliquez sur l'icône de copie. Son infobulle est **Appliquer ces paramètres à d'autres traceurs**. 2. Sélectionnez les traceurs. 3. Cliquez sur **Appliquer**. Navixy ajoute les commandes enregistrées du traceur à chaque traceur sélectionné. Les commandes déjà présentes sur un traceur sélectionné restent inchangées. ### Ajouter une commande logicielle Une commande logicielle connecte Navixy à un autre service, comme un chat d'équipe, un CRM ou votre propre serveur. Elle envoie une requête HTTP POST avec un corps JSON à une adresse que vous choisissez. L'adresse peut appartenir à tout service qui accepte de telles requêtes, comme Slack, un récepteur de webhook ou une API REST. Pour ajouter une commande logicielle, suivez ces étapes : 1. Cliquez sur **Ajouter une commande logicielle**. 2. Dans le **Général** onglet, saisissez un **Titre** et l' **URL** qui reçoit la requête. 3. Si le service destinataire a besoin d'en-têtes HTTP, cliquez sur **Ajouter un en-tête** et saisissez la clé et la valeur de chaque en-tête. 4. Dans le **Corps** onglet, saisissez le corps JSON au format attendu par le service destinataire. 5. Cliquez sur **Enregistrer**. {% columns %} {% column width="58.333333333333336%" %} L' **URL** est l'adresse complète du service destinataire, par exemple `https://hooks.slack.com/services/...`. Pour un service qui utilise l'authentification par jeton, ajoutez l' `Authorization` en-tête avec la valeur `Bearer your_token`. Un service qui utilise une clé API dans l'URL n'a pas besoin d'en-tête. {% endcolumn %} {% column width="41.666666666666664%" %}
General tab of a software command with the Title, URL, and Headers fields

L'onglet Général d'une commande logicielle

{% endcolumn %} {% endcolumns %} {% columns %} {% column width="58.333333333333336%" %} Pour ajouter les données actuelles du traceur au corps, utilisez des espaces réservés d'attribut au format `{{attribute_name}}` Cliquez sur Attribute picker à côté du champ et sélectionnez un attribut. Navixy insère son espace réservé à l'endroit où se trouve le curseur. Lorsque vous envoyez la commande, Navixy remplace chaque espace réservé d'attribut par la valeur actuelle de l'attribut. {% endcolumn %} {% column width="41.666666666666664%" %}
Body tab of a software command with a JSON body and the attribute picker button

L'onglet Corps d'une commande logicielle

{% endcolumn %} {% endcolumns %} La liste des attributs n'affiche que les attributs que le traceur envoie à Navixy, elle varie donc d'un traceur à l'autre. Sélectionnez des attributs dans la liste pour éviter les erreurs de saisie dans leurs noms. Pour qu'une commande logicielle [demande une valeur](#ask-for-a-value-each-time-you-send-a-command) lors de son envoi, ajoutez le `<>` placeholder à l’ **Corps**, par exemple `{"value": "<>"}`. ### Envoyer la position et la vitesse à Slack Une commande logicielle peut publier la position et la vitesse du traceur dans un canal Slack via un webhook entrant Slack. Slack attend un corps JSON avec un champ `text` . Ce corps envoie l'identifiant du traceur, la vitesse et les coordonnées : {% code overflow="wrap" %} ```json { "text": "Device {{device_id}}: speed {{speed}} km/h at {{latitude}}, {{longitude}}" } ``` {% endcode %} Pour configurer la commande, suivez ces étapes : 1. Dans Slack, configurez un webhook entrant et copiez son URL. Le [guide des webhooks entrants Slack](https://docs.slack.dev/messaging/sending-messages-using-incoming-webhooks/) explique comment. 2. Dans le **Commandes** bloc, cliquez sur **Ajouter une commande logicielle**. 3. Dans le **Général** onglet, saisissez `Notify Slack` comme le **Titre**. 4. Dans **URL**, collez l'URL du webhook, par exemple `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXX`. 5. Dans le **Corps** onglet, saisissez le corps JSON. 6. Cliquez sur **Enregistrer**. Lorsque vous envoyez la commande, Navixy remplace les quatre espaces réservés d'attribut par les valeurs actuelles du traceur. Le message apparaît dans le canal Slack auquel le webhook appartient. --- # 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/fr/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.