建構您的第一個代理程式

代理程式 代表品牌向使用者傳送訊息的程式輔助實體。這個代理程式包含使用者互動的任何介面，以及支援互動所需的任何程式碼或基礎架構。代理程式可以提供簡單的單向體驗，例如傳送通知，也可以進行對話，並在雙向互動中回應使用者的回應。

使用者可透過支援 RCS 的訊息應用程式 (例如裝置上的 Google 訊息) 與服務專員互動。在這個快速入門課程中，您將建立基本 RBM 服務專員，該服務專員可將簡單訊息傳送至測試裝置，並接收回應。

必要條件

開始使用服務前，您需要準備下列項目：

• 虛擬服務專員將代表的品牌名稱
• 你的服務專員
  • 名稱
  • 代理程式運作區域
  • 帳單類別
  • 用途
• 使用有效電話號碼的 Android 裝置
• 可執行程式碼範例的開發機器

設定測試裝置

如要與未啟動的 RBM 服務項目進行通訊，測試裝置必須支援 RCS，但並非所有 Android 裝置都能在預設情況下接收 RCS 訊息。你可以檢查裝置的 RCS 狀態，並視需要使用訊息和電信業者服務應用程式的預發布版本設定裝置，啟用 RCS。

查看裝置的 RCS 狀態

1. 在訊息應用程式中，輕觸「」按鈕，然後輕觸「設定」。

2. 輕觸「即時通訊功能」，然後找出「狀態」值。

   如果「狀態」顯示「已連線」，表示裝置已啟用 RCS。

後續步驟

如果裝置上已啟用 RCS，您就可以設定服務代理。如果裝置上未啟用 RCS，您必須先在裝置上啟用 RCS，才能測試 RBM 代理程式。

設定代理程式

RBM 代理程式會使用 RBM API 向使用者傳送訊息、事件和其他要求。建立代理程式時，您會啟用 RBM API 存取權，並定義代理程式的基本資訊。

找出服務專員所在的區域

RBM 服務專員可在北美洲、歐洲和亞太地區的其中一個區域中服務。RBM API 支援三個區域端點，協助企業遵守區域和業務規定。

建立服務專員時，請根據適用的法規、規定以及與使用者的距離，選擇服務專員的地區。這個地區會決定服務專員的運作位置，以及相關資料的儲存位置。

如果您或您的目標使用者不屬於這些地區，請選擇離您最近的區域，盡量縮短延遲時間。例如：

• 如果位於拉丁美洲，請選擇北美洲地區。
• 如果您位於非洲，請選擇歐洲區域。
• 如果您位於澳洲，請選擇亞太地區。

請勿根據目標電信業者決定服務專員的地區。所有區域都能使用全球電信業者的服務。

注意： 建立服務機器人後，就無法變更其所在區域。

判斷服務專員的帳單類別

建立 RBM 服務專員時，您必須根據服務專員與使用者的互動方式，指定其帳單類別。請選擇最符合代理程式預期行為的類別：

• 對話：適用於與使用者進行多輪對話的服務專員。
• 基本訊息或單一訊息：適用於不預期頻繁回覆的服務專員。

注意： 兩個非對話式帳單類別 (Basic Message 和 Single Message) 的運作方式完全相同。這是一種歷史上的奇特現象，我們正在努力簡化這項功能。目前，您可以將任何類別用於非對話式訊息，無論是純文字或互動式資訊卡。系統會向您收取標準非對話費率。詳情請參閱「代理程式計費類別」。

你只能在發布服務專員前變更其帳單類別。如果在推出後需要變更帳單類別，請傳送電子郵件至 [e-mail]。

如要進一步瞭解 RBM 結帳模式，請參閱 RBM 結帳常見問題。

找出服務專員的用途

每個 RBM 服務專員都必須有預先定義的用途。這有助於分類代理程式並套用正確的業務規則，提供良好的使用者體驗。RBM 支援四種用途：

• OTP：動態密碼是驗證帳戶或確認交易安全性所需的密碼。
• 交易：與客戶現有服務或產品直接相關的通知、更新或快訊，例如可疑帳戶活動快訊、購買確認和運送通知。
• 宣傳：向新客戶或現有客戶傳送銷售、行銷和宣傳訊息，以提高品牌知名度、參與度和銷售量。
• 多用途：結合交易和宣傳訊息的對話，例如傳送帳戶通知後，接著提供折扣優惠或升級至新產品或服務。

每種用途的傳送內容規則各有不同。如要進一步瞭解各個用途，並找出最適合您的服務機器人的用途，請參閱「為服務機器人選擇合適用途」。

提交服務專員以供啟用後，就無法變更用途。提交代理程式前，請先查看國家/地區的用途和業務規則。

建立代理程式

請按照這些操作說明，在 Business Communications 開發人員控制台中建立服務專員。

注意： 如要使用 RBM Management API 建立服務代理程式，請參閱「管理服務代理程式」說明文件。

如要建立代理程式，請按照下列指示操作：

1. 前往 Business Communications 開發人員控制台，然後使用 RBM 合作夥伴的 Google 帳戶登入。
2. 在首頁中按一下「+ 建立代理程式」。
3. 在「New RCS Business Messaging agent」視窗中，指定下列資訊：
   • 服務專員所代表的品牌
   • 服務專員名稱
   • 代管地區
   • 帳單類別
   • 用途
4. 按一下「建立服務專員」。

代理商上線後，你可以新增商家和品牌資訊。請參閱建立代理程式。

邀請測試裝置

有了服務專員，且測試裝置支援 RCS 後，您可以邀請裝置測試服務專員。

1. 在左側導覽面板中，按一下「裝置」。
2. 在「新增測試裝置」中，輸入裝置的電話號碼，然後按一下「新增」。
3. 在測試裝置上，接受服務專員的測試人員要求。

如果測試裝置未收到邀請，請確認裝置已啟用 RCS。

傳送訊息

有了註冊的測試裝置，你的服務專員現在就能傳送訊息。

您需要服務帳戶金鑰才能安全地驗證 API 呼叫。如果您尚未為合作夥伴帳戶建立服務帳戶金鑰，請立即建立。

在開發機器的終端機中執行下列指令：

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'

• 視服務專員的地區而定，將 REGION 替換為 asia、europe 或 us。
• 將 PHONE_NUMBER 替換為測試裝置的電話號碼。請加入國家/地區代碼、區碼和開頭的 +，但不要加入分隔符。例如：[phone]。
• 將 AGENT ID 替換為服務專員 ID，該 ID 位於 Business Communications 開發人員控制台的「服務專員資訊」頁面。
• 將 PATH_TO_SERVICE_ACCOUNT_KEY 替換為您先前建立的金鑰路徑。

您應該會在測試裝置上收到代理程式傳送的「Hello, world!」訊息。如果您未在測試裝置上收到訊息，請確認您在指令中正確輸入電話號碼和服務帳戶金鑰路徑，並且符合格式要求。

如要傳送不同類型的訊息 (例如建議回覆和互動式資訊卡)，請參閱「傳送訊息」。

後續步驟

代理程式現在可以傳送訊息到測試裝置，接下來請根據您的業務需求建立相關內容。取得偏好語言的範例代理程式，然後按照範例的 README 檔案中的操作說明進行。

設定範例代理程式後，請查看 RBM 的最佳做法，瞭解代理程式如何傳送及接收訊息。