建立您的第一個代理程式

必要條件

建立虛擬服務專員

本指南將逐步說明如何使用範例應用程式建立代理程式。這個範例可讓您快速探索代理程式的功能，並做為開發代理程式的起點。如果您想修改現有應用程式，使其包含代理程式，該範例為應用程式邏輯提供了理想的模型。

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

  • 註冊成為合作夥伴
  • 建立品牌和虛擬服務專員
  • 視需要探索 Business Messages 對話中的功能 小幫手機器人
  • 設定服務專員來收發訊息

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

註冊成為合作夥伴

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

  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 開發人員控制台首頁，按一下「合作夥伴帳戶設定」。
  2. 在左側導覽面板中按一下 服務帳戶。

  3. 按一下「建立金鑰」，然後點選「建立」。

    瀏覽器會下載服務帳戶金鑰。妥善保存 或 HTTP/HTTPS 位置稍後需使用這組金鑰來部署網頁應用程式，並 以便日後存取 Business Messages 和 Business Communications API。

建立品牌和虛擬服務專員

服務專員是品牌 (對話式實體) 的對話型式 使用者與廣告互動的方式建立品牌來代表商家 建立服務專員，以便消費者與服務專員對話。

  1. 開啟業務通訊開發人員 控制台 然後使用 Business Messages Google 帳戶登入
  2. 按一下「Create agent」。
  3. 在「Agent type」部分，選取「Business Messages」。
  4. 輸入「Brand name」(品牌名稱) 和「Agent name」(代理程式名稱) 的值。
  5. 執行下列其中一項操作：
    • 如要體驗與虛擬服務專員對話，您可以探索 可用功能，請選取「啟用 Business Messages 小幫手機器人」。
    • 如要自訂服務專員並準備用於處理訊息，請取消選取 啟用 Business Messages 小幫手機器人。
  6. 按一下「Create agent」。

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

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

Business Messages 小幫手機器人可讓你與 讓您體驗平台提供哪些功能。啟用輔助程式 雖然機器人並非必要，但在建立第一個代理程式時強烈建議使用。

小幫手機器人可讓你

  • 探索豐富功能
  • 瞭解如何實作功能
  • 尋找設定虛擬服務專員的資源

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

與小幫手機器人開始對話

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

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

  1. 存取代理程式的測試網址。以下提供幾種方法：

    • 按一下「Android」按鈕或「iOS」按鈕。然後掃描 QR code 與相應的行動裝置整合，然後按一下 [啟動]。 或者，按一下「複製 Android 網址」或「複製 iOS 網址」即可複製 代理程式的測試網址
    • 按一下「傳送」，將網址傳送至您的電子郵件地址。

  2. 在行動裝置上開啟網址。(iOS 裝置必須使用 Google 地圖 app.)

停用小幫手機器人

你必須先完成下列事項，才能自訂虛擬服務專員並做好發布準備 停用 Business Messages 小幫手機器人。

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

  1. 開啟業務通訊開發人員 控制台。
  2. 選取代理程式。
  3. 點選左側導覽面板中的「Integrations」(整合)。
  4. 在「小幫手機器人」部分，點選「停用」。

小幫手機器人停用後，就不會再為以下產品/服務收發訊息： 代理程式您現在可以設定代理程式來處理 訊息流程

設定代理程式來處理訊息

在本指南中，您會使用 Webhook 是用來處理使用者訊息的 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 控制台專案選取器。

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

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

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

    • 系統會自動產生專案 ID，並顯示在專案名稱下方。
    • 在「位置」欄位中，按一下「瀏覽」，查看專案的潛在位置。如果找不到 Google Workspace 機構，表示您尚未登入 Google Workspace 帳戶。您可以在沒有機構的情況下建立專案，但部分功能會受到限制。詳情請參閱「機構資源的優點」一文。

  4. 按一下「建立」。

  5. 按一下「Menu」(選單) 。

  6. 按一下「帳單」。

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

  8. 請建立新的帳單帳戶，或在專案中加入現有的帳單帳戶。如要瞭解付款選項，請參閱 Google Cloud 免費計畫功能。

部署 Echo 機器人範例

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

  2. 下載並擷取 Echo Bot 範例 (Node.js、 Java、 Python)。

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

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

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

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

    Node.jsJavaPython
    gcloud config set project PROJECT_ID
    gcloud app create
    gcloud app deploy

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

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

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

    gcloud config set project PROJECT_ID
    gcloud app create
    gcloud app deploy

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

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

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

設定 Webhook

Echo Bot 已部署完成，您需要指定 Webhook 網址 ( 操作) 接收訊息。

  1. 開啟 帳戶設定 。
  2. 確認已選取正確的合作夥伴帳戶。
  3. 在「Business Messages Webhook 網址」部分，按一下「設定」。

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

    端點將採用下列格式： "https://PROJECT_ID.appspot.com/callback".

    這個端點會在範例的應用程式邏輯中預先定義 部署到 GCP

  5. 在 Play 管理中心按一下「驗證」。

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

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

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

輸入服務專員資訊

請提供幾項基本資訊，以完成代理程式設定。

  1. 開啟業務通訊開發人員 控制台。
  2. 點選左側導覽面板中的「服務專員資訊」。

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

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

  4. 按一下 [儲存]。

開始對話

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

  1. 開啟業務通訊開發人員 控制台。
  2. 點選左側導覽面板中的「服務專員資訊」。
  3. 在「Agent test URL」下方，按一下 [Android] 按鈕或 [iOS] 按鈕。

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

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

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

代理程式的歡迎訊息會問您。此時，您可以與 出現回音機器人並能回應您回傳的訊息。此外，您也可以 傳送「輪轉介面」、「資訊卡」、「晶片」等特定字串，叫用豐富功能。

後續步驟

您已建立第一個服務專員，請進一步瞭解 Business Messages 以及使用者可以對平台做些什麼