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

# Application d'exemple : messages in-app

> Comment l'application d'exemple Clean Beans utilise les déclencheurs de messages in-app et le HTML personnalisé pour l'aide, une pré-invite d'autorisation et des invites de mise à jour et d'avis.

Cette page fait partie de [Application d'exemple : une intégration OneSignal complète](https://documentation.onesignal.com/docs/fr/example-full-integration-overview.md), qui suit une application réelle de bout en bout. L'application s'appelle **Clean Beans**, un planning de ménage pour les logements partagés, construite avec Expo (React Native) et un backend Supabase.

Les messages in-app s'affichent pendant qu'une personne utilise l'application. Leur contenu, leur audience et leur planification se trouvent dans le tableau de bord OneSignal, ils peuvent donc changer sans nouvelle version. Clean Beans les utilise pour cinq tâches.

| Message | Affiché quand | Comment il est ciblé |
| - | - | - |
| Superpositions d'aide | L'utilisateur appuie sur le bouton d'aide d'un écran | Un déclencheur défini par l'application |
| Visites guidées | L'utilisateur a besoin d'une visite guidée d'un écran | Le même déclencheur |
| Pré-invite d'autorisation push | Avant la boîte de dialogue d'autorisation système | Audience et planification dans le tableau de bord |
| Invite de mise à jour de l'application | L'utilisateur utilise une ancienne version | Un segment |
| Demande d'avis | L'utilisateur atteint un palier de série | Un déclencheur défini par l'application |

## Déclencheurs : laisser l'application choisir le moment \\

Un déclencheur est une clé et une valeur définies par l'application. Tout message in-app configuré pour y correspondre est affiché. Chaque écran de Clean Beans comporte dans son en-tête un bouton d'aide qui définit un déclencheur, avec le nom de l'écran comme valeur.

```typescript src/components/HelpButton.tsx theme={null}
export function HelpButton({ triggerValue }: HelpButtonProps) {
  const handlePress = () => {
    OneSignal.InAppMessages.addTrigger('help_topic', triggerValue);
  };

  return (
    <TouchableOpacity onPress={handlePress} style={styles.button} hitSlop={8}>
      <Ionicons name="help-circle-outline" size={26} color={Colors.white} />
    </TouchableOpacity>
  );
}
```

```typescript app/(tabs)/_layout.tsx theme={null}
<Tabs.Screen
  name="index"
  options={{
    title: 'Dashboard',
    headerRight: () => <HeaderRight helpTopic="dashboard" />,
    tabBarIcon: ({ focused }) => <TabIcon name={focused ? 'home' : 'home-outline'} focused={focused} />,
  }}
/>
```

Une seule clé de déclencheur sert treize écrans. Ajouter de l'aide pour un nouvel écran consiste à ajouter un bouton avec une nouvelle valeur et à créer un message dans le tableau de bord.

![Un message in-app de superposition d'aide affiché par-dessus le tableau de bord](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-help.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=521ce92f66d1df24e99790600813523a)

Appuyer sur le bouton d'aide du tableau de bord affiche une superposition d'aide.

**Configuration du tableau de bord.** Dans **Messages > In-App**, créez un message dont le déclencheur est `help_topic` **is** `dashboard`, et répétez l'opération pour chaque écran. Les visites guidées en plusieurs étapes utilisent le même déclencheur avec une mise en page en carrousel.

![Un message in-app de visite guidée composé de cartes à faire défiler](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-walkthrough.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=c335375ee2bb79060e97aa945dea644e)

Une visite guidée en plusieurs étapes, construite comme un carrousel de cartes.

## Messages en HTML personnalisé \\

Les superpositions d'aide sont écrites en HTML, elles correspondent donc exactement au design de l'application. Un message in-app HTML communique avec le SDK via l'objet `OneSignalIamApi`. Deux règles s'appliquent à chaque élément cliquable :

* Donnez-lui un `data-onesignal-unique-label` unique, afin que les clics soient correctement suivis.
* Associez-lui un écouteur qui appelle une méthode `OneSignalIamApi`. Les liens simples ne sont pas suivis.

```html docs/iam-html/help-dashboard.html theme={null}
<button id="got-it" class="cta-btn" data-onesignal-unique-label="dashboard-got-it">Got it</button>

<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("got-it").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

## Pré-invite d'autorisation push \\

La boîte de dialogue d'autorisation système ne peut être affichée qu'une seule fois. Un message in-app affiché avant peut expliquer ce que l'utilisateur va recevoir, et seules les personnes qui appuient sur **Enable notifications** voient la boîte de dialogue système.

![Un message in-app expliquant les avantages de l'activation des notifications](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-push-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=18791e9af52a803d41048eba393109f6)

Une pré-invite explique l'intérêt avant l'apparition de la boîte de dialogue système.

```html docs/iam-html/push-permission-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("enable-btn").addEventListener("click", function (e) {
      OneSignalIamApi.triggerPushPrompt(e);
    });
    document.getElementById("skip-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

> [!NOTE]
>
> Si vous utilisez une pré-invite, retirez l'appel à `requestPermission()` du démarrage de l'application. Sinon, la boîte de dialogue système apparaît en premier et la pré-invite n'a plus rien à demander.

## Invite de mise à jour de l'application \\

Lorsqu'une nouvelle version est publiée, les utilisateurs de l'ancienne voient une invite à mettre à jour. Ce message ne nécessite aucun code dans l'application. Son audience est un segment d'utilisateurs disposant d'une version plus ancienne de l'application.

![Un message in-app demandant à l'utilisateur de mettre à jour l'application](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-iam-app-version.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=f096ce85f566823331171e14312e534d)

L'invite de mise à jour, affichée uniquement aux utilisateurs d'une version plus ancienne.

Un seul message sert les deux plateformes. Le script choisit le store selon l'appareil, et `openUrl` suit le clic, ouvre le store et ferme le message.

```html docs/iam-html/app-update-prompt.html theme={null}
<script>
  var IOS_URL = "https://apps.apple.com/app/id" + IOS_APP_STORE_ID;
  var ANDROID_URL = "https://play.google.com/store/apps/details?id=" + ANDROID_PACKAGE;

  // One message serves both platforms: pick the store from the device.
  var isAndroid = /android/i.test(navigator.userAgent);
  var storeUrl = isAndroid ? ANDROID_URL : IOS_URL;

  document.addEventListener("DOMContentLoaded", function () {
    document.getElementById("update-btn").addEventListener("click", function (e) {
      // openUrl tracks the click, opens the store and closes the message
      OneSignalIamApi.openUrl(e, storeUrl);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

La salutation utilise un tag, avec une valeur de repli pour les utilisateurs qui n'en ont pas.

```html docs/iam-html/app-update-prompt.html theme={null}
<p>Hey {{ user_name | default: "there" }}, you're on an older version</p>
```

**Configuration du tableau de bord.** Créez un segment avec le filtre **App version** inférieur à votre version actuelle et utilisez-le comme audience du message. Mettez le filtre à jour à chaque nouvelle version.

> [!NOTE]
>
> La substitution de tags fonctionne dans le texte et les attributs d'un message in-app HTML, mais pas à l'intérieur des balises `script`.

## Demande d'avis : renvoyer un clic à l'application \\

Un bon moment pour demander une note sur le store est juste après une réussite. Clean Beans le demande lorsqu'une session de ménage porte une série à un multiple de sept jours.

C'est le seul message in-app où un appui doit exécuter du code dans l'application, car la fenêtre de notation native ne peut être ouverte que par l'application elle-même.

**1. L'application définit un déclencheur à un palier de série**

Elle attend que l'écran de session soit fermé, pour que l'invite n'interrompe jamais le ménage, et mémorise le dernier palier auquel elle a posé la question.

```typescript src/lib/reviewPrompt.ts theme={null}
export async function maybeAskForReview(streak: number): Promise<void> {
  try {
    if (streak <= 0 || streak % STREAK_MILESTONE_DAYS !== 0) return;

    // A second session on the same day leaves the streak unchanged —
    // don't ask twice for the same milestone.
    const lastPrompted = await AsyncStorage.getItem(LAST_PROMPTED_STREAK_KEY);
    if (lastPrompted === String(streak)) return;
    await AsyncStorage.setItem(LAST_PROMPTED_STREAK_KEY, String(streak));

    OneSignal.InAppMessages.addTrigger(REVIEW_TRIGGER_KEY, REVIEW_TRIGGER_VALUE);
    console.log('[reviewPrompt] Trigger set at streak', streak);
  } catch (e) {
    console.warn('[reviewPrompt] maybeAskForReview error:', e);
  }
}
```

**2. Le message renvoie un nom de clic à l'application**

`addClickName` transmet un nom à l'écouteur de clic de l'application. Il ne ferme pas le message, le script le ferme donc ensuite.

```html docs/iam-html/review-prompt.html theme={null}
<script>
  document.addEventListener("DOMContentLoaded", function () {
    var autoCloseBtn = document.getElementById("auto-close-btn");

    document.getElementById("rate-btn").addEventListener("click", function (e) {
      // Passes the click name "review" to the app's In-App Message click
      // listener, which opens the native rating sheet. addClickName does not
      // close the message, so close it straight afterwards.
      OneSignalIamApi.addClickName(e, "review");
      setTimeout(function () { autoCloseBtn.click(); }, 300);
    });
    autoCloseBtn.addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
    document.getElementById("later-btn").addEventListener("click", function (e) {
      OneSignalIamApi.close(e);
    });
  });
</script>
```

**3. L'application ouvre la fenêtre de notation native**

L'écouteur de clic vérifie le nom et demande au système d'afficher la fenêtre.

```typescript src/lib/reviewPrompt.ts theme={null}
export function handleReviewClick(event: InAppMessageClickEvent): void {
  if (event.result.actionId !== REVIEW_ACTION_ID) return;

  // Give the In-App Message a moment to close before presenting the sheet
  setTimeout(async () => {
    try {
      // false on TestFlight builds and on the web
      if (await StoreReview.isAvailableAsync()) {
        await StoreReview.requestReview();
      } else {
        console.log('[reviewPrompt] Store review not available on this build');
      }
    } catch (e) {
      console.warn('[reviewPrompt] requestReview error:', e);
    } finally {
      // Clear the trigger so the message is not re-evaluated this app session
      OneSignal.InAppMessages.removeTrigger(REVIEW_TRIGGER_KEY);
    }
  }, 800);
}
```

```typescript app/_layout.tsx theme={null}
OneSignal.InAppMessages.addEventListener('click', handleReviewClick);
```

![Un message in-app de demande d'avis](https://mintcdn.com/onesignal/XdN288-p34EfpfHk/images/tutorials/cleanbeans-review-prompt.png?fit=max\&auto=format\&n=XdN288-p34EfpfHk\&q=85\&s=90dde058450240f49d42e76402ed28ce)

Le message in-app de demande d'avis.

**Configuration du tableau de bord.** Créez un message in-app HTML avec le déclencheur `ask_for_review` **is** `show`. Planifiez-le pour qu'il s'affiche au maximum une fois toutes les 17 semaines.

> [!WARNING]
>
> Apple affiche sa fenêtre de notation au maximum trois fois par utilisateur et par an, et Google applique sa propre limite, un appui sur le bouton ne garantit donc pas que quelque chose s'affiche. La fenêtre n'apparaît jamais dans les compilations TestFlight. Testez ce parcours avec une compilation App Store.

> [card] [Déclencheurs in-app](https://documentation.onesignal.com/docs/fr/iam-triggers.md)
>
> Types de déclencheurs et façon de les combiner.

> [card] [Messages in-app HTML](https://documentation.onesignal.com/docs/fr/design-your-in-app-message-with-html.md)
>
> Concevez des messages avec votre propre HTML.

> [card] [API JavaScript in-app](https://documentation.onesignal.com/docs/fr/in-app-message-api.md)
>
> Toutes les méthodes `OneSignalIamApi`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.