> For the complete documentation index, see [llms.txt](https://docs.thewalletcrew.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.thewalletcrew.io/guides-scan/fr/scanner/pass-scanner/pass-scanner-profiles.md).

# les profils de Carte Scanner

Créez des profils Carte Scanner : des contextes de scan réutilisables qui déterminent quels avantages un appareil accepte, si le personnel peut ajouter des tampons et quand le profil est ouvert.

Un profil est un contexte de scan réutilisable, par exemple « Bar », « Petit-déjeuner », « Vestiaire » ou « Porte F ». Il indique à Scanner de cartes quels avantages accepter, si le personnel peut ajouter des tampons, pendant combien de temps ignorer un second scan de la même carte et quand le profil peut être utilisé. Les profils sont créés une fois, puis attribués au nombre d’appareils nécessaire.

Les profils aident le personnel à rester concentré et évitent les erreurs.

<details>

<summary><strong>Exemples concrets</strong></summary>

* **Bar du festival :** un profil « Bar » n’accepte que les avantages marqués `boissons`, avec un blocage de re-scan de 5 secondes pour éviter une double utilisation.
* **Petit-déjeuner à l’hôtel :** un profil « Petit-déjeuner » accepte le modèle d’avantage « Petit-déjeuner inclus » et s’ouvre tous les jours à 7:00 pendant 210 minutes.
* **Comptoir du café :** un profil « Comptoir » accepte les avantages marqués `membre` ou `récompense` ainsi que le « pack atelier barista » et permet au personnel d’ajouter des tampons aux cartes à tampons.
* **Ateliers du café :** un profil « Ateliers du samedi » n’accepte que le « pack atelier barista » et s’ouvre tous les samedis à 9:00 pendant 120 minutes.
* **Portes du stade :** un profil « Porte F » n’est valide que les jours de match, de sa **date de début de validité** à sa **date de fin de validité** .
* **Boutique éphémère :** un profil « Semaine de lancement » n’accepte le modèle de cadeau de lancement que pendant la semaine d’ouverture.

</details>

## Fonctionnement des profils

Chaque appareil peut exécuter un ou plusieurs profils. Lorsqu’un appareil en a plusieurs, le personnel en choisit un dans Scanner de cartes depuis **Choisir un profil**, ce qui démarre une **session**. Un profil en dehors de ses fenêtres d’ouverture s’affiche comme **Fermé actuellement**.

```mermaid
flowchart LR
    P1["Profil : Bar<br/>étiquettes : boissons"] --> D1["Appareil : téléphone du bar"]
    P2["Profil : Comptoir<br/>tampons autorisés"] --> D2["Appareil : téléphone du comptoir"]
    P2 --> D3["Appareil : téléphone de secours"]
    P3["Profil : Petit-déjeuner<br/>7:00, 210 min"] --> D3
    D3 -->|le personnel en choisit un| S["Session"]
```

Le téléphone applique le profil : il filtre les avantages affichés après un scan. Un appareil sans profil accepte tous les avantages avec **Afficher dans Scanner de cartes** activé.

## Créer un profil

Les profils se gèrent depuis **Paramètres → Contrôle d’accès → Profils d’appareils**. La liste affiche le nom de chaque profil, son planning et ce qu’il accepte.

<figure><img src="https://3625829848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiqBD4M0nHFMaFeKR75p9%2Fuploads%2Fgit-blob-a7a1ab633668eabc98d81266044426358f8af749%2Fdevice-profiles-list-single-frame.png?alt=media" alt="The Device profiles list shows each profile&#x27;s schedule and what it accepts, here the loyalty and reward tags."><figcaption><p>La liste des profils d’appareils affiche le planning de chaque profil et ce qu’il accepte : étiquettes, modèles d’avantages et tampons.</p></figcaption></figure>

{% stepper %}
{% step %}

### Ouvrir l’éditeur

Ouvrir **Paramètres → Contrôle d’accès → Profils d’appareils**, puis cliquez sur **Ajouter**.

<p align="center"><a href="https://admin.thewalletcrew.io/tenant/~/settings/access/device-profiles" class="button secondary" data-icon="chevrons-right">Ouvrez Profils d’appareils dans la console d’administration</a></p>
{% endstep %}

{% step %}

### Identifiez-le

Donnez au profil un **nom**, une **description facultative**, ainsi qu’une icône et une couleur que le personnel reconnaîtra sur le téléphone.
{% endstep %}

{% step %}

### Choisissez ce qu’il accepte

Dans **Filtre d’avantages**, sélectionnez les étiquettes et les modèles d’avantages que le profil accepte. Laissez les deux vides pour accepter tous les avantages.
{% endstep %}

{% step %}

### Définissez les tampons, le blocage de re-scan et le planning

Décidez si le personnel peut ajouter des tampons, pendant combien de temps un second scan de la même carte est ignoré, et quand le profil est ouvert.
{% endstep %}

{% step %}

### Enregistrez-le et attribuez-le

Cliquez sur **Enregistrer**, puis ajoutez le profil aux appareils depuis leur **Profils** carte dans [Gérer les appareils](https://docs.thewalletcrew.io/guides-scan/fr/scanner/pass-scanner/manage-devices.md).
{% endstep %}
{% endstepper %}

<figure><img src="https://3625829848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiqBD4M0nHFMaFeKR75p9%2Fuploads%2Fgit-blob-4bf5df3b2a41f6a2d9aac47b7714033ff0c48c88%2Fdevice-profile-benefit-filter-retake.png?alt=media" alt="Benefit filter of a new device profile with the loyalty and reward tags selected, and the benefit templates they cover"><figcaption><p>Le profil Comptoir accepte les avantages marqués fidélité ou récompense.</p></figcaption></figure>

### Identité

| Paramètre                   | description facultative                                                                                              |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **nom**                     | Obligatoire, jusqu’à 200 caractères. Affiché au personnel lorsqu’il choisit un profil.                               |
| **description facultative** | Facultatif, jusqu’à 500 caractères.                                                                                  |
| **Icône et couleur**        | Un emoji et une couleur affichés sur le téléphone, afin que le personnel voie d’un coup d’œil quel profil est actif. |

### Filtre d’avantages

Le filtre d’avantages détermine quels avantages Scanner de cartes propose après un scan. Un avantage est accepté lorsqu’il porte l’une des **étiquettes** ou provient de l’un des **modèles d’avantages**. Lorsque rien n’est sélectionné, le profil accepte tous les avantages.

Un modèle d’avantage déjà couvert par une étiquette sélectionnée est coché et grisé avec **via #étiquette**, par exemple **via #récompense**, afin que l’éditeur affiche la liste complète de ce que le profil accepte. La liste des profils résume cela dans sa **Accepte** colonne, avec **Tampons** quand le personnel peut ajouter des tampons.

Seuls les modèles d’avantages **Afficher dans Scanner de cartes** dont l’option est activée sont listés. Un profil peut sélectionner jusqu’à 50 étiquettes et 200 modèles d’avantages. Les étiquettes sont définies sur [les modèles d’avantages](https://docs.thewalletcrew.io/guides-animation/fr/engage-and-animate/benefit-templates.md), ce qui en fait le moyen le plus simple de construire un filtre qui continue de fonctionner lorsque de nouveaux modèles sont ajoutés : marquez chaque avantage boisson `boissons`, et le profil « Bar » accepte automatiquement les nouveaux avantages boisson.

{% hint style="info" %}
Lorsqu’un modèle d’avantage sélectionné est supprimé, le profil affiche **À revoir**. Le modèle manquant est retiré du filtre et supprimé lors de l’enregistrement du profil. S’il ne reste rien dans le filtre, le profil accepte tous les avantages.
{% endhint %}

{% hint style="info" %}
**Les modèles d’avantages sont en bêta.** Activer **Fonctionnalités bêta** dans le menu du profil, en haut à droite de la console d’administration, pour voir **Engagement → Modèles d’avantages**.
{% endhint %}

### Carte à tampons

**Le personnel peut ajouter des tampons** permet au personnel d’ajouter un tampon lorsqu’il scanne une [carte à tampons](https://docs.thewalletcrew.io/guides-design/fr/conception/stamp-card.md). C’est désactivé par défaut : lorsqu’il est désactivé, le scan d’une carte à tampons ne fait que l’afficher.

### Blocage de re-scan

**Blocage de re-scan (secondes)**, sous **Paramètres avancés**, correspond à la durée pendant laquelle l’appareil ignore un second scan de la même carte, entre 0 et 3 600 secondes, 5 par défaut. Cela empêche un avantage ou un tampon d’être utilisé deux fois lorsqu’une carte reste devant la caméra. Réglez-la sur 0 pour désactiver le blocage.

### Planning

Le planning limite les moments où le profil peut être utilisé.

| Paramètre                                                  | description facultative                                                                                                                                                                                |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **date de début de validité**, **date de fin de validité** | Dates facultatives en dehors desquelles le profil ne peut pas fonctionner.                                                                                                                             |
| **Fenêtres d’ouverture**                                   | Jusqu’à 20 fenêtres. Chaque fenêtre s’ouvre à l’heure définie et reste ouverte pendant sa durée, de 1 à 1 440 minutes. Sans fenêtre, le profil est ouvert en permanence pendant ses dates de validité. |

Chaque fenêtre d’ouverture se répète **Chaque** année, mois, semaine, jour, heure ou minute, à l’heure choisie, et reste ouverte pendant sa **Durée (minutes)**. Une fenêtre hebdomadaire peut être limitée à certains jours de la semaine. L’éditeur résume chaque fenêtre en toutes lettres, par exemple « À 09:00, uniquement le samedi · 2 h ». Les fenêtres d’ouverture sont évaluées dans l’ **heure locale du téléphone**, et non dans le fuseau horaire de la console d’administration : une fenêtre configurée pour s’ouvrir à 7:00 s’ouvre à 7:00 là où se trouve le téléphone.

<figure><img src="https://3625829848-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiqBD4M0nHFMaFeKR75p9%2Fuploads%2Fgit-blob-be4fe03c43dc6b6d74f77f8808ad03a2817a2840%2Fdevice-profile-schedule-window-retake.png?alt=media" alt="Schedule card with the validity dates and one opening window every day at 9:00 for 120 minutes"><figcaption><p>La carte Planning contient les dates de validité et les fenêtres d’ouverture.</p></figcaption></figure>

Lorsque le planning se termine pendant une session, la session est fermée avec le motif de fin **Fin du planning du profil**.

## Modifier ou supprimer un profil

La modification d’un profil met à jour tous les appareils qui l’utilisent : les téléphones connectés appliquent la modification en quelques secondes, et les autres téléphones lors de leur prochaine connexion. Un profil ne peut pas être supprimé tant qu’un appareil le répertorie encore ; retirez-le d’abord de ces appareils.


---

# 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://docs.thewalletcrew.io/guides-scan/fr/scanner/pass-scanner/pass-scanner-profiles.md?ask=<question>&goal=<user_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.
