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. Clean Beans utilise le SMS pour deux tâches que le push et l’e-mail ne font pas bien : prouver qu’un numéro de téléphone appartient à la personne qui l’a saisi, et joindre quelqu’un qui n’a pas encore l’application. Les deux sont envoyés à un contact brut, un numéro de téléphone ou une adresse e-mail, et non à un External ID. C’est la principale différence avec tous les autres envois de ce guide.

Vérifier un numéro de téléphone avec un code à usage unique \

Dans User Profile, un utilisateur peut ajouter un numéro de mobile. L’application demande au backend d’envoyer par SMS un code à 6 chiffres, l’utilisateur le saisit et le backend le vérifie. Ce n’est qu’alors que le numéro est considéré comme vérifié.
La carte du numéro de téléphone dans trois états : saisie du numéro, saisie du code et vérifié

Ajouter un numéro de téléphone : saisir le numéro, saisir le code, vérifié.

OneSignal livre le SMS. Il ne crée ni ne vérifie le code. Tout le reste est du ressort de votre backend.
1

Générer un code et le stocker haché

Le code provient d’une source aléatoire cryptographique. Seul un hachage avec clé est stocké, lié à l’utilisateur et au numéro de téléphone, de sorte que la table seule ne permet pas de retrouver les codes. La clé est un secret dédié, OTP_HASH_SECRET, qui ne sert à rien d’autre. Les deux fonctions refusent de s’exécuter s’il n’est pas défini.
supabase/functions/_shared/otp.ts
supabase/functions/send-otp/index.ts
2

L'envoyer par SMS via OneSignal

include_phone_numbers cible directement le numéro. Si OneSignal ne l’a jamais vu, il crée un abonnement SMS pour ce numéro.
supabase/functions/send-otp/index.ts
3

Vérifier le code

Le backend hache ce que l’utilisateur a saisi et le compare au hachage stocké. Chaque tentative erronée est comptabilisée. Au bout de cinq, le code n’est plus valide et il faut en demander un nouveau.
supabase/functions/verify-otp/index.ts
4

Enregistrer le numéro comme abonnement SMS

Une fois le code confirmé par le backend, l’application ajoute le numéro à l’utilisateur connecté.
src/lib/phone.ts
L’application répète cette opération après chaque connexion, de sorte qu’un numéro vérifié suit l’utilisateur sur un nouvel appareil.
src/lib/phone.ts
Appelez addSms() après login(), comme pour l’e-mail. Un envoi vers un numéro de téléphone brut crée un abonnement qui n’appartient à personne. addSms() depuis une application connectée rattache cet abonnement à l’utilisateur. Jusque-là, il apparaît dans le tableau de bord comme un enregistrement utilisateur distinct.

Protéger l’endpoint \

Une fonction qui envoie un SMS à la demande coûte de l’argent à chaque exécution et constitue une cible d’abus. Clean Beans applique ces limites.
supabase/functions/send-otp/index.ts
Le numéro vérifié est conservé dans sa propre table. Seul le backend peut y écrire, l’application ne peut donc pas marquer un numéro comme vérifié, et les autres membres d’un foyer ne peuvent pas le lire.
supabase/migrations/028_phone_verification_and_invites.sql
Un numéro de téléphone ne constitue pas à lui seul une autorisation d’envoyer des SMS. Pour les codes de vérification, une mention à côté du champ de téléphone suffit. Elle doit indiquer qui envoie, ce qui sera envoyé, que des frais peuvent s’appliquer et comment se désinscrire.
src/components/PhoneVerificationCard.tsx

Inviter une personne qui n’est pas encore utilisatrice \

Sur l’écran Household, un membre peut inviter quelqu’un par SMS ou par e-mail. La personne invitée n’a ni compte, ni appareil enregistré, ni External ID. Le backend envoie au contact brut, avec un lien qui ouvre l’écran d’adhésion de l’application.
La boîte de dialogue d'invitation et le SMS d'invitation qu'elle envoie

Inviter un colocataire par SMS ou e-mail, et le message qu'il reçoit.

Le même endpoint gère les deux canaux. Le SMS utilise include_phone_numbers. L’e-mail utilise email_to, avec l’objet et le corps HTML transmis directement dans la requête.
supabase/functions/send-invite/index.ts
Le lien est un Universal Link, configuré dans Ouvrir l’application depuis des liens web ordinaires. Deux détails lui permettent de fonctionner :
  • Le suivi des clics dans l’e-mail est désactivé. 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.
  • Le SMS n’utilise pas de lien court suivi, pour la même raison.
Lorsque la personne invitée installe l’application et se connecte, les appels login() et addEmail() ou addSms() de l’application rattachent à son nouvel utilisateur l’abonnement créé par l’invitation.
La personne invitée n’a pas accepté de recevoir des messages de votre application. Les règles concernant les SMS et e-mails non sollicités varient selon les pays et peuvent être strictes. Clean Beans inclut ce parcours pour montrer comment fonctionne l’envoi à un contact brut, et limite chaque membre à dix invitations par jour. Avant d’utiliser ce modèle en production, vérifiez les règles des pays vers lesquels vous envoyez, et envisagez de faire envoyer le message par la personne qui invite depuis son propre téléphone.

À savoir \

  • Un expéditeur est obligatoire. Choisissez un expéditeur par défaut dans Settings > SMS, ou transmettez sms_from avec chaque requête. Sans l’un ni l’autre, la requête est rejetée avec « A valid number is required for ‘From’ field ».
  • Une réponse 200 ne signifie pas toujours qu’un message a été envoyé. Vérifiez la présence d’un id de message dans la réponse, et pas seulement le code de statut.
  • Stockez les numéros au format E.164, un signe plus suivi de l’indicatif du pays et du numéro, et rejetez tout autre format avant d’appeler l’API.
  • OneSignal Verify est l’alternative gérée. Il génère et vérifie les codes pour vous. Clean Beans crée les siens pour montrer le parcours complet.
Configuration du tableau de bord. Effectuez la configuration SMS et choisissez un expéditeur par défaut capable d’atteindre les pays de vos utilisateurs.

Mots de passe à usage unique

OneSignal Verify et créer votre propre solution.

Opt-in et collecte SMS

Exigences de consentement et de mentions.

Référence de l'API SMS

Tous les paramètres SMS.