メインコンテンツへスキップ
このページは、1つの実在アプリを最初から最後まで追うサンプルアプリ:OneSignalの完全な統合の一部です。アプリはClean Beansという共同生活の家のための掃除当番表アプリで、Expo(React Native)とSupabaseバックエンドで構築されています。 Clean Beansは、プッシュやメールでは難しい2つの用途にSMSを使います。電話番号が入力した本人のものであることの証明と、まだアプリを持っていない人への連絡です。 どちらもExternal IDではなく、電話番号やメールアドレスといった連絡先そのものに送信します。これが、このガイドのほかのすべての送信との主な違いです。

ワンタイムコードで電話番号を認証する \

User Profileで、ユーザーは携帯電話番号を追加できます。アプリはバックエンドに6桁のコードをSMSで送るよう依頼し、ユーザーがそれを入力し、バックエンドが確認します。それが済んで初めて、番号は認証済みとみなされます。
番号の入力、コードの入力、認証済みの3つの状態の電話番号カード

電話番号の追加:番号の入力、コードの入力、認証完了。

OneSignalはテキストメッセージを配信します。コードの生成や確認は行いません。それ以外はすべてバックエンドの役割です。
1

コードを生成し、ハッシュ化して保存する

コードは暗号論的な乱数源から生成します。ユーザーと電話番号に紐付けたキー付きハッシュだけを保存するため、テーブルだけからコードを復元することはできません。キーは専用のシークレットOTP_HASH_SECRETで、ほかの用途には使いません。これが設定されていない場合、どちらの関数も実行を拒否します。
supabase/functions/_shared/otp.ts
supabase/functions/send-otp/index.ts
2

OneSignal経由でSMSを送信する

include_phone_numbersは番号を直接指定します。OneSignalがその番号を初めて扱う場合は、SMSサブスクリプションを作成します。
supabase/functions/send-otp/index.ts
3

コードを確認する

バックエンドはユーザーが入力した値をハッシュ化し、保存済みのハッシュと比較します。誤入力は回数が記録されます。5回誤るとコードは無効になり、新しいコードをリクエストする必要があります。
supabase/functions/verify-otp/index.ts
4

番号をSMSサブスクリプションとして登録する

バックエンドがコードを確認すると、アプリはサインイン中のユーザーに番号を追加します。
src/lib/phone.ts
アプリはサインインのたびにこれを繰り返すため、認証済みの番号は新しいデバイスにも引き継がれます。
src/lib/phone.ts
メールと同様に、addSms()はlogin()の後に呼び出してください。電話番号に直接送信すると、誰にも属さないサブスクリプションが作成されます。サインイン中のアプリからaddSms()を呼ぶと、そのサブスクリプションがユーザーに紐付きます。それまでは、ダッシュボード上で別のユーザーレコードとして表示されます。

エンドポイントを保護する \

リクエストに応じてテキストメッセージを送る関数は、実行のたびに費用がかかり、悪用の標的にもなります。Clean Beansは次の制限を設けています。
supabase/functions/send-otp/index.ts
認証済みの番号は専用のテーブルに保存します。書き込めるのはバックエンドだけなので、アプリが番号を認証済みにすることはできず、世帯のほかのメンバーが読み取ることもできません。
supabase/migrations/028_phone_verification_and_invites.sql
電話番号があるだけでは、SMSを送る許可にはなりません。認証コードの場合は、電話番号の入力欄の横に開示文を置けば十分です。開示文には、送信者、送信内容、料金が発生する場合があること、停止方法を記載する必要があります。
src/components/PhoneVerificationCard.tsx

まだユーザーでない人を招待する \

Household画面で、メンバーはSMSまたはメールで人を招待できます。招待される人にはアカウントも、登録済みのデバイスも、External IDもありません。バックエンドは連絡先に直接、アプリの参加画面を開くリンク付きで送信します。
招待ダイアログと、それが送信する招待のテキストメッセージ

SMSまたはメールで同居人を招待する画面と、相手が受け取るメッセージ。

同じエンドポイントで両方のチャネルを扱います。SMSはinclude_phone_numbersを使います。メールはemail_toを使い、件名とHTML本文をリクエストに直接含めます。
supabase/functions/send-invite/index.ts
リンクは通常のWebリンクからアプリを開くで設定したUniversal Linkです。正しく機能させるための2つのポイントがあります。
  • メールのクリックトラッキングをオフにしています。 トラッキングはリンクをトラッキング用ドメイン経由に書き換えるため、書き換えられたリンクではアプリが開かなくなります。
  • SMSではトラッキング付きの短縮リンクを使いません。理由は同じです。
招待された人がアプリをインストールしてサインインすると、アプリのlogin()とaddEmail()またはaddSms()の呼び出しにより、招待で作成されたサブスクリプションがその新しいユーザーに紐付きます。
招待された人は、あなたのアプリからの連絡に同意していません。迷惑SMSやメールに関する規則は国によって異なり、厳しい場合もあります。Clean Beansは連絡先への直接送信の仕組みを示すためにこのフローを含めており、各メンバーの招待数を1日10件に制限しています。本番環境でこのパターンを使う前に、送信先の地域の規則を確認し、招待する人が自分の電話からメッセージを送る方法も検討してください。

知っておくべきこと \

  • 送信者が必要です。 Settings > SMSでデフォルトの送信者を選ぶか、リクエストごとにsms_fromを渡してください。どちらもない場合、リクエストは「A valid number is required for ‘From’ field」で拒否されます。
  • 200レスポンスが必ずしもメッセージの送信を意味するとは限りません。 ステータスコードだけでなく、レスポンスにメッセージのidがあるか確認してください。
  • 番号はE.164形式で保存してください。 プラス記号の後に国番号と番号を続ける形式です。それ以外はAPIを呼び出す前に拒否してください。
  • OneSignal Verifyはマネージドな代替手段です。 コードの生成と確認を代行します。Clean Beansはフロー全体を示すために独自に実装しています。
ダッシュボードの設定。 SMSのセットアップを完了し、ユーザーのいる国に届くデフォルトの送信者を選んでください。

ワンタイムパスワード

OneSignal Verifyと独自実装。

SMSのオプトインと収集

同意と開示の要件。

SMS APIリファレンス

すべてのSMSパラメーター。