# Notifications de rappel questionnaire (/docs/statistiques/notifications-rappel-questionnaire)



## Vue d'ensemble [#vue-densemble]

Quand un événement (séance ou match) a un **questionnaire associé**, FormaPulse pousse une notification mobile vers les sportifs concernés pour leur rappeler de répondre. Il existe **deux mécanismes complémentaires** :

1. **Rappel automatique** — des rappels sont envoyés automatiquement aux sportifs **n'ayant pas répondu**, **toutes les 4 heures** pendant les **16 heures qui suivent la fin de la séance** (soit **4 rappels maximum** par sportif et par questionnaire).
2. **Rappel manuel** — depuis la page **Stats > Séances/Matchs > onglet Questionnaire**, un bouton **cloche** permet d'envoyer un rappel **immédiat** aux sportifs n'ayant pas encore répondu.

Les deux mécanismes utilisent le même canal de notification mobile.

<VideoAVenir titre="Envoyer un rappel de questionnaire" />

## Pré-requis côté joueur [#pré-requis-côté-joueur]

Pour qu'un sportif reçoive une notification :

* Il doit avoir installé l'**application mobile FormaPulse Joueur** et s'être connecté
* L'app doit avoir **enregistré son token de notification** lors de la première connexion
* Les notifications push doivent être **autorisées** au niveau de l'OS du téléphone

Si un sportif n'a pas autorisé les notifications, le rappel est silencieusement ignoré pour lui (les autres sportifs valides la reçoivent quand même).

## 1. Rappel automatique (toutes les 4h pendant 16h) [#1-rappel-automatique-toutes-les-4h-pendant-16h]

### Fonctionnement [#fonctionnement]

Après la fin d'une séance ayant un questionnaire associé, le système envoie un rappel **toutes les 4 heures** aux sportifs n'ayant pas répondu, et ce **pendant 16 heures**. Cela représente au maximum **4 notifications** par sportif et par questionnaire :

| Échéance                   | Notification        |
| -------------------------- | ------------------- |
| 4h après la fin de séance  | 1er rappel          |
| 8h après la fin de séance  | 2e rappel           |
| 12h après la fin de séance | 3e rappel           |
| 16h après la fin de séance | 4e rappel (dernier) |

À chaque tour, le système :

1. Sélectionne les **séances terminées depuis moins de 16 heures** ayant un questionnaire associé.
2. Pour chaque séance, identifie les sportifs **n'ayant toujours pas répondu**.
3. Construit un titre et un message contextuels (nom du questionnaire + nom et date de la séance).
4. Envoie une notification push aux sportifs concernés.

Dès qu'un sportif répond, il **n'est plus relancé** par les rappels suivants.

### Quand un sportif ne reçoit-il PAS le rappel auto ? [#quand-un-sportif-ne-reçoit-il-pas-le-rappel-auto-]

* Il a déjà répondu au questionnaire (les rappels suivants l'ignorent)
* La séance est terminée depuis **plus de 16 heures** (la fenêtre de relance est passée)
* Son téléphone n'autorise pas les notifications, ou il n'a jamais ouvert l'app
* L'événement n'a **pas de questionnaire** associé

## 2. Rappel manuel via la cloche [#2-rappel-manuel-via-la-cloche]

### Où ? [#où-]

Page **Statistiques > Séances** (ou **Matchs**) → onglet **Questionnaire** → colonne de gauche.

Une cloche s'affiche **à côté du % de réponses** uniquement si :

* Un questionnaire est attaché à l'événement
* Au moins un sportif n'a **pas encore répondu**

Info-bulle au survol : &#x2A;« Envoyer une notification de rappel à N sportif(s) »*.

### Action [#action]

Au clic :

1. La cloche pulse pendant l'envoi (bouton désactivé).
2. Le rappel est envoyé aux sportifs n'ayant pas répondu **uniquement** (ceux qui ont déjà rempli le questionnaire ne sont pas dérangés).
3. Message de confirmation : &#x2A;« Notifications envoyées à N sportif(s) »*.
4. En cas d'échec : message d'erreur en rouge &#x2A;« Erreur lors de l'envoi des notifications »*.

### Message envoyé [#message-envoyé]

Par défaut, le message est :

* **Titre** : « 📋 Questionnaire à remplir »
* **Corps*&#x2A; : &#x2A;« N'oubliez pas de remplir \[nom du questionnaire] pour la séance "\[nom de la séance]" du \[date] »*

### Quand utiliser le manuel ? [#quand-utiliser-le-manuel-]

* Tu veux relancer **avant le prochain créneau auto** (les rappels auto tombent toutes les 4h, donc tu peux gagner du temps en envoyant tout de suite)
* La fenêtre des 16h est **dépassée** : il n'y a plus de rappel auto, seul le manuel reste disponible pour relancer les retardataires
* Tu as ajouté un questionnaire **après coup** à une séance déjà terminée et tu veux notifier immédiatement

## 3. Différences entre auto et manuel [#3-différences-entre-auto-et-manuel]

| Aspect                      | Rappel auto (4h × 4)                                               | Rappel manuel (cloche)                          |
| --------------------------- | ------------------------------------------------------------------ | ----------------------------------------------- |
| Déclenchement               | Automatique, toutes les 4h                                         | Clic utilisateur                                |
| Nombre de relances          | Jusqu'à **4** par sportif                                          | Illimité (à chaque clic)                        |
| Sélection des destinataires | Tous les sportifs non-répondus de **toutes** les séances éligibles | Sportifs non-répondus de **la séance affichée** |
| Cible temporelle            | Séances terminées depuis **moins de 16h**                          | Toute séance affichée                           |
| Visibilité staff            | Aucune (silencieux)                                                | Message de confirmation ou d'erreur à l'écran   |

## Erreurs à éviter [#erreurs-à-éviter]

* **Spammer la cloche** : chaque clic envoie une notification. Si tu cliques 5 fois, les sportifs reçoivent 5 push (en plus des rappels auto déjà programmés toutes les 4h). Laisse passer un cycle avant de relancer.
* **Cumuler manuel + auto au mauvais moment** : si tu cliques sur la cloche juste avant un créneau auto (ex: 3h59 après la séance), le sportif peut recevoir 2 notifs très rapprochées. Préfère cliquer juste après un créneau auto, ou bien à la toute fin de séance.
* **Attendre passé 16h** : après 16h depuis la fin de la séance, **plus aucun rappel auto** ne part. Si des sportifs n'ont toujours pas répondu, seul le bouton **manuel** permet de les relancer.
* **Téléphone reconfiguré** : si un sportif change de téléphone et ne se reconnecte pas à l'app, ses anciennes notifications sont obsolètes. La notification est ignorée silencieusement. Lui demander de se reconnecter à l'app.
* **Croire que la notif réveille l'app** : sur iOS en mode silencieux ou batterie économique, la notif peut être différée. Ce n'est pas un bug FormaPulse.

## Aller plus loin [#aller-plus-loin]

<Cards>
  <Card title="Statistiques de séance — onglet Questionnaire" href="/docs/statistiques/stats-seance" />

  <Card title="Questionnaires" href="/docs/questionnaires" />

  <Card title="Modifier la présence" href="/docs/statistiques/modifier-presence" />
</Cards>
