URL から会話を開始する

ユーザーは URL からエージェントとの会話を開始できます。URL を配置する場所はユースケースによって異なります。メール、ウェブサイト、アプリ、物理的な場所など、URL をボタン、リンク、QR コードとして埋め込むことができる場所に配置できます。

ブラウザのセキュリティ対策により、エージェントの URL に手動で移動（コピーして貼り付けるなど）することはできません。URL はボタン、リンク、QR コードに埋め込む必要があります。

ユーザー エクスペリエンス

ユーザーがエージェントの URL を開いた場合、成功、フォールバック、エラーの 3 つの結果が考えられます。

成功

ユーザーが RBM の会話に正常に移行します。会話を正常に開始するには、以下の条件をすべて満たす必要があります。

  • Google メッセージがデバイスにインストールされている（最小バージョン messages.android_20241029_00）。
  • メッセージ アプリで RCS チャットが有効になっている。
  • RBM エージェントがユーザーの携帯通信会社で起動されます。

フォールバック

ユーザーは、代替の電話番号またはショートコードに転送されます。これは、成功基準のいずれかが満たされず、URL に代替番号が指定されている場合に発生します。

エラー

ユーザーにはエラー メッセージと、エージェントが利用できない理由を説明するメッセージ ヘルプセンターへのリンクが表示されます。また、トラブルシューティングにも役立ちます。

これは、成功基準のいずれかが満たされず、フォールバック番号が指定されていない場合に発生します。

エージェントの URL を作成する

URL は、GSMA RCC.07 v.14.0 の 3.6.3.4 に定義されている 2 つの形式で作成できます。

セキュリティ上の理由から、これらの形式では、URL 内にユーザー向けの候補を事前入力することはできません。

形式 1: サービス ID のみを使用する

   sms:bot%40botplatform.example.com?body=tell%20me%20about%20checking%20accounts
  • sms:bot%40botplatform.example.com: エージェント固有のサービス ID。
  • &body=tell%20me%20about%20checking%20accounts: エージェントとの RBM 会話を開いたときにユーザーに表示される、事前入力されたメッセージ（省略可）。

制限事項: この形式には、代替の電話番号を含めることはできません。RBM の会話を確立できない場合、お客様にはエラー メッセージが表示されます。

形式 2: 電話番号とサービス ID を使用する

   sms:+15012011657?service_id=bot%40botplatform.example.com&body=tell%20me%20about%20checking%20accounts
  • +15012011657: E.164 形式の電話番号、またはエージェントに関連付けられている有効なショートコード。
  • service_id=bot%40botplatform.example.com: エージェント固有のサービス ID。
  • body=tell%20me%20about%20checking%20accounts: エージェントとの RBM 会話を開いたときにユーザーに表示される、事前入力されたメッセージ（省略可）。

事前入力されたメッセージ

スムーズなユーザー エクスペリエンスを提供するために、RBM の会話が開かれたときにメッセージ入力フィールドに事前入力できます。これにより、ユーザーは送信ボタンをタップして、関連するメッセージをすばやく送信できます。

事前入力されたメッセージを含めるには、URL で body パラメータを使用します。body パラメータは URL エンコードする必要があります。たとえば、スペースは %20 に置き換える必要があります。

メッセージは、ユーザーの意図とブランドの目標に合致している必要があります。ウェルネス ブランドの例を次に示します。 sms:bot%40botplatform.example.com?body=make%20an%20appointment. ユーザーがこのリンクをタップすると、メッセージ アプリがチャットを開き、[予約する] というメッセージが事前に入力されます。

事前入力されたメッセージ

ベスト プラクティス

ブランドの資料に QR コードを組み込む場合は、必ずユーザーをエージェントの URL にリダイレクトする短いリンクを作成してください（例: https://short.link/abc123）。短縮 URL を使用するメリットは次のとおりです。

  • 将来に備えた対応: 必要に応じて、ショートリンクの背後にあるエージェント URL を更新できます。新しい QR コードで資料を再印刷する必要はありません。
  • シームレスなフォールバック: フォールバック オプションにリダイレクトされた場合に、ユーザーが URL に混乱しないようにします。