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. La plupart des notifications de Clean Beans sont envoyées par le backend, car elles dépendent d’une planification ou d’une action d’une autre personne. Toutes appellent le même endpoint, Create message, et ciblent les personnes par External ID.
Notifications push de Clean Beans

Un exemple de quelques push envoyés par Clean Beans.

Des envois planifiés qui respectent les fuseaux horaires \

Chacun choisit l’heure à laquelle il souhaite recevoir son rappel quotidien. Clean Beans ne planifie pas une tâche par utilisateur. Il exécute une tâche toutes les heures et se demande : « pour qui est-ce l’heure en ce moment ? »
1

Une planification de la base de données appelle une fonction toutes les heures

pg_cron envoie une requête HTTP à une Supabase Edge Function. La clé de service nécessaire est lue depuis Supabase Vault, elle n’apparaît donc jamais dans le SQL.
2

La fonction trouve les utilisateurs dont l'heure locale correspond

Elle charge toutes les personnes qui ont activé ce rappel, convertit l’heure actuelle dans le fuseau horaire de chaque utilisateur et conserve celles dont l’heure choisie est maintenant.
3

Elle vérifie qu'il y a quelque chose à dire

Un utilisateur sans tâche à faire ne reçoit aucun push.
4

Elle appelle OneSignal une fois par utilisateur

Chaque push a son propre contenu, chacun fait donc l’objet d’une requête distincte.
La planification :
supabase/migrations/006_cron_daily_digest.sql
La correspondance de fuseau horaire :
supabase/functions/send-daily-digest/index.ts
L’envoi :
supabase/functions/send-daily-digest/index.ts
Les champs ...DELIVERY.daily_digest, idempotency_key et de badge sont expliqués dans Push fiable et bien maîtrisé. Le champ data.type permet à l’application de savoir quel écran ouvrir lorsque l’utilisateur appuie sur le push. Consultez Deep links et clics sur les notifications. Le titre et le corps sont construits à partir des tâches, le push dit donc quelque chose de précis.
supabase/functions/send-daily-digest/index.ts

Le rappel de tâches en retard : une seconde relance, différente \

Le rappel de tâches en retard reprend le même principe avec deux changements. Il se déclenche six heures après l’heure du résumé de l’utilisateur et ne compte que les tâches strictement en retard.
supabase/functions/send-overdue-reminders/index.ts
Sa tâche s’exécute à la demie, elle n’entre donc jamais en concurrence avec celle du résumé, qui s’exécute à l’heure pile. Le texte est également différent. Un second rappel qui répète le premier est facile à ignorer.
supabase/functions/send-overdue-reminders/index.ts

Le rappel de ménage : une requête pour de nombreuses personnes \

Le rappel de ménage dit la même chose à tout le monde, il n’a donc pas besoin d’une requête par personne. La fonction rassemble tous les ID utilisateur éligibles et les envoie par lots.
supabase/functions/send-cleaning-reminder/index.ts
Envoyez une requête par personne lorsque le contenu diffère. Envoyez une requête pour plusieurs personnes lorsqu’il est identique. Moins de requêtes, c’est moins de points de défaillance et moins de risques de dépasser les limites de débit.

Session terminée : un push déclenché depuis l’application \

Lorsqu’une personne termine une session de ménage, le reste du foyer en est informé. L’application ne peut pas envoyer ce push elle-même, car elle ne doit pas détenir de clé API. Elle appelle une fonction backend, et c’est la fonction qui envoie le push.
src/lib/database.ts
La requête indique ce qui a été nettoyé, mais pas qui l’a nettoyé. La fonction identifie l’appelant à partir de son jeton de connexion, vérifie qu’il est un membre actif du foyer et récupère son nom et son avatar dans son profil. Consultez Vérifier qui appelle. Elle trouve ensuite les autres membres du foyer et retire ceux qui ont désactivé ce type de push.
supabase/functions/session-completed/index.ts
Elle envoie un seul push à tous. L’avatar en forme de haricot de l’expéditeur est joint comme image, avec un champ différent pour chaque plateforme.
supabase/functions/session-completed/index.ts
Une notification push développée affichant une image d'avatar en forme de haricot

Un push de session terminée, développé pour afficher l'avatar de l'expéditeur.

Kudos : d’une personne à une autre \

Les kudos fonctionnent de la même manière, avec un seul destinataire. Sur l’écran d’activité, un membre appuie sur Send Kudos sur la session d’un colocataire, choisit un message, et l’application appelle la fonction send-kudos.
Le panneau inférieur des kudos avec des messages prédéfinis

Choisir un message de kudos pour la session de ménage d'un colocataire.

supabase/functions/send-kudos/index.ts

Adhésion approuvée : un push déclenché par la base de données \

Une personne qui demande à rejoindre un foyer attend qu’un administrateur l’approuve. À ce moment-là, sa ligne d’adhésion passe de pending à active. Un déclencheur de base de données sur ce changement appelle une fonction, et la fonction lui annonce qu’elle fait désormais partie du foyer. Placer le déclencheur dans la base de données signifie que le push est envoyé quelle que soit la façon dont l’approbation a lieu, et que l’application n’a besoin d’aucun code pour cela.
supabase/migrations/027_join_approved_trigger.sql
La fonction ne se fie pas à ce qu’on lui dit. Elle relit l’adhésion et n’envoie le push que si l’approbation est réelle et récente.
supabase/functions/join-approved/index.ts
Une fonction qui envoie des messages à la demande est une fonction que d’autres peuvent tenter d’appeler. Vérifiez les faits dans votre propre base de données avant d’envoyer, comme le fait celle-ci, et n’acceptez jamais le contenu d’un message ni des destinataires de la part d’un appelant que vous n’avez pas vérifié.

Vérifier qui appelle \

Supabase vérifie qu’une requête vers une edge function porte un jeton valide, mais le jeton d’un utilisateur connecté est tout aussi valide que celui du planificateur. Sans vérification supplémentaire, n’importe quel utilisateur pourrait déclencher le résumé quotidien pour tout le monde ou envoyer un push au nom de quelqu’un d’autre. Chaque fonction décide donc elle-même qui est autorisé à l’appeler. Les fonctions planifiées commencent par une ligne :
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
La vérification du rôle suppose que Supabase a déjà vérifié la signature du jeton. Déployez ces fonctions avec la vérification JWT activée, ce qui est le comportement par défaut. Ne les déployez jamais avec --no-verify-jwt.
Les fonctions appelées depuis l’application identifient l’expéditeur à partir du jeton, puis vérifient qu’il est autorisé à joindre le destinataire. Les kudos ne peuvent être envoyés qu’à une personne qui partage un foyer avec l’expéditeur, et le nom affiché dans le push est lu dans le profil de l’expéditeur.
supabase/functions/send-kudos/index.ts

API Create message

Ciblage, contenu et planification pour tous les canaux.

Rich media

Images dans les notifications push sur chaque plateforme.