建立您的第一個代理程式

必要條件

建立代理

本指南將逐步說明如何使用範例應用程式建立代理程式。這個範例提供快速探索代理程式功能的方法，並可做為代理程式開發的起點。如要修改現有應用程式以納入代理程式，這個範例可做為應用程式邏輯的良好模型。

在本快速入門導覽課程中，您將執行下列操作：

  • 註冊成為合作夥伴
  • 建立品牌和代理程式
  • 你也可以與 Business Messages 小幫手機器人對話，探索各項功能
  • 設定代理程式來收發訊息

如要建立代理程式而不使用範例，請參閱「建立代理程式」。

註冊成為合作夥伴

  1. 開啟商家通訊開發人員控制台。
  2. 在「Business Messages」下方，按一下「建立合作夥伴帳戶」。

  3. 輸入合作夥伴資訊：

    欄位 值
    您的姓名 您的全名
    合作夥伴名稱 貴機構的名稱
    合作夥伴網站 貴機構的網站
    區域 要託管 Business Messages 服務的區域

  4. 詳閱並接受《商家訊息服務條款》。

  5. 按一下「建立」。

你現在已註冊為 Business Messages 合作夥伴。系統已為您建立新的 Google Cloud 專案，並啟用 Business Messages 和 Business Communications API。您無法存取這個專案，且現有的 Google Cloud 專案不會受到任何影響。

您現在可以使用 Business Messages 和 Business Communications API。

建立服務帳戶

  1. 在 Business Communications 開發人員控制台首頁，按一下「合作夥伴帳戶設定」。
  2. 在左側導覽列中，按一下「服務帳戶」。

  3. 依序點選「建立金鑰」和「建立」。

    瀏覽器會下載服務帳戶金鑰。將其儲存在安全的位置。您稍後需要使用這個金鑰部署網頁應用程式，並存取 Business Messages 和 Business Communications API。

建立品牌和代理程式

服務專員可透過對話的方式塑造品牌形象，是使用者互動的對話實體。建立品牌代表商家，並建立服務專員，讓消費者透過對話與商家互動。

  1. 開啟 Business Communications 開發人員控制台，然後登入 Business Messages Google 帳戶。
  2. 點選「建立代理」。
  3. 在「代理程式類型」部分，選取「消費者訊息」。
  4. 輸入「品牌名稱」和「代理商名稱」的值。
  5. 執行下列其中一項操作：
    • 如要與服務專員展開對話，並探索可用功能，請選取「啟用 Business Messages 小幫手機器人」。
    • 如要自訂服務專員並準備處理訊息，請取消選取「啟用 Business Messages 小幫手機器人」。
  6. 點選「建立代理」。

如果已啟用 Business Messages 小幫手機器人，可以立即展開對話。否則，請繼續設定代理程式來處理訊息。

透過 Business Messages 小幫手機器人探索功能

Business Messages 小幫手機器人可讓你與服務專員快速展開對話，方便你體驗這個平台提供的服務。建立第一個代理程式時，建議啟用 HelperBot (選用)。

小幫手機器人可協助你

  • 探索豐富功能
  • 瞭解如何導入功能
  • 尋找代理程式設定資源

小幫手機器人會在啟用後為服務專員收發訊息，而且使用時不必設定 Webhook。如要設定 Webhook 或啟用 Dialogflow 來處理使用者訊息，請先停用小幫手機器人。

與小幫手機器人展開對話

啟用 Business Messages 小幫手機器人後，即可開始對話。建立代理程式後，系統會立即開啟對話方塊，協助您開始使用。

如要與 Helper Bot 互動，請按照下列步驟操作：

  1. 存取代理商的測試網址。方法有幾種：

    • 按一下「Android」或「iOS」按鈕。然後使用對應的行動裝置掃描 QR code，並按一下「啟動」。 或者，按一下「複製 Android 網址」或「複製 iOS 網址」，即可複製代理程式的測試網址。
    • 按一下「傳送」，系統就會將網址傳送至你的電子郵件地址。

  2. 在行動裝置上開啟網址。(iOS 裝置必須安裝 Google 地圖應用程式)。

停用小幫手機器人

如要自訂服務專員並準備發布，請先停用 Business Messages 小幫手機器人。

如要停用小幫手機器人，請按照下列步驟操作：

  1. 開啟 Business Communications 開發人員控制台。
  2. 選取代理程式。
  3. 在左側導覽列中，按一下「整合」。
  4. 如要停用「小幫手機器人」，請按一下「停用」。

小幫手機器人停用後，就不會再為服務專員收發訊息。現在可以設定代理程式來處理訊息流程。

設定代理來處理訊息

在本指南中，您將透過專為處理使用者訊息設計的 Webhook，將 Echo Bot 部署到 Google Cloud Platform (GCP)。

Echo Bot 是一個範例應用程式，會將訊息回傳給使用者。您可以在與代理程式的對話中，試用建議動作和豐富資訊卡等豐富功能。您也可以使用 Echo Bot 做為開發虛擬服務專員的起點。

請完成下列步驟：

  • 將 Echo Bot 範例部署至 GCP
  • 為 Business Messages 合作夥伴帳戶設定 Webhook 網址
  • 提供代理商的基本資訊

完成本指南後，代理程式就能傳送及接收訊息。

將網頁應用程式部署至 GCP

Business Messages 會將使用者的訊息轉送至基礎架構中的 Webhook。在本指南中，您會將 Echo Bot 範例原始碼部署至預先設定的 Webhook。如果您已有網路基礎架構可接收訊息，可以在該網路服務上建立新的 Webhook，但您必須自行設定邏輯。詳情請參閱「設定合作夥伴層級的 Webhook」。

建立 Cloud 環境

您需要雲端環境才能部署 Echo Bot 範例。

如要建立 GCP 專案做為雲端環境，請按照下列步驟操作：

  1. 開啟 Google Cloud 控制台專案選取器。

    如果您從未建立 Google Cloud 專案，請接受服務條款。

  2. 按一下 [建立專案]。

  3. 輸入新專案的名稱和位置

    • 專案 ID 會自動產生，並顯示在專案名稱下方。
    • 在「Location」(位置) 欄位中，按一下「Browse」(瀏覽)，即可顯示專案的可能位置。如果找不到 Google Workspace 機構，表示你尚未登入 Google Workspace 帳戶。您可以建立專案，不必加入機構，但部分功能會受到限制。詳情請參閱「機構資源的好處」。

  4. 按一下「建立」。

  5. 按一下「選單」圖示 。

  6. 按一下「帳單」。

  7. 按一下「連結至帳單帳戶」。

  8. 建立新的帳單帳戶，或將現有帳單帳戶新增至專案。如要瞭解付款方式，請參閱 Google Cloud 免費計畫功能。

部署 Echo Bot 範例

  1. 安裝 gcloud CLI。您將使用這個檔案，將範例程式碼部署至 Google Cloud。

  2. 下載並解壓縮 Echo Bot 範例 (Node.js、Java、Python)。

  3. 將您在「建立服務帳戶」中下載的 JSON 憑證檔案，複製到範例的資源資料夾，然後將憑證重新命名為「bm-agent-service-account-credentials.json」。這個憑證檔案的路徑取決於您下載的範例。

    Node.js

    ./bm-nodejs-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

    Java

    ./bm-java-echo-bot/full_sample/src/main/resources/bm-agent-service-account-credentials.json

    Python

    ./bm-python-echo-bot/full_sample/resources/bm-agent-service-account-credentials.json

  4. 在終端機中，前往範例的 full_sample 目錄。

  5. 在終端機中執行下列指令，部署範例：

    Node.js

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID 是您在「建立 Cloud 環境」中建立的專案 ID。專案 ID 會列在 Google Cloud 的專案資訊主頁。

    Java

    gcloud config set project PROJECT_ID
gcloud app create
mvn appengine:deploy

    PROJECT_ID 是您在「建立 Cloud 環境」中建立的專案 ID。專案 ID 會列在 Google Cloud 的專案資訊主頁。

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

    PROJECT_ID 是您在「建立 Cloud 環境」中建立的專案 ID。專案 ID 會列在 Google Cloud 的專案資訊主頁。

  6. 記下上一個指令輸出內容中已部署應用程式的網址。 這是 Webhook 網址的基礎：

    Deployed service [default] to [https://PROJECT_ID.appspot.com]

設定 Webhook

部署 Echo Bot 後，您需要指定 Webhook 網址 (由您操作)，才能開始接收訊息。

  1. 在 Business Communications 開發人員控制台中開啟「帳戶設定」。
  2. 確認選取的合作夥伴帳戶正確無誤。
  3. 點選「Business Messages Webhook 網址」旁的「設定」。

  4. 在「Webhook 端點網址」部分，輸入應用程式的網址 +「/callback」。

    端點格式如下：「https://PROJECT_ID.appspot.com/callback」。

    這個端點已預先定義在您部署至 GCP 的範例應用程式邏輯中。

  5. 在開發人員控制台中，按一下「驗證」。

    Business Messages 驗證 Webhook 後，對話方塊就會關閉。

如要透過 Business Communications API 設定 Webhook，請參閱「範例：更新 Webhook 網址」。

你可以使用商家訊息測試架構，測試 Webhook 是否能成功回應商家訊息酬載。

輸入代理人資訊

提供一些基本資訊，完成代理程式設定。

  1. 開啟 Business Communications 開發人員控制台。
  2. 按一下左側導覽列中的「Agent information」(代理商資訊)。

  3. 您可以隨意更新值，或參考下列建議：

    欄位 值
    歡迎訊息 歡迎使用 Echo Bot 對話！
    隱私權政策 https://policies.google.com/privacy

  4. 按一下 [儲存]。

開始對話

如要與 Echo 機器人互動，請按照下列步驟操作：

  1. 開啟 Business Communications 開發人員控制台。
  2. 按一下左側導覽列中的「Agent information」(代理商資訊)。
  3. 在「代理程式測試網址」下方，按一下「Android」或「iOS」按鈕。

  4. 使用對應的行動裝置掃描 QR code，或點選「複製 Android 網址」或「複製 iOS 網址」，複製代理程式的測試網址。

    你也可以按一下「傳送」，將網址傳送至你的電子郵件地址。

  5. 在行動裝置上開啟網址。(iOS 裝置必須安裝 Google 地圖應用程式)。

代理程式會傳送歡迎訊息。此時，您可以與 Echo Bot 互動。並將你傳送的訊息回傳給你。此外，你也可以傳送特定字串 (例如「輪轉介面」、「資訊卡」、「資料方塊」)，叫用豐富功能。

後續步驟

您已建立第一個服務專員，現在請進一步瞭解 Business Messages，以及您還可以在這個平台上執行哪些操作。