建立您的第一個代理程式

必要條件

建立代理程式

本指南將逐步引導您使用範例應用程式建立代理程式。此範例可讓您快速探索代理程式的功能，也能做為代理程式開發作業的起點。如果您要修改現有的應用程式，以包含代理程式，該範例可針對您的應用程式邏輯提供良好的模型。

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

  • 註冊成為合作夥伴
  • 建立品牌和代理商
  • 您可以選擇使用 Business Messages 小幫手機器人在對話中探索功能
  • 設定代理程式以收發訊息

如要在不使用範例的情況下建立代理程式，請參閱建立代理程式。

註冊成為合作夥伴

  1. 開啟 Business Communications Developer Console。
  2. 在「企業訊息」下方，按一下 [建立合作夥伴帳戶]。

  3. 輸入您的合作夥伴資訊：

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

  4. 詳閱並接受《Business Messages 服務條款》。

  5. 按一下「建立」。

您現已註冊為 Business Messages 合作夥伴。已為您建立新的 Google Cloud 專案，並啟用 Business Messages 和 Business Communications API。您沒有這項專案的存取權，因此不會影響任何現有的 Google Cloud 專案。

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

建立服務帳戶

  1. 在 Business Communications Developer Console 首頁中，按一下 [合作夥伴帳戶設定]。
  2. 在左側導覽面板中，按一下 [Service account] (服務帳戶)。

  3. 點選 [建立金鑰]，然後按一下 [建立]。

    您的瀏覽器會下載服務帳戶金鑰。請存放在安全的位置。您稍後需要使用這組金鑰來部署網頁應用程式，以及存取 Business Messages 和 Business Communications API。

建立品牌和代理商

代理程式是品牌的對話表示法，也就是使用者進行互動的對話實體。您必須建立可代表商家的品牌並建立代理程式，這樣消費者就能與商家對話。

  1. 開啟 Business Communications Developer Console，然後使用您的 Business Messages Google 帳戶登入。
  2. 按一下 [建立代理程式]。
  3. 在「Agent type」(代理程式類型) 部分，選取 [Business Messages]。
  4. 輸入「品牌名稱」和「代理程式名稱」的值。
  5. 執行下列其中一項操作：
    • 如要與代理程式進行對話來探索可用的功能，請選取 [Enable Business Messages Helper Bot]。
    • 如要自訂代理程式以處理訊息，請取消選取「Enable Business Messages Helper Bot」。
  6. 按一下 [建立代理程式]。

啟用 Business Messages 小幫手機器人後，您就可以立即發起對話。否則，請設定代理程式以進行訊息處理。

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

Business Messages 小幫手機器人可讓您與服務專員快速展開對話，以便體驗平台所提供的功能。建立 Agent 機器人時，不一定要啟用 Helper 機器人。

小幫手機器人可讓您

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

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

與小幫手機器人開始對話

啟用 Business Messages 小幫手機器人之後，即可發起對話。 代理程式建立完畢後，對話方塊會立即開啟，協助您快速上手。

如要與小幫手機器人互動，請在這個對話方塊中按照下列步驟操作：

  1. 存取代理程式的測試網址。您可以透過以下幾種方式進行設定：

    • 按一下 [Android] 按鈕或 [iOS] 按鈕。然後利用對應的行動裝置掃描 QR 圖碼，再按一下啟動。 您也可以按一下 [Copy Android URL] (複製 Android 網址) 或 [Copy iOS URL] (複製 iOS 網址)，以複製代理程式的測試網址。
    • 按一下 [傳送]，將網址傳送到您的電子郵件地址。

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

停用小幫手機器人

您必須先停用 Business Messages 小幫手機器人，才能自訂代理程式並準備發布。

如要停用小幫手機器人，

  1. 開啟 Business Communications Developer Console。
  2. 選取代理程式。
  3. 在左側導覽列中，按一下 [整合]。
  4. 針對「Helper Bot」，按一下 [Disable]。

小幫手機器人一旦停用，就不會再為代理程式收發訊息。您現在可以設定代理程式來處理訊息傳遞流程。

設定代理程式以處理訊息

本指南可協助您將 Echo Bot 部署到 Google Cloud Platform (GCP)，以及用於處理使用者訊息的 Webhook。

Echo Bot 是範例應用程式，回應訊息回應給使用者。這可讓您試用與服務專員的對話中的各種功能，例如建議動作和複合式資訊卡。您也可以使用 Echo Bot 做為開發代理程式的起點。

操作步驟如下：

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

完成本指南後，您的服務專員就可以開始收發郵件了。

將網頁應用程式部署至 GCP

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

建立雲端環境

您必須有雲端環境才能部署 Echo Bot 範例。

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

  1. 開啟 Google Cloud Console 專案選取器。

    如果您從未建立 Google Cloud 專案，則必須接受《服務條款》。

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

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

    • 系統會自動產生您的專案 ID，並顯示在專案名稱下方。
    • 在「位置」欄位中，按一下 [瀏覽] 以顯示專案的潛在位置。如果您找不到自己的 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 是您在建立雲端環境中建立的專案 ID。專案 ID 會列在 Google Cloud 的專案資訊主頁中。

    Java

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

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

    Python

    gcloud config set project PROJECT_ID
gcloud app create
gcloud app deploy

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

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

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

設定 Webhook

現在，Echo Bot 已部署完成，您必須指定 Webhook 網址 (用於營運)，才能開始接收訊息。

  1. 在 Business Communications Developer Console 中開啟「Account settings」(帳戶設定)。
  2. 確認已選取正確的合作夥伴帳戶。
  3. 針對「Business Messages Webhook URL」，按一下 [Configure]。

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

    您的端點會採用以下格式： https://PROJECT_ID.appspot.com/callback。

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

  5. 在開發人員控制台中按一下 [驗證]。

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

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

您可以使用 Business Messages 測試架構，測試 Webhook 是否成功回應 Business Messages 酬載。

輸入服務專員資訊

請提供幾項基本資訊，以便完成服務專員設定。

  1. 開啟 Business Communications Developer Console。
  2. 在左側導覽面板中，按一下 [代理程式資訊]。

  3. 視需要更新值，或使用下列建議：

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

  4. 按一下「儲存」。

發起對話

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

  1. 開啟 Business Communications Developer Console。
  2. 在左側導覽面板中，按一下 [代理程式資訊]。
  3. 在「代理程式測試網址」下方，點選 [Android] 按鈕或 [iOS] 按鈕。

  4. 使用對應的行動裝置掃描 QR 圖碼，或按一下 [複製 Android 網址] 或 [複製 iOS 網址]，以複製代理程式的測試網址。

    您也可以按一下 [傳送]，將網址傳送到您的電子郵件地址。

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

服務專員的歡迎訊息歡迎你。此時，您可以與 Echo Bot 互動會回歸您傳送給您的訊息。此外，您也可以傳送特定字串：「輪轉介面」、「資訊卡」和「方塊」，藉此叫用豐富的功能。

後續步驟

您已建立第一個代理程式，歡迎進一步瞭解 Business Messages 和您在平台上的其他功能。