> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistant d'intégration de première utilisation

> L'assistant en 4 étapes affiché aux nouveaux propriétaires de compte sur /onboarding.

La première fois qu'un nouveau propriétaire de compte se connecte, Scanova le redirige vers un assistant en 4 étapes sur `/onboarding` avant qu'il ne voie le tableau de bord principal — son objectif entier est de faire créer un QR code avant de vous laisser explorer par vous-même.

<Note>
  Le déclencheur de redirection de cette page (`first_login`) est propre au compte et n'est jamais vrai qu'une seule fois, il n'a donc pas pu être redéclenché en direct sur le compte de test partagé utilisé pour vérifier le reste de ce projet de documentation — ce compte avait déjà terminé sa première connexion bien avant la rédaction de cette page. Chaque étape ci-dessous **a été vérifiée en direct** en naviguant directement vers `/onboarding` (la route elle-même n'a pas de restriction supplémentaire au-delà d'être connecté) et en complétant le flux du début à la fin ; seul le comportement automatique de redirection à la première connexion lui-même est documenté à partir du code source plutôt qu'observé.
</Note>

## Qui voit ceci, et pourquoi

Selon la propre logique de routage de l'application (`lib/next-path.ts`), l'assistant ne s'applique qu'à un véritable nouveau **propriétaire de compte** — un coéquipier acceptant une invitation d'utilisateur partagé déclenche le même indicateur `first_login` sous-jacent lors de sa première connexion également, mais en est délibérément exempté, puisque l'assistant suppose des permissions (comme créer un QR code) qu'un rôle Viewer ou un autre rôle restreint peut ne pas avoir. Un coéquipier nouvellement invité va directement au tableau de bord à la place.

Si la finalisation du profil est encore en attente, cette restriction est prioritaire — l'assistant n'apparaît qu'une fois votre profil complété.

## Étape 1 — Choose

L'assistant s'ouvre sur un accueil personnalisé (« Welcome, \{name}! Let's create your first QR Code. ») avec trois points de départ, correspondant aux mêmes trois options disponibles partout ailleurs dans l'application (voir [Quick Code vs. full Page](/fr/qr-codes/create/quick-code-vs-page)) :

<Frame caption="Étape 1 de l'assistant d'intégration — choix d'un point de départ">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/onboarding/first-run-wizard/step1-choose.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=fd0d71b0f36b990978ca94341d8e51e8" alt="Étape 1 de l'assistant d'intégration, Choose, affichant le titre « Welcome, Docs! Let's create your first QR Code. » et trois cartes : Quick Code (Website URL), Choose a Template (labellisée Popular), et Build with AI (labellisée AI-Powered)" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step1-choose.png" />
</Frame>

* **Quick Code** — un QR code à action directe, par exemple **Website URL**.
* **Choose a Template** (labellisée **Popular**) — une mise en page préconçue (Business Card, Custom Page, et plus).
* **Build with AI** (labellisée **AI-Powered**) — décrivez ce dont vous avez besoin et laissez l'IA générer le contenu de la page.

Un indicateur de progression en haut (**1 Choose → 2 Create → 3 Configure → 4 Design & Finish**) suit votre position tout au long, et un lien **Visit Dashboard** en haut à droite vous permet de quitter l'assistant entièrement à tout moment.

## Étape 2 — Create

Sélectionner un point de départ ouvre son formulaire de création spécifique au type. Pour **Website URL** (le chemin vérifié ici), il s'agit d'un champ unique demandant l'URL de destination, avec un aperçu de QR code en direct s'affichant à droite au fur et à mesure que vous tapez :

<Frame caption="Étape 2 — saisie d'une URL de site web, avec un aperçu de QR code en direct">
  <img src="https://mintcdn.com/scanova-api/2FTGGTqcp1qRUtvm/images/v2/onboarding/first-run-wizard/step2-create.png?fit=max&auto=format&n=2FTGGTqcp1qRUtvm&q=85&s=39d08acb3a164935a70f07de6bafadbe" alt="Étape 2 de l'assistant d'intégration, Create, affichant un formulaire « Enter your website URL » avec un champ de saisie préfixé par https:// et un panneau d'aperçu de QR code en direct" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step2-create.png" />
</Frame>

## Étape 3 — Configure

Ensuite, nommez le QR code et choisissez son URL courte :

<Frame caption="Étape 3 — nommage du QR code et configuration de son URL courte">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/onboarding/first-run-wizard/step3-configure.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=83f996279c5c85babc274f2ed9f0fd0f" alt="Étape 3 de l'assistant d'intégration, Configure, affichant un champ QR Code name par défaut sur « My QR Code », un sélecteur de domaine Short URL réglé sur scnv.io avec un slug généré automatiquement et une option Customize, un interrupteur de suivi de localisation GPS, et un bouton Create QR Code" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step3-configure.png" />
</Frame>

* **QR Code name** — par défaut « My QR Code » si laissé vide.
* **Short URL** — par défaut `scnv.io` avec un slug généré automatiquement ; sélectionnez **Customize** pour choisir le vôtre.
* **GPS location tracking** — un interrupteur facultatif pour collecter la localisation précise du scan (nécessite la permission du visiteur au moment du scan).

Sélectionner **Create QR Code** affiche brièvement un état « Generating your QR Code… », puis avance à l'étape finale.

## Étape 4 — Design & Finish

La dernière étape confirme le succès avec une animation de confettis festive et votre QR code fini, prêt à scanner :

<Frame caption="Étape 4 — le QR code fini, prêt à tester, télécharger, ou personnaliser">
  <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/onboarding/first-run-wizard/step4-design-finish.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=71d528ac836ea23c06ab8558e9447cd6" alt="Étape 4 de l'assistant d'intégration, Design and Finish, affichant une animation de confettis, le titre « Congratulations, [name]! Your QR Code is ready. », un sélecteur de design facultatif, une véritable image de QR code, des boutons Test your QR et Download QR, et un bouton Continue to plans" width="1440" height="900" data-path="images/v2/onboarding/first-run-wizard/step4-design-finish.png" />
</Frame>

À partir de là :

* **Choose a design (optional)** — appliquez un style visuel avant de télécharger.
* **Test your QR** — ouvre la destination dans un nouvel onglet, de la même façon qu'un scan le ferait.
* **Download QR** — télécharge l'image du QR code.
* **Continue to plans** — l'action finale, qui vous fait entrer dans l'application principale (une note à l'écran vous rappelle que le design peut aussi être changé plus tard depuis le tableau de bord).

## Voir aussi

* [Quick Code vs. full Page](/fr/qr-codes/create/quick-code-vs-page) — les mêmes trois points de départ, disponibles à tout moment depuis `/qr/create`, pas seulement pendant l'intégration.
* [Classic to New UI](/fr/onboarding/classic-to-new-ui) — une décision distincte, unique, au niveau du compte, sans rapport avec cet assistant.
