# Création de nouvelles applications utilisateur
Lors de la configuration d’une nouvelle **application utilisateur**, vous travaillerez avec plusieurs configurations clés qui déterminent la manière dont votre application externe s’intègre à la plateforme. Examinons chaque composant essentiel.
Commencez par cliquer sur la dans la **Applications utilisateur** liste. Dans le formulaire de configuration qui s’affiche, procédez comme suit :
{% stepper %}
{% step %}
**Configurez l’URL**
Spécifiez l’URL de votre application — l’adresse à laquelle votre application est hébergée ; elle sert de base à l’intégration.
{% hint style="danger" %}
* Assurez-vous que l’URL est valide, utilise une connexion HTTPS, mène vers une ressource fiable et ne contient pas plus de 1 000 caractères.
* Assurez-vous que l’application a le paramètre iFrame activé de son côté ; sinon, vous ne pourrez pas l’ouvrir dans l’interface de la plateforme.
{% endhint %}
{% endstep %}
{% step %}
**Configurer les paramètres de base**
Pour personnaliser votre application, vous pouvez inclure différents paramètres dans l’URL. Vous pouvez ajouter manuellement des paramètres dans le champ d’URL ou utiliser l’une de nos suggestions : langue, ID utilisateur ou fuseau horaire. Cliquez sur une suggestion de paramètre pour l’ajouter à la fin de l’URL. Développez la description ci-dessous pour en savoir plus sur les paramètres suggérés et les exemples.
Comprendre les paramètres d’URL suggérés
Nous suggérons quelques paramètres de base pour la personnalisation
1. `?locale={locale_code}`\
Paramètre de langue qui correspond automatiquement à la langue de la plateforme de l’utilisateur.
* Exemple : `https://your-app.com/dashboard?locale=en`
2. `?user_id={user_identifier}`\
Paramètre de contexte utilisateur qui transmet l’identité de l’utilisateur afin de filtrer les informations personnalisées.
* Exemple : `https://your-app.com/dashboard?user_id=12345`
3. `?timezone={timezone}`\
Paramètre horaire qui correspond automatiquement au fuseau horaire de la plateforme de l’utilisateur.
* Exemple : `https://your-app.com/dashboard?timezone=UTC+1`
Vous pouvez modifier le nom du paramètre suggéré ou lui spécifier une certaine valeur.
{% hint style="info" %}
Testez votre configuration pour vous assurer que l’application se charge correctement. Cliquez sur pour afficher un aperçu.
{% endhint %}
{% endstep %}
{% step %}
**Ajuster l’apparence**
Créez une identité reconnaissable pour votre application afin de la rendre facile à trouver. Les paramètres suivants vous y aideront :
* **Libellé** – Ajoutez un nom unique et descriptif pour votre application (jusqu’à 24 caractères). Il s’affichera dans la barre latérale de la plateforme.
* **Description** – Ajoutez une brève explication avec des détails sur les fonctionnalités de l’application ou mettez en avant des informations importantes (jusqu’à 50 caractères). Une description informative aidera vos utilisateurs à mieux comprendre l’objectif de l’application.
* **Icône** – Sélectionnez une icône qui représente la fonction de votre application pour une navigation encore plus native.
{% endstep %}
{% step %}
**Sélectionner le mode d’affichage**
Décidez comment votre application s’ouvrira en choisissant l’une des deux options dans la liste déroulante **Ouvrir dans** :
* **Intégré** – L’application s’affiche dans l’interface de la plateforme
* **Nouvel onglet** – L’application s’ouvre dans un onglet de navigateur séparé
{% hint style="info" %}
Notre plateforme utilise iFrame pour l’intégration. Comme toutes les URL ne peuvent pas être traitées avec succès à l’aide de cette technologie, veillez à prévisualiser le résultat de l’intégration. Si vous rencontrez des problèmes avec ce mode d’affichage, veuillez envisager d’utiliser **Nouvel onglet**.
{% endhint %}
{% endstep %}
{% step %}
**Configurer l’authentification (facultatif)**
Configurez l’authentification si votre application s’appuie sur l’API de la plateforme. Dans ce cas, la plateforme fournira directement les données d’authentification à l’application lorsqu’elle sera ouverte, ce qui évite d’avoir à implémenter une fonctionnalité de connexion supplémentaire côté application.\
Vous pouvez choisir l’une des deux méthodes d’authentification :
* **Clé API**
* Cette méthode est destinée aux applications pour lesquelles la gestion des rôles ou des autorisations utilisateur n’est pas requise.
* La clé API correspond au niveau d’accès du propriétaire du compte. Cela signifie que fournir une clé API à un utilisateur standard peut lui donner accès à **toutes les données** disponibles pour l’utilisateur principal.\
Par exemple, si votre application fonctionne avec des traceurs auxquels un utilisateur dispose de droits limités ou d’aucun accès, l’utilisation de la clé API exposera néanmoins tous les traceurs du compte principal.
* **Clé de session**
* Cette méthode est recommandée lorsqu’une gestion des rôles est impliquée.
* Transmet la clé de session utilisateur actuelle à l’application.
{% hint style="info" %}
La sélection de la **Clé API** méthode désactivera automatiquement la **Clé de session** méthode, et vice versa. Une seule méthode peut être utilisée à la fois.
{% endhint %}
Lorsque l’authentification est activée, la plateforme ajoute le `?session_key=` paramètre à l’URL de votre application.
* Si vous avez sélectionné une **Clé API**, la valeur du paramètre contiendra cette clé.
* Si vous avez opté pour une **Clé de session**, la valeur du paramètre inclura la clé de la session utilisateur actuelle depuis laquelle l’application est accessible.
Assurez-vous que l’application est capable de lire et d’utiliser ce paramètre.
{% endstep %}
{% step %}
**Enregistrer la nouvelle application**
Cliquez sur le **Enregistrer** bouton. Votre application apparaîtra dans la **Applications utilisateur** liste et dans la barre latérale de la plateforme. Les applications activées deviennent automatiquement disponibles pour les utilisateurs du compte.
{% endstep %}
{% endstepper %}
Exemple d’affichage d’une application utilisateur intégrée
Conseils rapides de dépannage
Si votre application ne s’affiche pas correctement lorsqu’elle est intégrée, essayez :
* de l’ouvrir plutôt dans un nouvel onglet
* de vérifier que votre URL est correcte et accessible
* de vérifier que tous les paramètres sont correctement formatés
Les applications créées restent entièrement configurables après leur enregistrement. Vous pouvez ajuster leurs paramètres et leur apparence à tout moment. Pour en savoir plus sur la gestion des applications, consultez [Gérer les applications utilisateur existantes](/docs/user/fr/guide/account/user-applications/managing-existing-user-applications.md).
---
# Agent Instructions: 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:
```
GET https://navixy.com/docs/user/fr/guide/account/user-applications/creating-new-user-applications.md?ask=
```
The question should be specific, self-contained, and written in natural language.
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.