エージェント情報の編集

エージェントを作成したら、エージェント情報を定義する必要があります。これは、エージェントを検証および起動するために送信する前に必須です。エージェント情報は、 APIまたはRCS for Business 開発者コンソールを使用して定義および編集できます。コンソールでタイルビューに切り替えると、エージェントのステータスが表示されます。

ヒント：エージェントのローンチステータスの最新の変更については、 「概要」をご覧ください。関連するすべての通信事業者におけるエージェントのローンチステータスの変更の詳細なリストについては、 「エージェント履歴」をご覧ください。

• 未完了：エージェントは作成され、ブランド名、エージェント名、ホスティング地域、請求カテゴリ、ユースケースなどの初期情報が提供されています。ただし、ローンチには追加情報が必要です。
• ローンチ準備完了：エージェントと確認に関するすべての詳細情報は提供されていますが、ローンチに関するアンケートおよび／または通信事業者の選択が保留中です。
• 発売準備中：エージェントは発売に向けて申請済みで、最終承認待ちです。
• 開始済み：エージェントは少なくとも1つの通信事業者で開始されています。

エージェントの認証情報を送信した後は、エージェント情報を編集することはできません。詳しくは、「エージェントの認証と起動」をご覧ください。

エージェント情報を編集する

以下の手順では、RCS for Business開発者コンソールでエージェント情報を編集する方法について説明します。RBM管理APIを使用してエージェントを編集することもできます。

1. RCS for Business開発者コンソールにアクセスし、パートナーのGoogleアカウントでサインインしてください。
2. ホームページで、リストから担当エージェントを選択してください。
3. サイドバーで「エージェント情報」を選択します。

4. 担当エージェント向けに以下の情報を入力してください。情報を入力すると、エージェントプレビューが自動的に更新されます。

   分野	説明	詳細
   表示名	ユーザーがエージェントとやり取りする際に表示される名前。通常はブランド名です。
   説明	ブランドの簡単な説明またはキャッチフレーズ。	以下のコンテンツは許可されていません。 スクリプトの内容 JSON HTML %2e|%2f|%5c|%25のような脱出 テンプレート OSパス Unixコマンド ネストされたスコープの例: {This is outer content (This is inner content)}または([another example {nested}])
   色	電話番号の上に表示される特定の要素の色。ブランドカラーに合わせてご利用ください。	白色（例：#E91B0C）に対するコントラスト比は最低4.5:1が必要です。詳細については、 「コントラスト比の確認」を参照してください。
   画像	エージェント用の画像。バナー画像はユーザーが貴社のビジネス情報を閲覧する際に表示され、ロゴはエージェントがユーザーにメッセージを送信する際に表示されます。	バナー画像：1440x448ピクセル。 ロゴ：224x224ピクセル。Googleメッセージでは、ロゴは角丸四角形で表示されます。ロゴが角丸四角形として正しく表示されるかどうかを確認するには、ロゴプレビューツールを使用してください。 エージェントのアップデート後、画像の公開URLを削除しても問題ありません。エージェントのアップデート処理中にコピーが保存されるためです。
   接触	ユーザーが問い合わせをする際に連絡できる主要な電話番号。	メールアドレスとウェブサイトが提供されていない場合は、必須項目です。 電話番号は、理想的にはE.164形式（ + [country code][subscriber number] ）である必要があります。市内番号およびフリーダイヤル番号の場合は、「+」、接頭辞、国番号、および特殊文字を除いた書式なし文字列（例：5554443333）も受け付けられ、内部的にE.164形式に変換されます。 ただし、エージェントの電話番号が標準のE.164形式で表現できない場合（例えば、インドの特定の1800番フリーダイヤル番号など）、プレースホルダーを入力し、 RCS for Businessサポートチームに連絡して手動処理を依頼してください。 複数の電話番号を追加するには、 「+ 電話番号を追加」をクリックします。
   	主要電話番号のラベル	例えば、カスタマーケア番号 カスタムラベルはGoogleメッセージでのみ表示されます。カスタムラベルに関する注意事項をご覧ください。
   	メインウェブサイト	電話番号とメールアドレスが提供されていない場合は、必須項目です。 複数のウェブサイトを追加するには、 「+ ウェブサイトを追加」をクリックしてください。
   	主要ウェブサイトのラベル	例えば、ABCのウェブサイト カスタムラベルはGoogleメッセージでのみ表示されます。カスタムラベルに関する注意事項をご覧ください。
   	メインメールアドレス	電話番号とウェブサイトが提供されていない場合は必須です。 そのメールアドレスが個人のアドレスであり、かつその人物がそのブランド組織の一員であることを確認してください。 複数のメールアドレスを追加するには、 [+ メールアドレスを追加]をクリックします。
   	メインメールのラベル	例えば、カスタマーケアメール カスタムラベルはGoogleメッセージでのみ表示されます。カスタムラベルに関する注意事項をご覧ください。
   プライバシーと利用規約	プライバシーポリシーと利用規約のURL。	RBMでエージェントを起動するには、以下の情報が必要です。利用規約とプライバシーポリシーの両方の有効なリンクが提供されていることを確認してください。

   重要： Googleが管理するローンチの場合、プライマリ電話番号、プライマリウェブサイト、またはプライマリメールアドレスのいずれかが提供されるまで、エージェントのローンチ申請はできません。申請にはいずれか1つのみが必要ですが、最適なユーザーエクスペリエンスのために3つすべてを提供することをお勧めします。ローンチ先の通信事業者が複数の連絡先情報を必要とするかどうかは、必ずご確認ください。
   警告：主要電話番号、主要ウェブサイト、主要メールアドレスのカスタムラベルは、Google メッセージでのみ使用されます。他の RCS クライアントでは、カスタムラベルが表示されず、代わりにデフォルトのラベル (例:「ウェブサイト」) が表示される場合があります。デバイス間で一貫したエクスペリエンスを提供するには、デフォルトのラベルを使用してください。

5. 「保存」をクリックしてください。

概要ページとエージェント情報ページでは、メッセージアプリでエージェントがどのように表示されるかをプレビューできます。

コントラスト比を確認してください

コントラスト比とは、2つの色のコントラストと識別しやすさを比較したものです。背景色と文字色など、2つの色のコントラスト比が高いほど、暗い場所やアクセシビリティに配慮が必要な方にとって読みやすくなります。WCAG 2.0では、テキストの最小コントラスト比を4.5:1と定めています。

WebAIMコントラストチェッカーなどのオンラインツールを使用すると、特定した薬剤の色が白に対して少なくとも4.5:1のコントラスト比を持っていることを確認できます。

ロゴのフォーマットとトリミング

視覚的に魅力的なロゴとヒーロー画像は、エージェントの信頼性とユーザーとのエンゲージメントを大幅に向上させることができます。ロゴがプロフェッショナルな印象を与えるよう、適切なフォーマットとトリミングになっていることを確認してください。見栄えの良いロゴを作成するためのヒントは以下のとおりです。

• ロゴ：

  • ロゴは、元の画像が長方形であっても、切り抜かれると角が丸みを帯びた正方形になることを覚えておいてください。そのため、ロゴが角が丸みを帯びた正方形に切り抜かれたときにどのように見えるかを必ず確認してください。
  • ロゴの周りの枠線については心配する必要はありません。ロゴ自体と重なることはありません。

• ヒーロー画像：

  • エージェントの情報とオプション画面に表示されるヒーロー画像は、ロゴと部分的に重なるため、視覚的に美しい仕上がりになるよう、それに合わせてデザインしてください。
  • ロゴと並べて正しく表示されるように、ヒーロー画像を45:14のアスペクト比で作成してください。

ロゴのヒント

• 画像にはトリミングのための十分な余白を残してください。ロゴが画像の高さと幅全体を占めている場合、ロゴの一部がトリミングされてしまうことがよくあります。

  練習する	良い例	悪い例
  スペーシングロゴ
  モックアップでロゴをトリミングする

• ロゴが適切かつ完全に表示されるように、画像の四辺すべてから等間隔に配置してください。

  練習する	良い例
  画像の境界線から等間隔にカットされたロゴ

• ヒーロー画像には45:14のアスペクト比を使用し、ロゴがヒーロー画像の一部と重なることに注意してください。

  練習する	良い例	悪い例
  ヒーロー画像には45:14のアスペクト比を使用する

• ヒーロー画像の縦横比が正しくない場合、画像の一部が切り取られてしまいます。その結果、見栄えの悪い画像になり、エージェントを適切に表現できなくなります。

  練習する	良い例	悪い例
  モックアップでヒーロー画像をトリミングする

• 透明度のある画像は避けてください。コントラストが不十分なロゴは、暗い背景に溶け込んでしまい、視認性が低下します。透明な背景がロゴに合わない場合は、白い背景を使用してください。

  練習する	良い例	悪い例
  ダークモードに遭遇

リソース

ロゴのデザインや問題解決に役立つ以下のリソースをご活用ください。

• 作成するエージェントロゴのベースとなるロゴテンプレート。

  ダウンロード： [PNG] [SVG]

  

• 作成するエージェントヒーロー画像のベースとなる、長方形のヒーロー画像テンプレート。

  ダウンロード： [PNG] [SVG]

  

• ロゴプレビューツール。

ロゴのURLを入力すると、ユーザーにどのように表示されるかを確認できます。

注：画像をホストするウェブサーバーは、他のウェブサイトへの画像の埋め込みを許可している必要があります。

既に活動中のエージェントの詳細情報を編集してください。

各通信事業者は、自社ネットワーク上で稼働するエージェントの承認責任を負います。最初の承認後、通信事業者は、エージェントの情報やアカウント所有権など、エージェントに対するその後の変更についても承認する必要があります。変更内容によっては通信事業者の請求レポートに影響が出る場合があるため、通信事業者が請求システムを更新するための十分な時間的余裕が必要です。

エージェントが通信事業者管理ネットワーク上で起動された後、RBMパートナーはRBMトラブルシューティングガイドに従ってエージェントの詳細情報の更新をリクエストできます。

次のステップ

エージェント情報を指定したら、テストデバイスを招待したり、メッセージを送信したり、 API リファレンスから他の呼び出しを行ったり、サンプルエージェントを使用したりすることができます。

セキュリティ上の理由から、RBMエージェントを削除することはできません。サポートが必要な場合は、 RBMサポートにお問い合わせください。