RBM 疑難排解指南

請按照本指南提供必要資訊，排解 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
  • 電話號碼
  • 重現問題的步驟 (如有)
  • 錯誤報告 從開啟連結的裝置取得
  • 問題發生時的螢幕截圖或螢幕錄影

功能檢查相關問題

請提供下列詳細資料，以便我們加快疑難排解速度：

  • CSV 檔案中包含國家/地區代碼的電話號碼清單
  • 代理商 ID
  • 錯誤記錄檔
  • 裝置的 RCS 狀態
  • 執行測試的日期和時間

測試裝置未收到測試人員邀請或訊息

按照「設定測試裝置」一文中的步驟操作。

如果問題仍未解決，請提供下列詳細資料，以便我們加快排解問題：

  • 代理 ID
  • 電話號碼
  • 含時間戳記的訊息 ID
  • 錯誤報告 在傳送測試邀請後 5 分鐘內

iOS 裝置上的 RCS/RBM 問題

雖然 Apple 採用了進階通訊解決方案 (RCS) 訊息服務標準，但他們選擇自行開發獨特的實作方式。這包括 RCS Business Messaging (RBM) 等功能。

如果在 iOS 裝置上使用 RBM 時遇到任何問題，建議您透過「意見回饋助理」應用程式直接向 Apple 回報。這有助於 Apple 找出並解決實作時遇到的問題。

  1. 在 iOS 裝置上開啟「意見回饋助理」應用程式。
  2. 選取與訊息應用程式問題相關的合適起始主題。
  3. 撰寫並提交意見回饋。
  4. 為讓 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
  • 電話號碼
  • 電信業者名稱和國家/地區

電信業者無法核准代理程式啟動

透過 RBM 管理控制台回報問題 (請參閱螢幕截圖)。

如要緊急發布，請提供：

  • 電信業者名稱和國家/地區
  • 要啟動的服務專員 ID
  • 電信業者授權發布

要求更新服務專員詳細資料

請分享下列詳細資料，以便我們更快提供更新：

  • 虛擬服務專員 ID
  • 要變更的詳細資料
  • 確認要取消發布代理程式

如要變更下列欄位，RBM 支援團隊會取消發布代理程式。然後變更服務專員，並重新提交以供發布。

  • 顯示名稱
  • 說明
  • 顏色
  • 標誌和橫幅圖片
  • 仲介聯絡資訊，例如電話號碼、網站和電子郵件地址
  • 隱私權和服務條款

如果修改下列欄位，RBM 支援團隊也會取消發布代理程式，並修改欄位 (RBM 合作夥伴無法直接修改這些欄位)：

  • 帳單類別
  • 用途
  • 品牌名稱
  • 公司聯絡人姓名
  • 公司聯絡人電子郵件 ID
  • 公司行號網站網址
  • 訊息合作夥伴聯絡人姓名
  • 訊息合作夥伴聯絡電子郵件地址

如要修改服務專員資訊，但不想取消發布服務專員，請先取得電子郵件核准，寄件者必須是服務專員目前發布所在電信商管理網路的聯絡人。收集所有核准電子郵件後，請將這些郵件連同所需修改的詳細資料，一併提供給 RBM 支援團隊。

RBM 支援團隊會驗證核准情形，如果一切正常，就會實作變更，並與你和相關電信業者確認。 請注意，這項程序可能會因不同國家/地區的個別電信業者程序而異。

要求變更 RBM 合作夥伴帳戶

如果 RBM 合作夥伴在電信業者管理的網路上啟用了任何服務專員，請按照下列步驟操作：

  1. 向電信業者管理的網路聯絡人取得電子郵件核准，以便在這些網路中啟動任何服務專員。
  2. 請將下列詳細資料提供給 RBM 支援團隊：

RBM 支援團隊會先確認核准和詳細資料，然後通知電信業者待處理的變更。這些變更將在收到貨運公司通知後的 24 小時內實施並確認。

要求將代理從 RBM 合作夥伴 A 遷移至合作夥伴 B

如果服務專員已在電信業者管理的網路上啟用，請按照下列步驟操作：

  1. 取得品牌聯絡人和電信業者管理網路聯絡人的電子郵件核准。
    • 請務必將新 RBM 合作夥伴副本加入這些核准電子郵件。
  2. 請將下列詳細資料提供給 RBM 支援團隊：
    • 代理商 ID
    • 品牌聯絡人和電信業者核准電子郵件
    • 新的合作夥伴 ID

RBM 支援團隊會先確認核准和詳細資料，然後通知電信業者待處理的變更。這些變更將在收到貨運公司通知後的 24 小時內實施並確認。

要求將服務專員遷移至其他合作夥伴帳戶

請分享下列詳細資料，以便我們更快提供更新：

  • 服務專員 ID 清單
  • 舊合作夥伴 ID
  • 新合作夥伴 ID

帳單事件報表缺少資訊

請提供下列詳細資料，以便我們加快疑難排解速度：

  • 缺少檔案的日期
  • 代理商 ID