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é.
Ajouter un numéro de téléphone : saisir le numéro, saisir le code, vérifié.
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é.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
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
supabase/migrations/028_phone_verification_and_invites.sql
Demander le consentement là où le numéro est saisi \
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.
Inviter un colocataire par SMS ou e-mail, et le message qu'il reçoit.
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 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.
login() et addEmail() ou addSms() de l’application rattachent à son nouvel utilisateur l’abonnement créé par l’invitation.
À savoir \
- Un expéditeur est obligatoire. Choisissez un expéditeur par défaut dans Settings > SMS, ou transmettez
sms_fromavec 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
200ne signifie pas toujours qu’un message a été envoyé. Vérifiez la présence d’unidde 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.
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.