ワークフローの検証

ワークフローは、VonageがPINコードで確認したいエンドユーザに到達するために使用する一連のアクションを定義します。どのチャネルをどの順序で使用するかを指定することにより、独自のワークフローをカスタマイズすることができ、複数の電話番号や電子メールアドレスなどに検証メッセージを送信することができます。

ワークフローは、検証リクエストで配列を使用して設定されます：

• リストの最初のチャンネルが最初に使用される；
• メッセージの変換に成功しなかった場合、リストの次のチャンネルが使用される。

下の例では、まずSMSが試される。変換に失敗した場合は、次にVoiceが使われます。

curl -X POST "https://api.nexmo.com/v2/verify" \
    -H "Authorization: Bearer $JWT" \
    -H 'Content-Type: application/json' \
    -d $'{
        "brand": "TestVerify",
        "locale": "es-es",
        "code_length": 4,
        "channel_timeout": 300,
        "workflow": [
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "voice",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

チェック API仕様 利用可能なパラメータの全リストと詳細な説明については、こちらをご覧ください。

対応チャンネル

Verify は、ユーザーの好みや地域の接続性に基づいて、ワンタイムパスワード（OTP）を配信するための複数のチャネルをサポートしています。以下は、サポートされている各チャネルの概要です：

サイレント認証

サイレント認証 を使用すると、手動で OTP を入力することなくエンドユーザーを Verify できます。バックグラウンドでモバイルネットワークデータを活用することで、より優れたユーザーエクスペリエンスを提供します。サインアップフローやログインフローでの脱落を減らすのに最適です。

RCS

SMSチャネルの強化として、RCSはWi-Fiまたはモバイルデータを介してAndroidやiPhoneのデフォルトのメッセージングアプリにメッセージを配信することができます。

RCSは、ブランド検証をサポートし、配信遅延が少ないため、SMSの優れた代替手段として際立っている。RCSチャネルを利用するには RCSエージェント または 送信者ID が必要である。

現在、RCSは限られた国と対応デバイスで利用可能だが、将来的には拡大する予定である。

ショートメール

SMSは、二要素認証（2FA）のチャネルとして最も人気があり、広く採用されている。

SMS2FAは、ほとんどの人がテキストメッセージを受信でき、オンボーディングもシームレスであるため、広範囲に利用できる。実際、グーグルはSMS 2FAがブロックに役立つことを発見した：

• 自動化されたボットの100
• 一括フィッシング攻撃の96
• 標的型攻撃の76

SMSは信頼性が高く、どこにでもあるため、Verifyのワークフローで最初に試みられることが多い。

WhatsApp

WhatsAppは、その世界的な人気とWiFi経由でメッセージを配信できる機能のおかげで、二要素認証に最適なチャネルであり、モバイル通信が制限されている地域では特に価値がある。

セカンダリーチャネルとしてWhatsAppを追加することで、検証全体のコンバージョン率を大幅に向上させることができます。

WhatsAppでVerify APIをご利用頂くには、WhatsAppビジネスアカウント(WABA)が必要です。WABAを作成するには ソーシャル・チャンネル セクションをクリックし、「WhatsApp」の指示に従ってください。

ユーザーがWhatsAppをインストールしていない場合、Verifyは自動的にそれを検知し、他のチャンネルにフォールバックします。

WhatsApp認証モード

Verify v2は2つのWhatsApp認証体験をサポートします：

• OTP（デフォルト）： ワンタイムコードをWhatsAppに送信し、ユーザーが入力する。
• ゼロタップ（アンドロイド）： Androidアプリのためのよりシームレスな検証体験。この機能を有効にするには mode への zero_tap 使用時 channel = whatsapp.

について mode パラメータはオプションである。指定しない場合のデフォルトは otp_code.

声

音声認証はSMSの強力なバックアップとなる：

• SMS配信は信頼できない。
• 現地の規制により、SMSトラフィックに制限が課されたり、事前登録が必要になったりする。

音声通話の場合、OTPは自動化された電話を通じて配信されるため、アクセスしにくい地域のユーザーでも確実に認証プロセスを完了できる。

電子メール

EメールもOTPの配信に使用できるため、モバイルベースのチャネルの強力な代替手段となる。

特に役に立つ：

• ネットワーク混雑時
• Eメールアカウントで検証を受け取りたいユーザー向け。