> 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 pendant le 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 se met-il En ligne ? Un appareil se met En ligne une fois qu’il établit une connexion avec le serveur où l’ID de l’appareil correspondant 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 sur la plateforme : * Appareil GPS - désigne l’appareil lui-même, qui doit transmettre les données dans un format spécifique conformément au protocole du modèle. * Carte SIM - l’appareil a besoin d’une carte SIM pour la connectivité. Sans elle, l’appareil ne sera pas en mesure d’établir une connexion. * Plateforme - elle envoie des Commandes automatiques à vos appareils si une passerelle SMS est installée. Nous avons classé 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 se situer dans la plateforme elle-même. À présent, examinons toutes les raisons et les actions possibles pour l’activation initiale sur la plateforme. Nous vous recommandons de vérifier tous ces aspects afin de commencer à suivre les appareils et de tirer pleinement parti des fonctionnalités de la plateforme dès que possible. ## Appareil GPS Vous trouverez ici une liste complète de tous les problèmes possibles côté appareil dont nous avons connaissance. La majorité de ces problèmes peuvent être résolus soit en les traitant directement sur l’appareil, soit avec l’aide du fabricant. Si vous rencontrez des Commandes d’activation qui doivent être exécutées côté plateforme, notre service d’assistance technique peut vous guider et s’assurer que les Commandes ont bien été envoyées aux appareils.
Si un appareil est neuf ou n’a pas été utilisé pendant une période prolongée Si l’appareil est neuf ou n’a pas été utilisé pendant une période prolongée, un démarrage à froid du GPS peut être nécessaire. Un démarrage à froid du GPS se produit lorsque l’appareil doit établir sa position à partir de zéro. Cela se produit généralement lorsque l’appareil a été éteint ou a été hors de portée des signaux satellites pendant une durée importante. Pendant un démarrage à froid, l’appareil doit télécharger des données de chaque satellite afin de calculer avec précision sa position exacte. 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 un peu de temps pour 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é minutieusement tous les aspects possibles. C’est simple. Si l’appareil répond aux Commandes SMS ou si les indicateurs LED fonctionnent, alors il est allumé et prêt à l’emploi.
Un appareil est en Mode "veille" De nombreux modèles d’appareil disposent d’une fonctionnalité Mode "veille". Ce mode sert généralement à é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 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 veille complet où l’appareil ne répond plus aux Commandes SMS, aux Commandes Internet et à toute autre forme 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 transmettre des données ou non 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. Cependant, 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 heartbeat ou TCP keep-alive. Cependant, pour la connexion initiale, la plateforme doit recevoir un paquet correct contenant les coordonnées GPS. Donc, pour garantir que l’appareil envoie cette information, une solution simple consiste à faire le tour du quartier à pied ou en voiture avec l’appareil. Cela incitera l’appareil à transmettre les données nécessaires.
Un appareil est installé dans le mauvais sens Le fait qu’un 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é de manière incorrecte, cela peut entraîner divers problèmes. L’un des problèmes importants qui survient pendant l’activation est que l’Accéléromètre ne parvient pas à détecter le Mouvement de l’appareil. Par exemple, si l’appareil est monté verticalement au lieu d’horizontalement comme prévu, il sera incapable de reconnaître le début du mouvement et n’enverra donc pas de données à la plateforme. Pour résoudre cela, il est nécessaire de réinstaller l’appareil dans la bonne orientation conformément aux recommandations du fabricant.
Un appareil est déchargé Parfois, un appareil peut être déchargé, en particulier pour les appareils GPS personnels et de fret. Il peut sembler que l’utilisateur ait déjà essayé d’allumer l’appareil à l’aide du bouton, mais il n’y a aucune réponse. Dans ce cas, la marche à suivre recommandée est d’essayer de charger l’appareil, puis de 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’il est correctement connecté à la batterie de la voiture. Revérifier le câblage est crucial dans cette situation.
Un ID d’appareil ou un numéro de téléphone incorrect est spécifié sur la plateforme Certains appareils peuvent avoir des ID supplémentaires en plus de l’IMEI. Ces ID 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 une nouvelle fois 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 vous enregistrez plusieurs appareils simultanément. * Vérifiez également dans les paramètres de l’appareil l’option d’envoi de l’ID. Sélectionnez le paramètre qui envoie le même ID que celui que vous avez spécifié sur la plateforme afin de garantir un enregistrement exact.
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 exactes en temps réel. Pour ce faire, 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’aucune couche importante de métal ne gêne le signal de l’appareil au-dessus de son emplacement d’installation. * Assurez-vous que l’appareil est installé à l’extérieur, en évitant les garages, les bâtiments, les tunnels ou les zones sous toiture. * Vérifiez si 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 pour acquérir 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 les données en fonction de votre fuseau horaire actuel, ce n’est en réalité 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 défini 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 comme mesure de sécurité supplémentaire. Bien que cela soit justifié dans certains scénarios, cela peut compliquer inutilement le fonctionnement de l’appareil pour la surveillance courante des véhicules. Pour que des intrus puissent modifier 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 ne configurer un appareil que 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 puissent atteindre votre appareil avec succès.
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. Même une seule erreur dans une virgule ou un signe peut rendre la commande entière incorrecte. En outre, 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 et 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 s’affichera dans l’interface utilisateur. Cependant, 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). * D’un autre côté, pour le serveur européen, l’adresse de suivi est 52.57.1.136 ou [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 du modèle pour trouver les informations nécessaires sur le port.
Un appareil peut tenter de transférer des données depuis son tampon La plateforme est conçue pour accepter les données du tampon de l’appareil pendant une période allant jusqu’à six mois avant l’enregistrement. Pendant ce processus, l’appareil affichera un statut bleu « GPS non mis à jour » jusqu’à ce qu’il ait déchargé tous les points de sa mémoire. Si le 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 anciens points de données. L’appareil ne sera pas activé sur la plateforme tant que les données historiques ne seront pas dans la limite des six mois. * Si les données du tampon sont inutiles, vous pouvez les supprimer. Cela permet à l’appareil de commencer immédiatement à transmettre de nouvelles données actuelles à la plateforme. * Vous pouvez également accélérer la transmission des données du tampon, ce qui permet à l’appareil de se mettre 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 peut avoir son propre protocole ou des fonctionnalités uniques qui ne sont pas couvertes par le protocole déjà intégré. Cela peut également s’appliquer aux différentes versions de 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 accompagnés d’une somme de contrôle, la plateforme peut être incapable de les lire ou de les interpréter correctement. Dans de tels cas, vous devrez obtenir de l’aide de l’équipe d’assistance technique à . 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 e-mail. Ainsi, vous pourrez éviter de jouer les intermédiaires en devant faire circuler les informations entre les équipes.
## Carte SIM Ici, nous avons recueilli 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 se peut qu’il ne puisse pas recevoir les Commandes SMS pour l’enregistrement et, par conséquent, qu’il n’applique pas 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 devrait transmettre des données à notre plateforme. En règle générale, le fait de déplacer l’appareil vers une zone avec un signal plus fort suffit à résoudre ce problème. La plupart des fournisseurs GSM permettent de déterminer facilement l’intensité du signal GSM. Cette information se trouve souvent dans votre compte personnel auprès du fournisseur 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 se peut qu’il ne puisse pas transmettre les données de localisation à la plateforme ou établir une quelconque connexion du tout. Il est crucial de distinguer les différentes normes 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 la plus proche ne transmette que le GSM ou que votre fournisseur de services n’ait pas d’accord pour transmettre le trafic Internet via d’autres opérateurs au niveau de la station de base. Il est également possible que la station de base la plus proche ne prenne pas en charge la norme de communication nécessaire à la transmission des données. Par exemple, la station de base peut ne transmettre qu’un signal 3G, alors que votre appareil est limité à la 2G. Il existe deux méthodes pour vérifier cela : * Contactez votre fournisseur GSM. Veillez à préciser que vous avez besoin d’informations sur la couverture Internet dans votre emplacement spécifique. * Installez une carte SIM dans votre téléphone et vérifiez vous-même la disponibilité du réseau.
La fonction SMS n’est pas disponible sur la carte SIM Ce problème pourrait se produire 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 repose sur le canal SMS pour que la plateforme envoie des Commandes d’activation et connecte votre appareil à notre serveur et à notre port. Vous devriez vérifier auprès de votre fournisseur GSM si votre carte SIM est configurée pour recevoir des Commandes SMS. Si vous n’avez pas l’intention d’utiliser des Commandes SMS, vous pouvez utiliser le configurateur d’appareil ou la plateforme du fabricant, telle que FOTA Web, pour configurer votre appareil.
La carte SIM n’a pas le service 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 qu’elle soit uniquement conçue pour les appels ou les SMS. Pour résoudre ce problème, contactez votre fournisseur GSM et demandez l’activation des services de transfert de données Internet mobile.
La carte SIM n’a plus de trafic Internet Vous avez peut-être utilisé toutes vos données Internet ou 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. Une autre possibilité est que vous ne disposiez pas de fonds suffisants sur votre compte pour augmenter automatiquement votre limite de données. Les données allouées par votre forfait ont peut-être été épuisées, mais sans fonds supplémentaires ni service de renouvellement automatique, la limite de données ne peut pas être augmentée. Pour résoudre ce problème, contactez votre fournisseur 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 disponible auprès de votre opérateur mobile, et de configurer des notifications de débit à destination de votre e-mail. Ce service évitera de tels problèmes, et les notifications aideront à identifier tout appareil présentant une consommation de données élevée 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 d’activation de votre carte SIM.
La carte SIM est endommagée ou n’est pas installée correctement Si ce problème n’était pas une possibilité, 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’adresse 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 spécifique où les données ne pouvaient pas être envoyées à nos serveurs parce que l’adresse IP de notre serveur devait être mise sur liste blanche. Cela était dû à leur procédure particulière de transmission des 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.
La norme de communication d’un appareil ne correspond pas à la norme de communication d’une carte SIM Il s’agit d’une erreur possible 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 normes de communication spécifiques pour la transmission des données. Certains appareils peuvent prendre en charge la 2G et la 3G, d’autres seulement la 2G, tandis que d’autres peuvent ne prendre en charge que la 3G ou uniquement la LTE. Si votre carte SIM n’est pas compatible avec ces normes 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 quelles normes de communication sont prises 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. Sinon, vous pouvez vérifier les normes prises 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 une connexion initiale à la plateforme. Si vos appareils voyagent régulièrement vers d’autres pays et que vous utilisez ce type de carte SIM pour le suivi des objets, activer la fonctionnalité d’itinérance serait bénéfique.
## Plateforme Ici, vous trouverez 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 provenir de la passerelle SMS installée utilisée pour l’envoi des Commandes ou d’autres paramètres de la plateforme.
Un panneau ne dispose pas d’une passerelle SMS Si la période de démonstration de votre panneau est expirée, 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/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 les 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 déjà activé une fonctionnalité qui empêche la plateforme d’envoyer des Commandes SMS pour configurer des 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é soit d’autoriser, soit d’interdire l’envoi de messages 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 sur votre compte de passerelle SMS Ce problème survient parfois lorsque le compte de votre passerelle SMS n’a plus 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 livrer le 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 messages SMS pourrait être désactivé sur la carte SIM. * Le numéro de téléphone pourrait être incorrect, ou votre passerelle SMS peut interdire l’envoi de messages vers de tels numéros. * Il pourrait 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 traité 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` 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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.