請按照這份指南提供必要資訊，以便排除 RBM 相關問題。
訊息傳送和格式問題
這些是實際傳送和接收訊息時發生的問題，包括訊息格式問題。
無法傳送 RBM 訊息
請盡可能提供下列詳細資料，以便我們更快完成疑難排解：
- 含有時間戳記的郵件 ID 範例
- 合作夥伴 ID (請參閱螢幕截圖)
- 受影響的服務專員數量
- 服務專員 ID (以半形逗號分隔)
- 受影響或可能受影響的郵件數量預估
- 您遇到問題的 API 方法 (例如：上傳檔案、建立代理程式至使用者訊息、建立代理程式至使用者事件、刪除代理程式至使用者訊息、取得功能、批次取得)
- 失敗要求的 JSON 酬載範例
- 如有用戶端問題，請提交用戶端錯誤報告
錯誤記錄 (在終端呼叫 RBM API 時顯示的錯誤)，包括錯誤代碼和錯誤訊息。例如：
"error": { "code": 403, "message": "There was an error looking up the RBM agent (ID: my-test-agent@rbm.goog) that corresponds to the Google Cloud Platform (GCP) project you're authenticating with.", "status": "PERMISSION_DENIED", }未在 webhook 上收到事件或訊息
為確保順利傳送訊息，請確認所有合作夥伴帳戶的服務專員 webhook 是否正常運作，且能處理 Google 傳送的訊息。合作夥伴帳戶中的所有服務專員都會共用單一管道來接收訊息和事件，因此如果 webhook 發生故障，可能會影響所有服務專員的傳送作業。
如果問題仍未解決，請提供下列詳細資料，以便我們加快排解問題：
- 問題是從何時開始發生的？在此之前，您是否曾成功收到訊息和事件？
- 合作夥伴 ID
- 代理 ID
- Webhook 網址
- 含有時間戳記的郵件 ID
以 JSON 傳送或轉換為簡訊的 RBM 訊息
請盡可能提供下列詳細資料，以便我們更快完成疑難排解：
- 含有時間戳記的郵件 ID
- JSON 酬載
- 重現問題的裝置步驟 (如有)
- 接收訊息的裝置錯誤報告
- 裝置和使用的訊息應用程式版本詳細資料
- 問題發生時的螢幕截圖或錄影
無法在支援 RCS 的裝置上接收訊息
請盡可能提供下列詳細資料，以便我們更快完成疑難排解作業：
- 錯誤報告：來自未能接收 RBM 訊息的裝置
- 電話號碼
- 裝置和作業系統的詳細資料
- 使用的訊息應用程式版本
- 重現問題的步驟 (如有)
- 顯示 RCS 狀態的螢幕截圖
- 問題發生時的螢幕截圖或錄影
- 電信業者名稱和國家/地區
用戶端和裝置設定/連線問題
這些問題包括用戶端設定、連線和特定平台的問題。
無法產生 P2A 網址或 QR code
請盡可能提供下列詳細資料，以便我們更快完成疑難排解：
- 服務專員 ID
- Business Communications 開發人員控制台顯示的 JavaScript 錯誤詳細資料
無法開啟 RBM 深層連結
請盡可能提供下列詳細資料，以便我們更快完成疑難排解：
- 服務專員 ID
- 電話號碼
- 重現問題的步驟 (如有)
- 錯誤報告：從開啟連結的裝置提供
- 問題發生時的螢幕截圖或錄影
能力檢查問題
請提供以下詳細資料，以便我們加快疑難排解作業：
- 包含國家/地區代碼的電話號碼清單，並以 CSV 檔案格式封裝
- 代理 ID
- 錯誤記錄檔
- 裝置的 RCS 狀態
- 測試日期和時間
測試裝置未收到測試人員邀請或訊息
按照「設定測試裝置」中的步驟操作。
如果問題仍未解決，請提供下列詳細資料，以便我們加快排解問題：
- 服務專員 ID
- 電話號碼
- 含有時間戳記的訊息 ID
- 錯誤報告：在傳送測試邀請後的 5 分鐘內
iOS 裝置上的 RCS/RBM 問題
雖然 Apple 已採用進階通訊解決方案 (RCS) 訊息服務標準，但他們選擇自行開發獨特的實作方式。這包括 RCS Business Messaging (RBM) 等功能。
如果您在 iOS 裝置上遇到任何 RBM 問題，建議您直接透過「意見回饋小幫手」應用程式向 Apple 回報，以便 Apple 找出並解決任何特定實作問題。
- 在 iOS 裝置上開啟「意見回饋小幫手」應用程式。
- 選取與訊息應用程式相關的適當起始主題。
- 輸入並提交意見回饋。
- 為讓 RBM 支援團隊掌握最新資訊，請與我們分享您的發現結果。感謝你協助我們為所有人改善 RCS 體驗。
iOS 裝置上的 RCS/RBM 電信服務供應商支援情形
Apple 會自行選擇在 iOS 上推出 RCS/RBM 的電信業者。如要瞭解全球供應情形或 Apple 的未來計畫，請直接與 Apple 聯絡。你也可以聯絡感興趣的電信業者，瞭解他們在 iOS 上的 RCS/RBM 推出狀態。
如要瞭解各國家/地區的無線電信業者支援服務和 iPhone 功能，請造訪 Apple 支援頁面。
效能和顯示問題
以下是 RBM 效能和顯示相關的問題。
執行 RBM 動作的延遲時間
請務必先檢查下列項目：
| 問題 | 建議 |
|---|---|
延遲時間是否為 <5s？ |
則屬於可接受的範圍。 |
| 延遲時間是否有任何回歸情形？ | 如果是，請問何時開始？請問之前的延遲時間與現在相比有何差異？ |
| 您是否使用檔案上傳 API？ | 請改用檔案 ID，不要傳送直接網址。處理新媒體網址時，系統會執行下載、處理、縮圖、濫用行為防護和病毒防護等作業，其中約有 50% 的時間用於病毒防護。 |
| 你是否已事先上傳訊息媒體？ | 為加快處理速度，建議您使用下列 API 呼叫：https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/files/create |
| 是否已執行功能檢查？ | 如要降低傳送訊息給無法透過 RCS 聯絡的使用者所需的延遲時間，請先執行功能檢查。 |
如果問題仍未解決，請提供盡可能多的其他詳細資料，以便我們更快排除問題：
- 受影響的郵件數量
- 延遲的來源 (例如：上傳檔案、建立代理人傳送給使用者的訊息、建立代理人傳送給使用者的事件、刪除代理人傳送給使用者的訊息、取得功能、批次取得)
- 服務端點
- 延遲時間分布情形 (第 50、第 95 和第 99 百分位數)
- 延遲時間變化和時間範圍
- 合作夥伴 ID
- 受影響的服務專員 ID
- 含有時間戳記的郵件 ID
- JSON 酬載
輪轉介面和複合式資訊卡轉譯問題
這類問題的例子包括無法載入、顯示黑畫面、裁剪，以及建議動作未顯示。
請盡可能提供下列詳細資料，以便我們更快完成疑難排解作業：
- 含有時間戳記的郵件 ID
- JSON 酬載
- 重現問題的裝置步驟 (如有)
- 接收訊息的裝置錯誤報告
- 裝置和使用的訊息應用程式版本詳細資料
- 問題發生時的螢幕截圖或錄影
帳戶、代理人和電信業者管理問題
這些問題包括帳戶管理和報表問題，以及帳單查詢。
無法新增測試人員
按照「設定測試裝置」中的步驟操作。
如果問題仍未解決，請提供下列詳細資料，以便我們加快排解問題：
- 服務專員 ID
- 電話號碼
- 電信業者名稱和國家/地區
電信業者無法核准服務專員啟動
如需緊急啟動，請提供：
- 電信業者名稱和國家/地區
- 要啟動的服務專員 ID
- 電信業者的發布授權
要求更新服務專員詳細資料
請提供下列詳細資料，以便加快更新速度：
- 代理 ID
- 您要變更的詳細資料
- 確認是否要取消啟動服務專員
針對下列欄位，RBM 支援團隊會取消啟動代理程式。接著，您可以變更服務專員，並重新提交以啟用。
- 顯示名稱
- 說明
- 顏色
- 標誌和橫幅圖片
- 仲介聯絡資訊，例如電話號碼、網站和電子郵件地址
- 隱私權和服務條款
針對下列欄位，RBM 支援團隊會取消啟動代理程式，並修改這些欄位 (RBM 合作夥伴無法直接修改這些欄位)：
- 帳單類別
- 用途
- 品牌名稱
- 品牌聯絡人名稱
- 品牌聯絡人電子郵件 ID
- 公司行號網站網址
- 訊息合作夥伴聯絡人姓名
- 訊息合作夥伴聯絡電子郵件地址
如果您想在未停用服務專員的情況下修改服務專員資訊，請向目前已啟用服務專員的電信業者管理網路聯絡人取得電子郵件核准。收集到所有核准電子郵件後，請將這些郵件與 RBM 支援團隊分享，並提供所需修改的詳細資料。
RBM 支援團隊會驗證核准，如果一切正常，就會實施變更，並與您和相關的航空公司確認。請注意，這項程序可能會因不同國家/地區的電信業者程序而異。
要求變更 RBM 合作夥伴帳戶
如果 RBM 合作夥伴在電信業者管理的網路上啟用了任何服務專員，請按照下列步驟操作：
- 向運營商管理網路的聯絡人索取電子郵件核准，這些聯絡人是指你在其中推出任何服務專員的網路。
- 請將下列詳細資料提供給 RBM 支援團隊：
- RBM 合作夥伴 ID
- 您要變更的詳細資料
確認核准和詳細資料後，RBM 支援團隊會通知航空公司待處理的變更。我們會在運營商通知後的 24 小時內，實施並確認這些變更。
要求將服務專員從 RBM 合作夥伴 A 遷移至合作夥伴 B
如果服務專員已在電信業者管理的網路上啟用，請按照下列步驟操作：
- 向品牌聯絡人和電信業者管理的聯絡人索取電子郵件核准。
- 請務必將新 RBM 合作夥伴加入這些核准電子郵件的副本。
- 請將下列詳細資料提供給 RBM 支援團隊：
- 代理 ID
- 品牌聯絡人和電信業者的電子郵件核准
- 原始 RBM 合作夥伴 ID 和新的 RBM 合作夥伴 ID
確認核准和詳細資料後，RBM 支援團隊會通知航空公司待處理的變更。我們會在運營商通知後的 24 小時內，實施並確認這些變更。
要求將服務專員遷移至其他合作夥伴帳戶
請提供下列詳細資料，以便加快更新速度：
- 代理程式 ID 清單
- 舊合作夥伴 ID
- 新的合作夥伴 ID
帳單事件報表中缺少資訊
請提供以下詳細資料，以便我們加快疑難排解作業：
- 缺少檔案的日期
- 代理 ID