Passer au contenu principal
Cette page fait partie de Application d’exemple : une intégration OneSignal complète, 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. Faire arriver un push n’est que la première étape. Cette page couvre les décisions plus fines qui rendent les push dignes de confiance : ne jamais envoyer deux fois le même, laisser expirer ceux qui ne sont plus pertinents et donner à chaque type le comportement qui lui convient.

Ne jamais envoyer deux fois le même rappel \

Les tâches planifiées sont relancées. Une tâche peut aussi être exécutée deux fois par erreur. Sans protection, chaque répétition envoie un push de plus. L’idempotency_key de OneSignal résout ce problème. Si deux requêtes portent la même clé, la seconde n’est pas envoyée. La clé doit être un UUID, et OneSignal la conserve pendant 30 jours. Une fonction planifiée n’a nulle part où conserver une clé aléatoire entre deux exécutions. Clean Beans dérive donc la clé de ce qu’est l’envoi : son type, son destinataire et sa date. Le même envoi produit toujours la même clé.
supabase/functions/_shared/idempotency.ts
Pour un envoi par lots, la clé couvre l’ensemble du lot.
supabase/functions/send-cleaning-reminder/index.ts
Les clés d’idempotence fonctionnent sur les endpoints Create message et Create custom events. Les requêtes Live Activity ne les acceptent pas. Celles-ci sont identifiées par leur activity_id.

Donner à chaque type de push son propre comportement \

Un rappel de ménage qui arrive avec deux heures de retard est pire que pas de rappel du tout. Les kudos sont agréables à recevoir mais jamais urgents. Clean Beans décrit ces différences une seule fois, dans un ensemble de profils de livraison, et applique le bon profil à chaque requête.
supabase/functions/_shared/delivery.ts
Le profil member_lapsed de la liste des types correspond à un push envoyé depuis un webhook de Journey, que ce guide ne couvre pas. Ce que fait chaque paramètre :
  • ttl est la durée pendant laquelle un push est conservé pour un appareil hors ligne. Le rappel de ménage annonce « dans 1 heure », il est donc abandonné au bout d’une heure.
  • thread_id et android_group regroupent les push liés dans la liste des notifications.
  • ios_interruption_level contrôle l’insistance d’un push. time_sensitive peut passer outre les modes Concentration. passive arrive sans bruit.
  • ios_relevance_score classe les push dans le résumé des notifications iOS. Clean Beans réserve 1.0 aux messages critiques et n’en envoie aucun.
Configuration de l’application. iOS ne respecte time_sensitive que si l’application déclare cette capacité.
app.json
Une leçon apprise : collapse_id. Clean Beans a d’abord donné au résumé et au rappel de tâches en retard le même collapse_id, pour que le rappel remplace le résumé. Sur iOS, un push qui en remplace un autre encore présent dans la liste des notifications est substitué sur place, sans bannière ni son. Le rappel passait inaperçu, ce qui allait à l’encontre de son objectif, et le paramètre a donc été retiré. N’utilisez collapse_id que lorsque vous voulez une mise à jour silencieuse, comme un score en direct.

Afficher un nombre sur l’icône de l’application \

Les deux push de tâches définissent le badge de l’icône de l’application sur le nombre indiqué dans leur titre.
supabase/functions/send-overdue-reminders/index.ts
L'icône de l'application Clean Beans avec un badge numérique

Le badge de l'icône de l'application indique le nombre de tâches en retard.

SetTo est utilisé, et non Increase, car le badge compte des tâches et non des notifications non lues. Le rappel de l’après-midi remplace le nombre du matin.
Le SDK OneSignal efface automatiquement le badge à chaque ouverture de l’application, l’application n’a donc besoin d’aucun code pour le réinitialiser. Un push qui arrive pendant que l’application est ouverte n’affiche jamais son badge. Android n’a pas de badge numérique que l’API puisse définir.

Requêtes idempotentes

Fonctionnement des clés et durée de conservation.

Niveaux d'interruption

Les modes Concentration et les quatre niveaux.

Badges

Comportement des badges sur chaque plateforme.