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. Un push balayé disparaît. Clean Beans conserve un historique de sept jours dans l’application, avec un compteur de non-lus dans l’en-tête de chaque écran.
La boîte de réception des notifications de Clean Beans

La boîte de réception liste les notifications récentes.

L’application n’enregistre pas elle-même les notifications. Cela manquerait tout ce qui a été livré pendant que l’application était fermée. OneSignal informe le backend de chaque push via un Event Stream, et c’est le backend qui conserve l’historique.
1

OneSignal envoie un événement pour chaque push

Un Event Stream envoie une requête à une fonction backend lorsqu’un push est envoyé, puis à nouveau lorsqu’il est cliqué.
2

La fonction enregistre ou met à jour une ligne

Un événement d’envoi crée une entrée dans la boîte de réception. Un événement de clic la marque comme lue.
3

L'application lit la table

L’écran de la boîte de réception et le badge de l’en-tête interrogent les lignes de l’utilisateur.

Configurer l’Event Stream \

Configuration du tableau de bord. Dans Data > Event Streams, créez un stream avec :
  • URL : l’adresse de votre fonction.
  • En-tête : un secret partagé, par exemple X-Webhook-Secret.
  • Événements : message.push.sent et message.push.clicked.
  • Corps : un modèle Liquid qui met en forme la requête.
Event Stream body
Référencez chaque clé de data par son nom, comme ci-dessus. {{ message.data }} seul affiche l’objet entier sous forme de dict de style Python ({'type': 'kudos'}), qui n’est pas du JSON valide, et la fonction ci-dessous rejetterait la requête en analysant le corps. Le titre et le contenu sont lus avec .en pour la même raison. La boîte de réception n’a besoin que de type. Ajoutez une ligne pour chaque autre clé utilisée par votre propre webhook.Une valeur contenant un guillemet double casse également le JSON. Les push de kudos contiennent du texte saisi par un utilisateur, un message de kudos contenant un " produit donc un corps que la fonction ne peut pas analyser, et ce push n’arrive jamais dans la boîte de réception.
Ce stream envoie un événement pour chaque push livré à chaque appareil, et chaque événement est décompté du volume d’événements de messages de votre offre. Ne sélectionnez que les événements que vous utilisez.

Recevoir les événements \

La fonction vérifie le secret avant toute autre opération.
supabase/functions/inbox-webhook/index.ts
Un événement d’envoi devient une ligne de la boîte de réception. L’ID d’événement de OneSignal sert de clé unique, un événement livré deux fois ne crée donc pas deux lignes.
supabase/functions/inbox-webhook/index.ts
Un événement de clic marque la ligne correspondante comme lue.
supabase/functions/inbox-webhook/index.ts
Le champ data.type qui route un push touché est enregistré avec chaque ligne, la boîte de réception peut donc afficher la bonne icône et ouvrir le bon écran.

Interpréter le Liquid avant de l’enregistrer \

Le stream transmet un message tel qu’il a été rédigé, avant que OneSignal ne le personnalise pour chaque destinataire. Un push envoyé par le backend a déjà son texte final. Un push de Journey, non. L’un des messages de Journey de Clean Beans a ce titre :
Journey push
Le téléphone affiche « Kitchen cleaned ✅ ». Le webhook reçoit la ligne ci-dessus, et la première version de la boîte de réception l’affichait telle quelle. La fonction interprète désormais elle-même le titre et le corps avant de les enregistrer, avec un petit moteur de rendu qui gère la recherche de valeurs et le filtre default. Elle obtient les valeurs à deux endroits :
  • Les tags sont lus dans la base de données. L’application définit chaque tag à partir d’une valeur qu’elle stocke, la fonction lit donc les mêmes valeurs. Transmettre {{ user.tags.user_name }} dans le corps du stream fonctionnerait aussi, mais un nom contenant un guillemet double rendrait ce corps invalide en JSON.
  • Les propriétés d’événement de Journey ne sont pas disponibles dans le stream. La fonction les reconstitue à partir de la session de ménage qui a déclenché l’événement personnalisé.
supabase/functions/inbox-webhook/index.ts
Si vous construisez une boîte de réception ou un journal à partir d’Event Streams, vérifiez à quoi ressemblent vos messages de Journey et de modèle à leur arrivée. Tout Liquid qu’ils contiennent reste du Liquid. Interprétez-le vous-même, comme ici, ou excluez ces messages.

Afficher la boîte de réception \

La sécurité au niveau des lignes garantit que chaque utilisateur ne peut lire que ses propres lignes, les requêtes de l’application n’ont donc pas besoin de filtrer par utilisateur.
app/inbox.tsx
src/components/InboxButton.tsx

Synchroniser les préférences e-mail \

Le même stream résout un second problème. Lorsqu’une personne appuie sur Unsubscribe dans un e-mail, OneSignal cesse de lui envoyer des e-mails, mais l’interrupteur « Weekly Email Summary » de l’application resterait activé. L’écran des paramètres serait erroné, et le backend continuerait d’essayer d’envoyer. Ajouter quatre événements e-mail au stream corrige ce problème. La fonction les traite tous de la même façon : OneSignal n’enverra plus d’e-mail à cette personne, la préférence de l’application est donc désactivée en conséquence.
supabase/functions/inbox-webhook/index.ts
Aucune modification du corps du stream n’est nécessaire, car les champs déjà utilisés par la boîte de réception (event_kind, event_id, external_id) suffisent.
Cela aligne l’application sur OneSignal, et non l’inverse. Si une personne réactive l’e-mail dans l’application, son abonnement OneSignal reste désabonné. Pour la réabonner, votre backend doit appeler l’API d’abonnement de OneSignal.
Le même principe d’Event Stream permet de synchroniser vos propres systèmes avec tout ce que OneSignal sait : ouvertures d’e-mails, clics sur les messages in-app, livraisons de SMS, et plus encore.

Event Streams

Configurer un stream et choisir les événements.

Données Event Stream

Tous les champs disponibles dans le modèle de corps.