このガイドに沿って、RBM の問題のトラブルシューティングに必要な情報を提供してください。
メッセージの配信と形式に関する問題
これらは、メッセージの実際の送信と受信に関する問題（メッセージの形式に関する問題など）です。
RBM メッセージを送信できない
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- タイムスタンプ付きのメッセージ ID の例
- パートナー ID（スクリーンショットを参照）
- 影響を受けたエージェントの数
- エージェント ID（カンマ区切り）
- 影響を受ける、または影響を受ける可能性があると推定されるメッセージの数
- 問題が発生している API メソッド（例: ファイルのアップロード、エージェントからユーザーへのメッセージの作成、エージェントからユーザーへのイベントの作成、エージェントからユーザーへのメッセージの削除、機能の取得、一括取得）
- 失敗したリクエストの JSON ペイロードの例
- クライアントの問題の場合: クライアントのバグレポート
エラーログ（RBM API の呼び出し時にターミナルに表示されるエラー）。エラーコードとエラー メッセージを含みます。次に例を示します。
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: [email protected]) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }Webhook でイベントやメッセージを受信しない
メッセージをスムーズに配信するには、パートナー アカウントのすべてのエージェント ウェブフックが正しく機能し、Google からのメッセージを処理できることを確認してください。パートナー アカウントのすべてのエージェントは、受信メッセージとイベントに単一のチャネルを共有するため、Webhook の誤動作により、すべてのエージェントの配信が中断される可能性があります。
問題が解決しない場合は、次の詳細情報を共有して、トラブルシューティングを迅速に進められるようにしてください。
- この問題が始まった時期は？それまではメッセージやイベントを正常に受信できていましたか？
- パートナー ID
- エージェント ID
- Webhook URL
- タイムスタンプ付きのメッセージ ID
JSON として送信されるか、SMS に変換される RBM メッセージ
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- タイムスタンプ付きのメッセージ ID
- JSON ペイロード
- デバイスでの再現手順（判明している場合）
- メッセージを受信しているデバイスのバグレポート
- 使用したデバイスとメッセージ アプリのバージョンの詳細
- 問題のスクリーンショットまたは動画
RCS 対応デバイスでメッセージを受信できない
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- RBM メッセージを受信できないデバイスのバグレポート
- 電話番号
- デバイスと OS に関する詳細
- 使用されたメッセージ アプリのバージョン
- 再現手順（判明している場合）
- RCS のステータスを示すスクリーンショット
- 問題のスクリーンショットまたは動画
- 携帯通信会社名と国
クライアントとデバイスのセットアップ/接続に関する問題
これらの問題には、クライアント側の設定、接続、プラットフォーム固有の問題が含まれます。
P2A URL または QR コードの生成に失敗する
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- エージェント ID
- Business Communications Developer Console に表示される JavaScript エラーの詳細
RBM ディープリンクを開けない
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- エージェント ID
- 電話番号
- 再現手順（判明している場合）
- リンクが開かれたデバイスからのバグレポート
- 問題のスクリーンショットまたは動画
機能チェックに関する問題
トラブルシューティングを迅速に行うため、以下の詳細を共有してください。
- 国コードを含む電話番号のリストを CSV ファイルに格納
- エージェント ID
- エラーログ
- デバイスの RCS ステータス
- テストの実施日時
テストデバイスでテスターの招待状やメッセージを受信できない
テストデバイスのセットアップの手順に沿って操作します。
問題が解決しない場合は、次の詳細情報を共有して、トラブルシューティングを迅速に進められるようにしてください。
- エージェント ID
- 電話番号
- タイムスタンプ付きのメッセージ ID
- テスト招待の送信から 5 分以内のバグレポート
iOS デバイスでの RCS/RBM の問題
Apple はメッセージ サービスにリッチ コミュニケーション サービス（RCS）標準を採用していますが、独自のユニークな実装を開発することを選択しています。これには、RCS ビジネス メッセージ（RBM）などの機能が含まれます。
iOS デバイスで RBM に関する問題が発生した場合は、フィードバック アシスタント アプリから Apple に直接報告することをおすすめします。これにより、Apple は実装に固有の問題を特定して対処できます。
- iOS デバイスでフィードバック アシスタント アプリを開きます。
- メッセージ アプリに関する問題に関連する適切な開始トピックを選択します。
- フィードバックを記入して送信します。
- RBM サポートチームにも状況を把握してもらうため、調査結果を Google と共有してください。皆様からのフィードバックは、RCS の利便性向上に役立てさせていただきます。
iOS デバイスで RCS/RBM を利用できる携帯通信会社
Apple は、iOS での RCS/RBM のリリースについて、独自の携帯通信会社を選択しています。グローバルでの提供状況や Apple の今後の計画については、Apple に直接お問い合わせください。また、ご利用の携帯通信会社に連絡して、iOS での RCS/RBM のリリース状況について問い合わせることもできます。
国別の iPhone のワイヤレス通信事業者サポートと機能については、Apple のサポートページをご覧ください。
パフォーマンスとディスプレイに関する問題
RBM のパフォーマンスと表示に関する問題です。
RBM アクションの実行時のレイテンシ
まず、以下の点を確認してください。
| 質問 | 推奨事項 |
|---|---|
レイテンシは <5s ですか？ |
その場合は、許容範囲内です。 |
| レイテンシに回帰は発生していますか？ | その場合、いつからですか？以前の一般的なレイテンシと現在のレイテンシを比較してください。 |
| ファイル アップロード API を使用していますか？ | 直接 URL を送信する代わりに、ファイル ID を使用してみてください。新しいメディア URL の処理には、ダウンロード、処理、サムネイル、不正使用対策、ウイルス対策が含まれます。このうち、ウイルス対策には約 50% の時間がかかります。 |
| メッセージ メディアを事前にアップロードしましたか？ | 処理を高速化するには、次の API 呼び出しを使用することをおすすめします。https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create |
| 機能チェックを実行しましたか？ | RCS で連絡できないユーザーにメッセージを送信する際のレイテンシを短縮するには、まずケーパビリティ チェックを実行します。 |
問題が解決しない場合は、トラブルシューティングを迅速に行うため、以下の詳細情報をできるだけ多くお知らせください。
- 影響を受けたメッセージの数
- レイテンシの原因（ファイルのアップロード、エージェントからユーザーへのメッセージの作成、エージェントからユーザーへのイベントの作成、エージェントからユーザーへのメッセージの削除、機能の取得、バッチ取得など）
- サービス エンドポイント
- レイテンシ分布（p50、p95、p99）
- レイテンシの変化と期間
- パートナー ID
- 影響を受けるエージェント ID
- タイムスタンプ付きのメッセージ ID
- JSON ペイロード
カルーセル カードとリッチカードのレンダリングに関する問題
この問題の例としては、読み込みの失敗、黒い画面の表示、切り抜き、提案されたアクションの非表示などがあります。
トラブルシューティングを迅速に行うため、以下の詳細をできるだけ多く提供してください。
- タイムスタンプ付きのメッセージ ID
- JSON ペイロード
- デバイスでの再現手順（判明している場合）
- メッセージを受信しているデバイスのバグレポート
- 使用したデバイスとメッセージ アプリのバージョンの詳細
- 問題のスクリーンショットまたは動画
アカウント、エージェント、携帯通信会社の管理に関する問題
アカウント管理とレポートに関する問題（請求に関する問い合わせなど）。
テスターを追加できない
テストデバイスのセットアップの手順に沿って操作します。
問題が解決しない場合は、次の詳細情報を共有して、トラブルシューティングを迅速に進められるようにしてください。
- エージェント ID
- 電話番号
- 携帯通信会社名と国
携帯通信会社がエージェントのリリースを承認できない
RBM 管理コンソールから問題を報告します（スクリーンショットを参照）。
緊急のリリースの場合、以下の情報をご提供ください。
- 携帯通信会社名と国
- 起動するエージェント ID
- 携帯通信会社のリリース承認
エージェントの詳細の更新リクエスト
アップデートを迅速に行うため、以下の詳細を共有してください。
- エージェント ID
- 変更する詳細
- エージェントのリリースを取り消すための確認
次のフィールドについては、RBM サポートチームがエージェントのリリースを取り消します。その後、エージェントに変更を加え、リリースに向けて再送信できます。
- 表示名
- 説明
- 色
- ロゴとバナーの画像
- エージェントの連絡先情報（電話番号、ウェブサイト、メールアドレスなど）
- プライバシーと利用規約
次のフィールドについては、RBM サポートチームがエージェントのリリースを解除し、フィールドを変更します（RBM パートナーはこれらのフィールドを直接変更できません）。
- 請求カテゴリ
- ユースケース
- ブランド名
- ブランドの連絡先名
- ブランドの連絡先メール ID
- ブランドのウェブサイトの URL
- メッセージ パートナーの連絡先名
- メッセージ パートナーの連絡先メールアドレス
エージェントのリリースを解除せずにエージェント情報を変更する場合は、エージェントが現在リリースされている携帯通信会社管理のネットワークの連絡先からメールによる承認を得ます。承認メールをすべて収集したら、必要な変更の詳細とともに RBM サポートチームに共有します。
RBM サポートチームが承認を確認し、すべてが整っている場合は、変更を実装して、お客様と各携帯通信会社に確認します。なお、このプロセスは国によって携帯通信会社の個別の手続きが異なる場合があります。
RBM パートナー アカウントの変更をリクエストする
RBM パートナーが携帯通信会社管理のネットワークでエージェントを起動している場合は、次の手順に沿って対応します。
- エージェントが起動される携帯通信会社が管理するネットワークの連絡先からメールで承認を得ます。
- RBM サポートに次の詳細情報を共有します。
- RBM パートナー ID
- 変更する詳細
承認と詳細を確認した後、RBM サポートチームは保留中の変更について携帯通信会社に通知します。これらの変更は、運送業者からの通知から 24 時間以内に実施され、確認されます。
RBM パートナー A からパートナー B へのエージェントの移行リクエスト
エージェントが携帯通信会社管理のネットワークですでに起動されている場合は、次の手順を行います。
- ブランドの担当者と、携帯通信会社が管理するネットワークの担当者からメールでの承認を得ます。
- 新しい RBM パートナーがこれらの承認メールにコピーされていることを確認します。
- RBM サポートに次の詳細情報を共有します。
- エージェント ID
- ブランドの担当者と携帯通信会社からのメールによる承認
- 新しいパートナー ID
承認と詳細を確認した後、RBM サポートチームは保留中の変更について携帯通信会社に通知します。これらの変更は、運送業者からの通知から 24 時間以内に実施され、確認されます。
エージェントを別のパートナー アカウントに移行するリクエスト
アップデートを迅速に行うため、以下の詳細を共有してください。
- エージェント ID のリスト
- 以前のパートナー ID
- 新しいパートナー ID
課金イベント レポートに情報が表示されない
トラブルシューティングを迅速に行うため、以下の詳細を共有してください。
- ファイルが見つからない日付
- エージェント ID