> 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/expert-center/fr/faq-and-troubleshooting/gps-devices/add-and-manage-devices/troubleshoot-device-activation.md). # Dépanner l'activation de l’appareil Diagnostiquez et corrigez les échecs d'activation des appareils GPS dans Navixy. Couvre les causes liées à l'appareil, à la carte SIM et à la configuration de la plateforme pour les problèmes de connexion. Il peut y avoir divers problèmes lors du processus d’activation de l’appareil. Pour accélérer le dépannage, il est efficace d’identifier toutes les causes possibles et de les traiter une par une. ## Comment un appareil passe-t-il en ligne ? Un appareil passe en ligne dès qu’il établit une connexion avec le serveur sur lequel l’ID correspondant de l’appareil est enregistré. La plateforme reçoit alors et décode le premier paquet contenant des coordonnées valides et l’heure actuelle. Trois composants principaux interviennent dans l’activation et le fonctionnement de presque tous les appareils de la plateforme : * Appareil GPS - désigne l’appareil lui-même, qui doit transmettre des données dans un format spécifique selon le protocole du modèle. * Carte SIM - l’appareil a besoin d’une carte SIM pour se connecter. Sans elle, l’appareil ne pourra pas établir de connexion. * Plateforme - elle envoie des commandes automatiques à vos appareils si une passerelle SMS est installée. Nous avons présenté ces composants dans un ordre précis pour une raison. Si l’appareil ne parvient pas à se connecter à la plateforme pour la première fois, il est important de vérifier d’abord l’appareil et la carte SIM, car environ 99,9 % de tous les problèmes se résolvent en traitant ces deux éléments. Dans seulement 0,1 % des cas, le problème peut venir de la plateforme elle-même. Explorons maintenant toutes les causes possibles et les actions à entreprendre pour l’activation initiale sur la plateforme. Nous vous recommandons de vérifier tous ces aspects afin de commencer à suivre les appareils et de profiter au plus vite de toutes les fonctionnalités de la plateforme. ## Appareil GPS Vous trouverez ici une liste complète de tous les problèmes possibles du côté de l’appareil dont nous avons connaissance. La majorité de ces problèmes peuvent être résolus soit directement sur l’appareil, soit avec l’aide du fabricant. Si vous rencontrez des commandes d’activation qui doivent être exécutées du côté de la plateforme, notre service d’assistance technique peut vous guider et s’assurer que les commandes ont bien été envoyées aux appareils.
Si l’appareil est neuf ou n’a pas été utilisé pendant une longue période Si l’appareil est neuf ou n’a pas été utilisé pendant une longue période, un démarrage à froid du GPS peut être nécessaire. Un démarrage à froid du GPS se produit lorsque l’appareil doit déterminer sa position à partir de zéro. Cela se produit généralement lorsque l’appareil a été éteint ou qu’il a été hors de portée des signaux satellites pendant une durée importante. Lors d’un démarrage à froid, l’appareil doit télécharger les données de chaque satellite afin de calculer précisément sa position. La durée d’un démarrage à froid peut varier en fonction de la puissance et de la disponibilité des signaux satellites. Cela prend généralement quelques minutes, mais sur certains modèles d’appareil, cela peut prendre jusqu’à 15 minutes. Dans ce cas, soyez patient et laissez à l’appareil le temps de terminer le processus de démarrage à froid.
Un appareil est éteint Oui, il arrive que l’appareil soit éteint et que l’utilisateur ait vérifié en détail tous les aspects possibles. C’est très simple. Si l’appareil répond aux commandes SMS ou si les voyants LED fonctionnent, alors il est allumé et prêt à fonctionner.
Un appareil est en mode "veille" De nombreux modèles d’appareils disposent d’une fonctionnalité de Mode "veille". Ce mode est généralement utilisé pour économiser l’énergie de la batterie interne de l’appareil ou réduire l’utilisation des données sur les cartes SIM. Il existe différents types de modes de veille, allant de la désactivation du module GPS tout en conservant les capacités de communication sans envoyer de coordonnées de localisation précises, jusqu’à un mode de veille complet où l’appareil ne répond plus aux SMS, aux commandes Internet et aux autres formes d’interaction. Dans ce mode, l’appareil ne se réveille qu’à des moments précis ou lorsque certaines conditions sont remplies. Pour commencer le dépannage, la première étape consiste à déterminer si le mode veille est activé sur votre appareil. En général, ce mode peut être désactivé en secouant l’appareil.
Paramètres de suivi Certains modèles d’appareil offrent des options de configuration supplémentaires pour fonctionner dans différents modes. Dans ces modes, l’appareil peut envoyer ou non des données selon différents facteurs : * Si l’appareil détecte qu’il est en itinérance, il peut passer à un autre mode d’envoi des données. Toutefois, cela se produit généralement moins fréquemment. * En mode stationnement, l’appareil réduit l’utilisation des données et active le mode éco. Par conséquent, lorsque l’appareil n’est pas en mouvement, il n’envoie pas de données ou en envoie très rarement. Il peut seulement envoyer des paquets de présence ou des paquets TCP de maintien de connexion. Cependant, pour la première connexion, la plateforme doit recevoir un paquet correct contenant des coordonnées GPS. Ainsi, pour vous assurer que l’appareil envoie ces informations, une solution simple consiste à conduire ou à marcher dans le quartier avec l’appareil. Cela incitera l’appareil à transmettre les données nécessaires.
Un appareil est installé dans le mauvais sens Le fait que l’appareil soit installé dans le mauvais sens peut être considéré comme un cas particulier dans le contexte précédent. Chaque fabricant d’appareil fournit des consignes spécifiques pour une installation correcte. Si l’appareil est installé incorrectement, cela peut entraîner divers problèmes. L’un des problèmes importants qui surviennent lors de l’activation est que l’Accéléromètre ne détecte pas le Mouvement de l’appareil. Par exemple, si l’appareil est monté verticalement au lieu d’horizontalement comme prévu, il ne pourra pas reconnaître le début du mouvement et n’enverra donc pas de données à la plateforme. Pour résoudre ce problème, il est nécessaire de réinstaller l’appareil dans la bonne orientation conformément aux recommandations du fabricant.
Un appareil est déchargé Il arrive parfois qu’un appareil soit déchargé, en particulier pour les appareils GPS personnels et de fret. On peut avoir l’impression que l’utilisateur a déjà essayé d’allumer l’appareil à l’aide du bouton, mais qu’il n’y a aucune réponse. Dans ce cas, la démarche recommandée consiste à essayer de charger l’appareil, puis à tenter de le rallumer après un certain temps. Pour les appareils montés sur véhicule en particulier, il est essentiel de vérifier qu’ils sont correctement raccordés à la batterie de la voiture. Dans ce cas, il est crucial de revérifier le câblage.
L’ID ou le numéro de téléphone incorrect de l’appareil est spécifié sur la plateforme Certains appareils peuvent avoir des IDs supplémentaires en plus de l’IMEI. Ces IDs sont envoyés à la plateforme dans le premier paquet de connexion. Si l’ID du paquet de connexion ne correspond pas à celui spécifié sur la plateforme, votre appareil ne sera pas enregistré et ses paquets seront rejetés. * Vérifiez à nouveau l’exactitude de l’ID spécifié. * Assurez-vous de vérifier que l’IMEI spécifié correspond au numéro de carte SIM que vous avez fourni lors de l’enregistrement de l’appareil GPS. Il est compréhensible de faire des erreurs, surtout lorsque plusieurs appareils sont enregistrés simultanément. * Vérifiez également le paramètre de l’appareil relatif à l’envoi de l’ID. Sélectionnez le réglage qui envoie le même ID que celui que vous avez spécifié sur la plateforme afin de garantir un enregistrement précis.
Un appareil ne peut pas envoyer de coordonnées GPS valides Pour qu’un appareil établisse une connexion correcte, il est essentiel que la plateforme reçoive des coordonnées précises en temps réel. Pour vous en assurer, plusieurs facteurs doivent être vérifiés : * Vérifiez que l’appareil se trouve dans une zone bénéficiant d’une couverture GPS fiable. * Assurez-vous qu’il n’y a pas de couche importante de métal qui obstrue le signal de l’appareil au-dessus de son emplacement d’installation. * Veillez à ce que l’appareil soit installé à l’extérieur, en évitant les garages, les bâtiments, les tunnels ou les zones sous toiture. * Vérifiez que l’antenne GPS est correctement connectée sur les appareils équipés d’une antenne externe. Si vous n’avez pas encore installé l’appareil, il est recommandé de faire une courte marche ou un bref trajet en voiture avec lui afin d’obtenir les coordonnées initiales. Cela aidera à établir une connexion réussie et précise.
Le fuseau horaire de l’appareil n’est pas UTC+0 Même s’il peut sembler logique que l’appareil transmette des données en fonction de votre fuseau horaire actuel, ce n’est pas le cas. La plateforme suit un format standardisé pour recevoir les données des appareils, puis convertit l’heure reçue dans le fuseau horaire que vous avez spécifié dans les paramètres utilisateur. Si l’appareil envoie des paquets avec des horodatages différents de UTC+0, il ne pourra pas s’activer correctement sur la plateforme. Pour résoudre ce problème, assurez-vous que le fuseau horaire de l’appareil est réglé sur UTC+0. Cela garantira une synchronisation précise entre l’appareil et la plateforme.
Un mot de passe personnalisé pour les commandes SMS est défini sur un appareil Certains clients choisissent de définir un mot de passe personnalisé sur les commandes SMS de leurs appareils afin de renforcer la sécurité. Bien que cela se justifie dans certains scénarios, cela peut compliquer inutilement le fonctionnement de l’appareil pour la surveillance régulière des véhicules. Pour que des intrus modifient des paramètres, ils devraient connaître le modèle de l’appareil et le numéro de téléphone de la carte SIM afin d’envoyer des commandes SMS. Si l’utilisation d’un mot de passe est jugée nécessaire, il est recommandé de configurer uniquement un appareil manuellement. Cependant, si l’utilisation d’un mot de passe n’est pas requise, il est conseillé de supprimer le mot de passe personnalisé et de définir à la place un mot de passe standard. Cela garantira que les commandes de la plateforme peuvent atteindre avec succès votre appareil.
Erreurs dans les commandes envoyées manuellement Les erreurs dans les commandes envoyées manuellement sont assez courantes et peuvent causer des problèmes. Lors de l’activation manuelle d’un appareil, les commandes contiennent souvent plusieurs paramètres. La moindre erreur dans une virgule ou un signe peut rendre la commande entière incorrecte. De plus, tous les modèles d’appareil ou toutes les cartes SIM ne peuvent pas vous signaler ces erreurs. Il est crucial de vérifier attentivement les commandes que vous envoyez à votre appareil ou les paramètres que vous avez configurés. Parmi les paramètres importants pour établir la connexion initiale de l’appareil figurent l’adresse IP, le port et les paramètres APN. * Le paramètre APN est utilisé pour connecter votre carte SIM à Internet. S’il est saisi incorrectement, la carte SIM ne pourra pas se connecter au réseau ni commencer à envoyer des messages. * L’adresse IP aide la plateforme à déterminer sur quel serveur l’appareil enregistré doit se trouver. Lors de l’activation de l’appareil, l’adresse requise sera affichée dans l’interface utilisateur. Toutefois, si vous activez l’appareil manuellement, vous pouvez déterminer l’adresse vous-même. C’est simple à identifier : si le numéro du panneau commence par 10XXXXXX, le serveur américain est utilisé ; sinon, c’est le serveur européen. * Pour le serveur américain, l’adresse de suivi est soit 13.52.37.2 soit [tracker.us.navixy.com](http://tracker.us.navixy.com). * En revanche, pour le serveur européen, l’adresse de suivi est soit 52.57.1.136 soit [tracker.navixy.com](http://tracker.navixy.com). * Le choix du port détermine le protocole utilisé pour décoder les paquets des appareils. Vous pouvez trouver le port approprié sur [notre site web](https://www.navixy.com/devices/) dans la section des appareils pris en charge. Saisissez le nom de votre appareil dans la barre de recherche et ouvrez la fiche d’un modèle pour trouver les informations nécessaires sur le port.
Un appareil peut tenter de transférer des données depuis sa mémoire tampon La plateforme est conçue pour accepter les données de la mémoire tampon de l’appareil pendant une période allant jusqu’à six mois avant l’enregistrement. Pendant ce processus, l’appareil affichera l’état bleu « GPS non mis à jour » jusqu’à ce qu’il ait transféré tous les points stockés dans sa mémoire. Si la mémoire tampon de l’appareil contient des données couvrant plus de six mois, il continuera à tenter d’envoyer ces données à la plateforme, mais la plateforme filtrera ces points de données plus anciens. L’appareil ne sera pas activé sur la plateforme tant que les données historiques ne se situeront pas dans la plage des six mois. * Si les données mises en mémoire tampon sont inutiles, vous avez la possibilité de les supprimer. Cela permet à l’appareil de commencer immédiatement à transmettre de nouvelles données actuelles à la plateforme. * Sinon, vous pouvez également accélérer la transmission des données depuis la mémoire tampon, afin que l’appareil passe en ligne le plus rapidement possible.
La modification du micrologiciel ou de l’appareil n’est pas prise en charge Chaque modèle et chaque modification d’appareil peuvent avoir leur propre protocole ou des fonctionnalités uniques non couvertes par le protocole déjà intégré. Cela peut également s’appliquer à différentes versions du micrologiciel d’un appareil. Si le fabricant modifie certains détails de la manière dont les données sont envoyées dans les messages, en particulier ceux contenant une somme de contrôle, la plateforme peut être incapable de les lire ou de les interpréter correctement. Dans de tels scénarios, vous aurez besoin de l’aide de l’équipe d’assistance technique de . Pour faciliter la communication, il serait préférable d’inclure à la fois le fabricant et l’équipe d’assistance Navixy comme destinataires dans votre courriel. Ainsi, vous éviterez de jouer les intermédiaires et de devoir transmettre les informations d’un côté à l’autre entre les équipes.
## Carte SIM Nous avons ici rassemblé tous les cas connus de problèmes du côté de la carte SIM. Pour les résoudre, vous devez contacter votre opérateur mobile.
Un appareil se trouve dans une zone avec un signal GSM faible Si votre appareil se trouve dans une zone avec un signal GSM faible, il peut ne pas être en mesure de recevoir les commandes SMS pour l’enregistrement et, par conséquent, de ne pas appliquer les nouveaux paramètres du serveur nécessaires à l’envoi des données. Un tel appareil ne reconnaît généralement pas qu’il est censé transmettre des données à notre plateforme. En règle générale, il suffit de déplacer l’appareil vers une zone offrant un signal plus fort pour résoudre ce problème. La plupart des opérateurs GSM facilitent la détermination de la puissance du signal GSM. Cette information peut souvent être trouvée dans l’espace personnel de votre opérateur GSM ou sur demande.
Un appareil se trouve dans une zone avec un signal Internet mobile faible Si votre appareil se trouve dans une zone avec un signal Internet faible, il peut ne pas être en mesure de transmettre des données de localisation à la plateforme ou d’établir une connexion quelconque. Il est essentiel de distinguer les différents standards de transmission de données Internet et GSM. Il est généralement plus difficile d’obtenir des informations sur la puissance d’un signal Internet que sur celle du GSM. Parfois, la puissance du GSM est présentée comme une preuve de connectivité, mais il est important de se rappeler qu’un signal GSM à 100 % ne garantit pas nécessairement l’accès à Internet à l’emplacement de l’appareil. Il est possible que la station de base à proximité ne transmette que le GSM ou que votre fournisseur de services n’ait pas d’accord pour acheminer le trafic Internet via d’autres opérateurs au niveau de cette station de base. Il est également possible que la station de base la plus proche ne prenne pas en charge le standard de communication nécessaire à la transmission des données. Par exemple, la station de base peut n’émettre qu’un signal 3G, alors que votre appareil est limité à la 2G. Il existe deux méthodes pour vérifier cela : * Contactez votre opérateur GSM. Veillez à préciser que vous avez besoin d’informations sur la couverture Internet à l’emplacement exact où vous vous trouvez. * Insérez une carte SIM dans votre téléphone et vérifiez vous-même la disponibilité du réseau.
La carte SIM ne dispose pas de la fonctionnalité SMS Ce problème peut survenir si votre carte SIM n’est pas configurée pour recevoir des commandes SMS. Cette fonctionnalité est essentielle pour l’activation automatique de votre appareil, car elle s’appuie sur le canal SMS pour que la plateforme envoie des commandes d’activation et connecte votre appareil à notre serveur et à notre port. Vous devez vérifier auprès de votre opérateur GSM si votre carte SIM est activée pour recevoir des commandes SMS. Si vous n’avez pas l’intention d’utiliser les commandes SMS, vous pouvez utiliser le configurateur de l’appareil ou la plateforme du fabricant, comme FOTA Web, pour configurer votre appareil.
La carte SIM n’a pas le service de données Internet mobile activé Cette situation est assez courante. Il est possible que la carte SIM que vous avez achetée initialement ne soit pas capable de transmettre des données via Internet et soit uniquement conçue pour les appels ou les SMS. Pour résoudre ce problème, contactez votre opérateur GSM et demandez l’activation des services de transfert de données Internet mobile.
La carte SIM a épuisé son trafic Internet Il est possible que vous ayez utilisé toutes vos données Internet ou tous vos mégaoctets payés avant de connecter votre appareil à notre plateforme. Dans ce cas, votre appareil ne pourra pas transmettre de données à la plateforme. Autre scénario possible : vous ne disposez pas de fonds suffisants sur votre compte pour augmenter automatiquement votre limite de données. L’enveloppe de données de votre forfait a peut-être été épuisée, mais sans fonds supplémentaires ou service de renouvellement automatique, la limite de données ne peut pas être augmentée. Pour résoudre ce problème, contactez votre opérateur GSM et renseignez-vous sur les données Internet restantes sur votre carte SIM ainsi que sur le solde de votre compte. Vérifiez également si le service de renouvellement automatique de votre limite de données est activé sur votre carte SIM. Nous vous recommandons d’activer ce service, s’il est proposé par votre opérateur mobile, et de configurer des notifications de prélèvement sur votre courriel. Ce service évitera de tels problèmes, et les notifications aideront à identifier les appareils consommant beaucoup de données en raison d’une mauvaise configuration.
La carte SIM n’est pas activée Certaines cartes SIM nécessitent un processus d’activation spécifique avant de pouvoir être utilisées. Il est essentiel de consulter votre fournisseur de services mobiles pour connaître les étapes appropriées afin d’activer votre carte SIM.
La carte SIM est endommagée ou mal installée Si ce problème n’était pas possible, il ne figurerait pas dans ce guide. Malheureusement, nous avons rencontré de tels problèmes à plusieurs reprises. Assurez-vous d’avoir correctement installé la carte SIM et de ne pas l’avoir endommagée pendant le processus.
L’envoi de données vers l’IP de notre serveur est bloqué par le FAI Il s’agit d’un scénario relativement rare, mais il peut se produire. Par exemple, nous avons eu une expérience avec un partenaire dans un pays donné où les données ne pouvaient pas être envoyées à nos serveurs, car l’adresse IP de notre serveur devait être autorisée. Cela était dû à leur procédure particulière de transmission de données vers des serveurs situés dans d’autres pays. Nous vous recommandons de confirmer cet aspect auprès de votre fournisseur de services mobiles.
Le standard de communication d’un appareil ne correspond pas au standard de communication d’une carte SIM C’est l’une des erreurs possibles que vous pouvez rencontrer lorsque vous tentez de connecter votre appareil à la plateforme. Chaque modèle et chaque version d’appareil prend en charge des standards de communication spécifiques pour la transmission des données. Certains appareils prennent en charge la 2G et la 3G, certains seulement la 2G, tandis que d’autres ne prennent en charge que la 3G ou exclusivement la LTE. Si votre carte SIM n’est pas compatible avec ces standards de communication, ou si la station de base à proximité ne peut pas les prendre en charge, votre appareil ne pourra tout simplement pas communiquer. Vous pouvez vérifier quels standards de communication sont pris en charge par différents modèles [sur notre site web](https://www.navixy.com/devices/), car nous nous efforçons toujours de fournir cette information. Vous pouvez également vérifier les standards pris en charge sur le site web du fabricant de l’appareil ou en contactant son équipe d’assistance.
Itinérance Si votre carte SIM n’est pas M2M et que l’itinérance n’est pas activée, elle ne fonctionnera pas dans les pays étrangers. Par conséquent, votre appareil ne pourra pas recevoir de commandes ni établir de connexion initiale à la plateforme. Si vos appareils se rendent régulièrement dans d’autres pays et que vous utilisez ce type de carte SIM pour le suivi des objets, l’activation de la fonction d’itinérance serait utile.
## Plateforme Vous trouverez ici les problèmes potentiels qui peuvent survenir du côté de la plateforme. Si vous avez déjà vérifié toutes les autres possibilités et que tout est correctement configuré, le problème peut venir de la passerelle SMS installée utilisée pour envoyer les commandes ou d’autres paramètres de la plateforme.
Un panneau ne dispose pas de passerelle SMS Si la période de démonstration de votre panneau a expiré, vous devrez configurer votre propre passerelle SMS afin d’utiliser la fonctionnalité d’activation automatique de l’appareil. Sans passerelle SMS, les commandes d’enregistrement ne seront pas envoyées depuis la plateforme. Vous pouvez vous référer [à nos instructions](/docs/admin/fr/settings/messaging-gateways.md#sms-gateway) pour comprendre les exigences relatives à l’installation d’une passerelle SMS sur votre panneau.
La passerelle SMS ne prend pas en charge l’envoi d’espaces au début d’un message Si votre passerelle ne prend pas en charge l’envoi d’espaces au début des messages, il ne sera pas possible d’activer des appareils Teltonika et Ruptela à l’aide de celle-ci. Cela est dû aux particularités des commandes de ces appareils, qui nécessitent des espaces au début de chaque commande SMS.
L’option « Ne pas envoyer les paramètres par défaut » est activée dans les paramètres du panneau Examinez les paramètres de votre panneau d’administration. Il est possible que vous ayez précédemment activé une fonctionnalité qui empêche la plateforme d’envoyer des commandes SMS pour configurer les appareils. Pour reprendre l’envoi des commandes, vous devrez désactiver cette option dans le panneau d’administration → préférences de service.
Fonds insuffisants dans le compte utilisateur où vous activez l’appareil Si le compte utilisateur dans lequel vous activez l’appareil ne dispose pas de fonds suffisants, cela peut être à l’origine du problème. Chaque forfait utilisateur offre la possibilité d’autoriser ou d’interdire l’envoi de SMS, ainsi que de définir le prix de chaque message. * Si l’envoi de SMS est désactivé dans le forfait de l’utilisateur, vous pouvez facilement corriger cela en l’activant et en définissant un prix. Ce prix sera déduit du compte de l’utilisateur chaque fois qu’une commande SMS est envoyée. * Si le solde de l’utilisateur est trop faible, conseillez-lui de recharger son compte sur la plateforme.
Fonds insuffisants dans le compte de votre passerelle SMS Ce problème survient parfois lorsque le compte de votre passerelle SMS est à court de fonds. Pour résoudre ce problème, rendez-vous sur le tableau de bord de votre passerelle SMS et ajoutez des fonds à votre compte.
Votre passerelle SMS ne peut pas délivrer de message à un appareil Plusieurs raisons peuvent expliquer ce problème : * L’appareil peut être éteint, déchargé ou en mode veille. * Le service de réception et de traitement des SMS peut être désactivé sur la carte SIM. * Le numéro de téléphone peut être incorrect, ou votre passerelle SMS peut interdire l’envoi de messages à de tels numéros. * Il peut y avoir une erreur dans les paramètres de la passerelle SMS. * Un autre type d’erreur provenant de la passerelle SMS. En général, les passerelles nous envoient un code d’erreur que nous enregistrons ensuite dans nos journaux.
Si, après avoir examiné et résolu tous les problèmes potentiels mentionnés ci-dessus, votre appareil ne parvient toujours pas à se connecter, veuillez contacter notre équipe d’assistance technique à . --- # 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/expert-center/fr/faq-and-troubleshooting/gps-devices/add-and-manage-devices/troubleshoot-device-activation.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.