RCS for Business 疑難排解指南

請按照本指南提供必要資訊，排解 RCS Business Messaging 相關問題。

訊息傳送和格式問題

這些問題與訊息的實際傳輸和接收有關，包括訊息格式問題。

無法傳送 RCS 企業訊息

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

  • 附有時間戳記的郵件 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 格式傳送或轉換為簡訊的 RCS 企業訊息

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

  • 附有時間戳記的訊息 ID
  • JSON 酬載
  • 重現問題的裝置步驟 (如有)
  • 接收訊息的裝置所產生的錯誤報告
  • 所用裝置和訊息應用程式版本的詳細資料
  • 問題發生時的螢幕截圖或螢幕錄影

無法在支援 RCS 的裝置上接收訊息

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

  • 錯誤報告 來自無法接收 RCS Business Messaging 訊息的裝置
  • 電話號碼
  • 裝置和作業系統的詳細資料
  • 使用的訊息應用程式版本
  • 重現問題的步驟 (如有)
  • 螢幕截圖：顯示 RCS 狀態
  • 問題發生時的螢幕截圖或螢幕錄影
  • 電信業者名稱和國家/地區

用戶端和裝置設定/連線問題

包括用戶端設定、連線和平台專屬問題。

無法產生 P2A 網址或 QR code

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

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

  • 代理 ID
  • 電話號碼
  • 重現問題的步驟 (如有)
  • 錯誤報告 從開啟連結的裝置取得
  • 問題發生時的螢幕截圖或螢幕錄影

功能檢查相關問題

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

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

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

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

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

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

iOS 裝置上的 RCS/RBM 問題

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

如果 iOS 裝置上的 Google 商家即時通訊服務發生任何問題，建議您透過「意見回饋助理」應用程式直接向 Apple 回報，協助 Apple 找出並解決實作相關問題。

  1. 在 iOS 裝置上開啟「意見回饋助理」應用程式。
  2. 選取與訊息應用程式問題相關的合適起始主題。
  3. 撰寫並提交意見回饋。
  4. 為讓 RBM 支援團隊掌握最新情況，請與我們分享您的發現。感謝你協助改善全體使用者的 RCS 體驗。

iOS 裝置的 RCS/RBM 支援電信業者

Apple 會自行選擇在 iOS 裝置上推出 RCS/RBM 的電信業者。如要詢問全球供應情形或 Apple 的未來計畫，請直接與 Apple 聯絡。你也可以向感興趣的電信業者詢問 iOS 裝置的 RCS/RBM 推出狀態。

如要瞭解各國家/地區的 iPhone 無線電信業者支援和功能，請前往 Apple 支援頁面。

效能和顯示問題

這些問題與企業 RCS 的成效和顯示方式有關。

執行 RCS 商家訊息動作時的延遲時間

請務必先檢查下列事項：

問題 建議
延遲時間是 <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
  • 電話號碼
  • 電信業者名稱和國家/地區

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

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

如要緊急發布，請提供：

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

要求更新代理詳細資料

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

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

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

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

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

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

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

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

要求變更 RCS Business Messaging 合作夥伴帳戶

如果 RCS 企業即時通訊合作夥伴在電信業者管理的網路上啟用了任何代理程式，請按照下列步驟操作：

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

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

要求將代理程式從 RCS for Business 合作夥伴 A 遷移至合作夥伴 B

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

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

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

要求在貴公司的合作夥伴帳戶之間遷移代理商

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

  • 代理程式 ID 清單
  • 舊合作夥伴 ID
  • 新合作夥伴 ID
  • 在目前啟用服務專員的任何電信業者管理網路中，取得電信業者核准的電子郵件

帳單事件報表缺少資訊

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

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