> ## 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 : Journeys

> Les sept Journeys de l'application d'exemple Clean Beans : onboarding, séries, réengagement, promotions et un webhook de Journey qui appelle le backend.

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 colocations, construite avec Expo (React Native) et un backend Supabase.

La plupart des messages de ce guide sont envoyés par le backend, une requête à la fois. Un **Journey** est différent. C'est une séquence construite dans le tableau de bord OneSignal qui décide elle-même à qui envoyer des messages, quand, et ce qui se passe ensuite. Clean Beans utilise des Journeys pour tout ce qui se déroule sur plusieurs heures ou jours, et pour les textes et horaires qui doivent pouvoir changer sans nouvelle version.

Clean Beans exécute sept Journeys.

| Journey | Démarre quand | Ce qu'il fait |
| - | - | - |
| [Onboarding](#onboarding-a-sequence-with-a-goal) | L'application envoie `signed_up` | E-mail de bienvenue et visite guidée in-app, puis trois push sur six jours, jusqu'à la première session de ménage |
| [Rappel de session](#session-reminder-start-on-one-event-cancel-on-another) | L'application envoie `cleaning_session_started` | Un push trois heures plus tard, sauf si la session a été terminée |
| [Session terminée](#session-completed-personalize-from-the-event) | L'application envoie `cleaning_session_completed` | Un push à la personne qui a fait le ménage, avec le nom de la pièce qu'elle vient de nettoyer |
| [Promotions par pièce](#room-based-promos-branch-on-an-event-property) | Un membre récemment actif termine une session | Un push différent pour une cuisine, une salle de bain ou une chambre, deux heures plus tard |
| [Palier de série](#streak-milestone-an-event-with-a-number) | L'application envoie `streak_milestone` | Un push qui célèbre 3, 7, 14, 30 jours et plus |
| [Série sur le point de se rompre](#streak-about-to-break-timing-a-segment-check-and-varied-copy) | L'application envoie `cleaning_session_completed` | Un push d'avertissement le lendemain soir, avec l'une de cinq formulations |
| [Réengagement](#re-engagement-and-the-journey-webhook) | Un membre est inactif depuis sept jours | Push, push, e-mail, push sur dix jours, puis un webhook vers le backend |

Aucun d'eux n'a de code backend propre, à part le webhook à la fin du dernier. Le rôle de l'application est de donner aux Journeys de quoi travailler.

## Ce que l'application donne à un Journey pour travailler \\

Un Journey peut voir trois choses sur une personne : les **événements personnalisés** qu'elle a envoyés, ses **tags** et les **segments** auxquels elle appartient. Il ne peut pas lire votre base de données. Tout ce à quoi un Journey doit réagir doit arriver sous l'une de ces formes.

| Signal | Type | Envoyé quand | Utilisé par |
| - | - | - | - |
| `signed_up` | Événement personnalisé | Un nouveau compte se connecte pour la première fois | Onboarding (entrée) |
| `cleaning_session_started` | Événement personnalisé | Une session de ménage commence | Rappel de session (entrée) |
| `cleaning_session_completed` | Événement personnalisé, avec `room_name` | Une session de ménage se termine | Session terminée, Promotions par pièce, Série sur le point de se rompre (entrée). Onboarding, Rappel de session, Réengagement (sortie) |
| `streak_milestone` | Événement personnalisé, avec `streak_count` | Une session fait atteindre un palier à la série | Palier de série (entrée) |
| `user_name`, `household_name`, `streak_count` | Tags | Connexion, fin de session, modification du profil | Personnaliser le texte des messages |
| `streak_reminders` | Tag | Connexion, et lors de l'enregistrement des paramètres de notification | Série sur le point de se rompre (qui peut le recevoir) |

Les événements de session sont présentés dans [Tags, événements personnalisés et Conversion Metrics](https://documentation.onesignal.com/docs/fr/example-full-integration-tags-events.md). Les deux autres événements n'existent que pour démarrer un Journey.

`signed_up` se déclenche une fois par compte. L'âge du compte est vérifié d'abord, afin qu'une personne qui installe l'application sur un nouveau téléphone ne repasse pas par l'onboarding.

```typescript src/lib/onesignalSync.ts theme={null}
const accountAgeMs = Date.now() - new Date(profile.created_at).getTime();
if (accountAgeMs <= NEW_SIGN_UP_WINDOW_MS) {
  const ctx = await getEventContext();
  if (!ctx) return;

  OneSignal.User.trackEvent('signed_up', {
    external_id: ctx.external_id,
    user_name: ctx.user_name,
    household_name: ctx.household_name,
  });
  console.log('[onesignalSync] Custom event: signed_up');
}

await AsyncStorage.setItem(flagKey, '1');
```

`streak_milestone` transporte la longueur de la série sous forme de nombre, pour que le message puisse l'afficher.

```typescript src/lib/onesignalSync.ts theme={null}
OneSignal.User.trackEvent('streak_milestone', {
  external_id: ctx.external_id,
  user_name: ctx.user_name,
  household_name: ctx.household_name,
  streak_count: streak,
});
```

> [!WARNING]
>
> N'envoyez un événement qui démarre un Journey qu'après l'appel à `OneSignal.login()`. Un événement envoyé avant la connexion est enregistré pour un utilisateur anonyme, et non pour la personne sur le point de se connecter. Clean Beans appelle `trackSignedUpOnce()` juste après `login()` dans le même effect. Consultez [Configuration du SDK et identité utilisateur](https://documentation.onesignal.com/docs/fr/example-full-integration-sdk-setup.md#tie-each-device-to-a-user).

## Onboarding : une séquence avec un objectif \\

Le Journey d'onboarding a un seul but : amener un nouveau membre à sa première session de ménage. Tout s'arrête dès que cela arrive.

**1. L'application envoie signed\_up**

Le membre entre dans le Journey. Chaque membre le parcourt une fois.

**2. Un e-mail de bienvenue et une visite guidée in-app partent immédiatement**

L'e-mail liste trois étapes pour commencer. Le message in-app s'affiche la prochaine fois que le membre ouvre l'application.

**3. Trois push suivent aux jours 1, 3 et 6**

Chacun attend une fenêtre horaire de 10:00 à 19:00 dans le fuseau horaire du membre.

**4. Une session terminée y met fin**

La règle de sortie du Journey est l'événement `cleaning_session_completed`. Personne n'est relancé pour faire quelque chose qu'il a déjà fait.

| Étape | Quand | Message |
| - | - | - |
| E-mail | Immédiatement | "Welcome to Clean Beans", avec trois étapes pour commencer |
| Message in-app | Prochaine ouverture de l'application, pendant trois jours au maximum | La visite guidée de bienvenue |
| Push 1 | Jour 1 | "Ready for your first clean?" |
| Push 2 | Jour 3 | "Cleaning is easier shared" (ouvre l'écran Household) |
| Push 3 | Jour 6 | "Your rota is waiting" |

**Configuration dans le tableau de bord.** Créez le Journey avec **Custom Event** comme règle d'entrée et `signed_up` comme événement. Dans les règles de sortie, choisissez de sortir lorsqu'un événement personnalisé se produit et sélectionnez `cleaning_session_completed`. Placez une étape **Time Window** avant chaque push, pour qu'une attente qui se termine à 03:00 n'envoie pas à 03:00.

> [!TIP]
>
> Choisissez d'abord l'objectif et faites-en la règle de sortie. Une séquence sans objectif continue de s'adresser à des personnes qui ont déjà fait ce qu'elle demandait.

## Rappel de session : démarrer sur un événement, annuler sur un autre \\

Si quelqu'un commence une session de ménage sans jamais la terminer, son travail n'est pas enregistré. Ce Journey démarre sur `cleaning_session_started`, attend trois heures et envoie un rappel. Sa règle de sortie est `cleaning_session_completed`, donc terminer la session annule le rappel.

| Étape | Paramètre |
| - | - |
| Entrée | Événement personnalisé `cleaning_session_started` |
| Attente | 3 heures |
| Fenêtre horaire | De 08:00 à 21:00, fuseau horaire du membre |
| Push | "What happened? It looks like you started a cleaning session and didn't finish it." |
| Sortie | Événement personnalisé `cleaning_session_completed` |

Cette paire démarrage-annulation est le Journey utile le plus simple qui soit. La même forme convient à un panier abandonné, un formulaire d'inscription inachevé ou un brouillon jamais envoyé.

> [!NOTE]
>
> **Vérifiez la limite de la fenêtre horaire.** À l'origine, la fenêtre fermait à 18:00. Une session commencée à 16:00 atteignait la fin de son attente à 19:00, trouvait la fenêtre fermée et recevait "you didn't finish" à 08:00 le lendemain matin. La fenêtre ferme désormais à 21:00. Lorsqu'un message n'a de sens que le jour même, vérifiez ce qui arrive à quelqu'un qui arrive juste après la fermeture de la fenêtre.

## Session terminée : personnaliser à partir de l'événement \\

À la fin d'une session, la personne qui a fait le ménage reçoit une courte confirmation qui nomme la pièce. La pièce n'est pas un tag. Elle provient de l'événement qui a démarré le Journey.

```text Push template: Cleaning Session Completed theme={null}
{{ journey.first_event.properties.room_name }} cleaned ✅

Great work cleaning the {{ journey.first_event.properties.room_name }} {{ user_name | default: 'cleaner' }}! Keep up the hard work!
```

`journey.first_event.properties` lit une propriété de l'événement d'entrée. `user_name` seul lit un tag, et le filtre `default` couvre toute personne dont le tag est absent.

Ce Journey ne comporte qu'une étape. Il aurait pu s'agir d'un envoi du backend, comme le push qui informe les colocataires de la même session dans [Envoyer des push depuis votre backend](https://documentation.onesignal.com/docs/fr/example-full-integration-backend-push.md#session-completed-a-push-triggered-from-the-app). C'est un Journey parce que le texte peut alors être modifié, testé ou désactivé dans le tableau de bord.

> [!WARNING]
>
> L'Event Stream transmet un message de Journey tel qu'il a été rédigé, avec le Liquid encore présent. La boîte de réception de Clean Beans affichait `{{ journey.first_event.properties.room_name }} cleaned` jusqu'à ce que le webhook apprenne à l'interpréter. Consultez [Interpréter le Liquid avant de l'enregistrer](https://documentation.onesignal.com/docs/fr/example-full-integration-inbox.md#render-liquid-before-you-store-it).

## Promotions par pièce : créer une branche selon une propriété de l'événement \\

Ce Journey envoie un message différent selon la pièce nettoyée. Il montre deux choses : retenir des personnes jusqu'à ce qu'un événement se produise, et créer des branches selon une propriété de cet événement.

Les membres entrent depuis un segment de personnes actives au cours des sept derniers jours. La première étape est un **Wait Until** à trois branches. Chaque branche attend `cleaning_session_completed` avec un `room_name` précis.

| Condition de la branche | Ensuite |
| - | - |
| `room_name` vaut `Kitchen` | Attendre 2 heures, fenêtre horaire de 08:00 à 20:00, push cuisine |
| `room_name` vaut `Bathroom` | Attendre 2 heures, fenêtre horaire de 08:00 à 20:00, push salle de bain |
| `room_name` vaut `Bedroom` | Attendre 2 heures, fenêtre horaire de 08:00 à 20:00, push chambre |

Une session dans une autre pièce ne correspond à aucune branche, et le membre continue d'attendre. La réentrée est autorisée après 30 minutes, donc le Journey réagit à chaque nouvelle session.

> [!NOTE]
>
> Les push de ce Journey font la promotion de produits de ménage fictifs. Ils sont là pour illustrer le modèle. Ce sont aussi des messages marketing que les paramètres de notification de l'application ne couvrent pas, ce qu'il faut prévoir dans une application réelle. Consultez [Ce que les Journeys ne peuvent pas voir](#what-journeys-cannot-see).

## Palier de série : un événement avec un nombre \\

C'est l'application qui décide quand une série a atteint un palier, car elle vient d'enregistrer la nouvelle série. Elle envoie `streak_milestone` avec la longueur, et le Journey fait le reste.

```text Push template: Streak - Milestone reached theme={null}
🔥 {{ journey.first_event.properties.streak_count }}-day streak!

Nice work, {{ user_name | default: 'you' }}. That's {{ journey.first_event.properties.streak_count }} days in a row. Keep it going tomorrow.
```

| Étape | Paramètre |
| - | - |
| Entrée | Événement personnalisé `streak_milestone` |
| Attente | 1 minute |
| Push | Le modèle ci-dessus |

> [!NOTE]
>
> **Deux Journeys, un même moment.** Un palier survient toujours à la fin d'une session, c'est-à-dire au moment où le Journey de session terminée envoie aussi son message. Sans l'attente d'une minute, les deux push arriveraient ensemble. Lorsque plusieurs Journeys démarrent à partir de la même action utilisateur, examinez-les côte à côte.

## Série sur le point de se rompre : le moment, une vérification de segment et des textes variés \\

Une série se termine à minuit tout jour sans session. Ce Journey prévient le membre ce soir-là. C'est le plus élaboré des sept, et chacune de ses étapes résout un problème distinct.

| Étape | Paramètre | Pourquoi |
| - | - | - |
| Entrée | Événement personnalisé `cleaning_session_completed` | Chaque session lance un nouveau compte à rebours |
| Attente | 22 heures | Voir ci-dessous |
| Fenêtre horaire | De 18:00 à 22:00, fuseau horaire du membre | Le soir du lendemain de la session |
| Branche Yes/No | Dans le segment "Streak 2+ Days, Reminders On" | Uniquement les personnes ayant une série et souhaitant le rappel |
| Split, 5 branches à 20 % | L'un de cinq modèles de push | La formulation change d'un soir à l'autre |
| Sortie | Événement personnalisé `cleaning_session_completed` | La personne a refait le ménage, l'avertissement n'est donc plus vrai |

**Tomber le bon soir.** L'avertissement doit arriver le soir qui suit la dernière session, quelle que soit l'heure de cette session. Une attente de 22 heures suivie d'une fenêtre de 18:00 à 22:00 tombe toujours à ce moment-là. Une session à 08:00 atteint l'étape de fenêtre à 06:00 le lendemain et reste en attente jusqu'à 18:00. Une session à 23:00 l'atteint à 21:00 le lendemain et part immédiatement.

**Respecter un paramètre que le Journey ne voit pas.** Clean Beans propose un interrupteur "Streak reminders" dans ses paramètres de notification, stocké dans la base de données. L'application le reflète sous forme de tag.

```typescript src/lib/onesignalSync.ts theme={null}
// Mirrors the "Streak reminders" setting, so a Journey can respect it.
// Journeys cannot read the app's database, only tags.
streak_reminders:
  profile.notifications_enabled !== false && profile.push_streak_reminders !== false ? 'on' : 'off',
```

Le segment exige `streak_count` supérieur à 1 et `streak_reminders` égal à `on`. Un membre utilisant une ancienne version n'a pas du tout de tag `streak_reminders`, il se retrouve donc hors du segment et ne reçoit pas l'avertissement.

**Varier le texte.** La même phrase chaque soir finit par ne plus être remarquée. L'étape **Split** envoie chaque personne dans l'une de cinq branches au hasard, et chaque branche a son propre modèle. La branche est choisie à nouveau à chaque entrée, donc un membre voit des formulations différentes selon les soirs.

| Branche | Titre |
| - | - |
| A | Your streak ends at midnight |
| B | Don't let your streak slip away |
| C | Still time to clean today |
| D | One task saves your streak |
| E | Midnight is coming for your streak ⏰ |

> [!NOTE]
>
> Clean Beans affiche aussi un avertissement de série sous forme de Live Activity, décrit dans [Live Activities](https://documentation.onesignal.com/docs/fr/example-full-integration-live-activities.md). Un membre qui a activé les Live Activities reçoit les deux. Le push couvre Android et toute personne qui a désactivé les Live Activities.

## Réengagement et le webhook de Journey \\

Le dernier Journey s'occupe des membres qui n'ouvrent plus l'application. C'est le seul qui démarre uniquement depuis un segment, et le seul qui appelle le backend.

| Étape | Quand | Message |
| - | - | - |
| Entrée | Le membre rejoint le segment "Inactive 7+ Days" | Nouveaux entrants uniquement |
| Push 1 | Prochaine fenêtre de 10:00 à 19:00 | "It's been a while" |
| Push 2 | 2 jours plus tard | Le classement hebdomadaire |
| E-mail | 3 jours plus tard | "We saved your spot" |
| Push 3 | 3 jours plus tard | "A fresh start" |
| Webhook | 2 jours plus tard | Indique au backend que le membre a décroché |
| Sortie | Événement personnalisé `cleaning_session_completed` | La personne est revenue |

La réentrée est autorisée après 30 jours. L'entrée est limitée aux personnes qui rejoignent le segment après le démarrage du Journey. Sans cela, toutes les personnes déjà inactives le jour de son activation reçoivent immédiatement le premier push.

### Prévenez votre backend quand la séquence s'épuise \\

Un membre qui arrive au bout sans faire le ménage n'a répondu à aucun des quatre messages. Un cinquième a peu de chances d'aider. Clean Beans prévient plutôt le foyer. Une étape **Webhook** appelle une fonction backend, qui marque le membre comme inactif et prévient les propriétaires et administrateurs du foyer.

**Configuration dans le tableau de bord.** Créez un webhook de Journey avec ces paramètres et sélectionnez-le dans la dernière étape du Journey.

```json Journey webhook theme={null}
{
  "method": "POST",
  "url": "https://YOUR_PROJECT_REF.supabase.co/functions/v1/journey-webhook",
  "headers": {
    "Content-Type": "application/json",
    "X-Webhook-Secret": "YOUR_SHARED_SECRET"
  },
  "body": {
    "event": "member_lapsed",
    "external_id": "{{ user.external_id }}"
  }
}
```

La fonction vérifie le secret avant toute autre chose. Elle est déployée sans la vérification de jeton de Supabase, car OneSignal n'envoie pas de jeton Supabase. Le secret partagé est donc la seule protection entre l'endpoint et l'internet public.

```typescript supabase/functions/journey-webhook/index.ts theme={null}
const secret = req.headers.get('X-Webhook-Secret') ?? '';
if (!JOURNEY_WEBHOOK_SECRET || secret !== JOURNEY_WEBHOOK_SECRET) {
  return new Response('Unauthorized', { status: 401 });
}
```

Elle vérifie ensuite l'affirmation par elle-même. Le Journey indique que le membre est inactif, mais le Journey ne connaît que les sessions d'application et les événements. La base de données sait si la personne a fait le ménage.

```typescript supabase/functions/journey-webhook/index.ts theme={null}
const since = new Date(Date.now() - RECENT_ACTIVITY_DAYS * 24 * 60 * 60 * 1000).toISOString();
const { count: recentSessions } = await supabase
  .from('cleaning_sessions')
  .select('id', { count: 'exact', head: true })
  .eq('user_id', userId)
  .gte('completed_at', since);

if ((recentSessions ?? 0) > 0) {
  return jsonResponse({ skipped: true, reason: 'recently_active' });
}

// Already flagged: a retried or repeated webhook does nothing more
if (profile.lapsed_at) {
  return jsonResponse({ skipped: true, reason: 'already_lapsed' });
}
```

Ce n'est qu'ensuite qu'elle marque le membre et envoie un push aux personnes qui peuvent agir.

```typescript supabase/functions/journey-webhook/index.ts theme={null}
const onesignalPayload: Record<string, unknown> = {
  app_id: ONESIGNAL_APP_ID,
  include_aliases: { external_id: recipientIds },
  target_channel: 'push',
  ...DELIVERY.member_lapsed,
  headings: { en: `${memberName} has gone quiet` },
  contents: { en: `${memberName} hasn't cleaned in a while. A friendly nudge might help.` },
  url: 'cleaning-rota:///household',
  data: { type: 'member_lapsed', memberId: userId, memberName },
};
```

Le marqueur s'efface tout seul. Un trigger de base de données le supprime la prochaine fois que le membre termine une session, donc l'application n'a jamais à y penser.

> [!TIP]
>
> Une étape webhook peut faire tout ce qu'une étape de message ne peut pas faire : mettre à jour un enregistrement, ouvrir un ticket de support, ajouter quelqu'un à une liste dans un autre système. Traitez la requête comme tout autre appel externe. Vérifiez un secret, vérifiez les faits et rendez une répétition sans effet.

## Ce que les Journeys ne peuvent pas voir \\

Chaque envoi du backend dans ce guide vérifie les paramètres de notification du membre avant d'envoyer. Un Journey ne peut pas le faire, car les paramètres se trouvent dans la base de données de l'application.

| Le Journey doit savoir | Comment Clean Beans le lui indique |
| - | - |
| Que quelque chose vient de se produire | Un événement personnalisé |
| Un fait sur la personne | Un tag |
| Un groupe de personnes | Un segment construit à partir de tags ou de l'activité |
| S'il doit s'arrêter | Une règle de sortie sur un événement personnalisé |
| Un paramètre stocké dans votre base de données | Un tag qui reflète le paramètre, et un segment qui l'exige |

Seul l'avertissement de série dispose d'un paramètre reflété. Les autres push de Journey sont envoyés à toute personne ayant activé les notifications push pour l'application. Si votre application propose des paramètres de notification par type, reflétez chacun de ceux qu'un Journey doit respecter.

## À savoir \\

* **Repérez les Journeys qui partagent une audience.** Clean Beans a brièvement eu deux Journeys de réengagement actifs sur le même segment, ce qui plaçait chaque membre inactif dans les deux séquences. Un deuxième Journey sur un segment est facile à activer et difficile à remarquer.
* **Donnez aux push de Journey une URL et un `data.type`.** Les modèles créés dans le tableau de bord n'ont ni l'un ni l'autre par défaut, donc un appui ne fait qu'ouvrir l'application. Clean Beans définit les deux sur chaque modèle de Journey, pour qu'ils soient routés comme les push du backend. Consultez [Deep links et clics sur les notifications](https://documentation.onesignal.com/docs/fr/example-full-integration-deep-links.md).
* **Un Journey actif peut être modifié, et la modification peut affecter les personnes qui y sont déjà.** Clean Beans a changé une fenêtre horaire et ajouté une attente sur des Journeys en cours. Faites ce genre de changement délibérément.
* **Les messages de Journey apparaissent dans la boîte de réception.** Ils arrivent par le même Event Stream que tout autre push, avec leur Liquid non interprété.
* **Désactivez le suivi des clics sur un e-mail dont le bouton est un Universal Link.** Le suivi réécrit les liens pour les faire passer par un domaine de suivi, et un lien réécrit n'ouvre plus l'application. Consultez [Ouvrir l'application depuis des liens web ordinaires](https://documentation.onesignal.com/docs/fr/example-full-integration-deep-links.md#open-the-app-from-ordinary-web-links).

> [card] [Vue d'ensemble des Journeys](https://documentation.onesignal.com/docs/fr/journeys-overview.md)
>
> Règles d'entrée, étapes et fonctionnement d'un Journey.

> [card] [Paramètres de Journey](https://documentation.onesignal.com/docs/fr/journeys-settings.md)
>
> Qui entre, sort et revient.

> [card] [Actions de Journey](https://documentation.onesignal.com/docs/fr/journeys-actions.md)
>
> Wait, Wait Until, Yes/No, Split et Time Window.

> [card] [Webhooks de Journey](https://documentation.onesignal.com/docs/fr/journeys-webhook.md)
>
> Appelez votre propre serveur depuis une étape de Journey.

> [card] [Personnaliser avec des événements personnalisés](https://documentation.onesignal.com/docs/fr/personalization-custom-event.md)
>
> Utilisez les propriétés d'événement dans les messages de Journey.

> [card] [Journeys pilotés par les événements](https://documentation.onesignal.com/docs/en/event-driven-journeys.md)
>
> Concevez des Journeys qui réagissent au comportement.


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