Vonage Verify RCS のデフォルトエージェントの使用方法

すでにVonage Verify APIを使用してOTPを送信している場合は、エージェントの登録や通信事業者の承認手続きを事前に済ませる必要なく、すぐにRCSメッセージの配信を開始できます。 この Vonage Verify RCS のデフォルトエージェント は、Vonageが「」という名称で運営する、一元管理型の事前登録済みRCSエージェントです。 Vonage Verify. 対応国に所在するVerify APIの顧客であれば、単に from 既存のVerify V2リクエスト内のフィールド。

前提条件

• A Vonageアカウント を持つ。 Vonageアプリケーション 設定済み（アプリケーションIDおよび秘密鍵、 JWT認証).
• 既存の Verify V2 API との連携.

対象国が対応対象であるか確認してください

まず、エンドユーザーが「デフォルトエージェント」が設定されている国のいずれかに所在していることを確認してください。 ライブ:

VerifyワークフローにRCSを追加する

既存の Verify V2 リクエストに、以下を追加してください。 "channel": "rcs" ワークフロー配列に。 「」を省略する from フィールド Vonageはメッセージをデフォルトエージェントを経由して自動的にルーティングするため、エージェントIDは必要ありません。

curl -X POST "https://api.nexmo.com/v2/verify" \
    -H "Authorization: Bearer $JWT" \
    -H 'Content-Type: application/json' \
    -d $'{
        "brand": "YOUR_BRAND",
        "workflow": [
        {
            "channel": "rcs",
            "to": "'$PHONE_NUMBER'"
        },
        {
            "channel": "sms",
            "to": "'$PHONE_NUMBER'"
        }
    ]
}'

応答の処理

リクエストが成功すると、 request_id:

{
  "request_id": "REQUEST_ID"
}

エンドユーザーがOTPを送信したら、そのコードを以下の方法で確認してください。 request_id 他のVerifyチャンネルとまったく同じ手順で行います — 詳しくは 提供された検証コードを確認する.

エンドユーザーによるRCSの利用体験

デフォルトエージェントを介して認証メッセージが配信されると、対応するAndroid端末を使用しているエンドユーザーには、以下の機能を備えたリッチRCSメッセージが届きます：

• 送信者認証バッジ — 通信事業者によって認証されたメッセージが届く Vonage Verify エージェント (VonageVFY （シンガポールでは）、ユーザーの信頼を高めています。
• リッチなカードレイアウト — OTPはデザインを施したカードに目立つように表示されるため、一目で簡単に確認できます。
• 「ワンタップでコードをコピー」ボタン — 提案チップを使えば、ユーザーはコードをクリップボードに直接コピーできるため、入力ミスを減らすことができます。
• OTPの自動提案 — 対応しているAndroidバージョンでは、Google Messagesがキーボードの上部に上記のコードをワンタップで入力できる自動入力候補として表示する場合があります。
• ブランドメッセージ本文 — あなたの brand この値はメッセージ本文内に表示されるため、エージェント名は Vonage Verify.
• アプリのインストールは不要です — RCSはAndroidの標準メッセージアプリに組み込まれています。ユーザーによるダウンロードや追加の手順は一切必要ありません。

動作と制限事項

• RCSエージェントの送信者名は常に Vonage Verify (VonageVFY （シンガポール）であり、デフォルトエージェントを使用する場合はカスタマイズできません。ただし、メッセージ本文には、 brand パラメータが必要だ： Your {brand} code is: {code}.
• オプトアウトの設定は、個々のエンドユーザーおよびお客様のAPIキーに限定されます。同じデフォルトエージェントを使用している他の顧客には影響しません。
• 追加の設定、許可リストへの登録、または有効化の手順は一切必要ありません。対応国にお住まいのすべてのVerify APIのお客様は、すぐにデフォルトエージェントをご利用いただけます。
• Vonage Verify APIの標準的な利用制限および適正利用ポリシーが適用されます。
• 課金体系は、標準のVonage Verify RCSの料金体系と同様です。利用状況は、お客様固有のAPIキーごとに集計されます。

独自のRCSエージェントを登録する

デフォルトエージェントは、カスタムエージェントのプロビジョニングが行われている間の推奨される出発点およびつなぎとして機能します。デフォルトエージェントを使用しながら、既存のトラフィックに支障をきたすことなく、独自のエージェント登録を並行して実行することができます。開始するには、 RCSエージェント・ビルダー Vonage APIダッシュボードで。

こちらも参照

• Verify V2 API リファレンス
• ワークフローの検証
• RCSチャンネルのコンセプト
• RCSを認証ワークフローに組み込む
• RCS Agent Builder ガイド