Business Communications 開發人員控制台

Business Messages 提供名為「Business Communications 開發人員控制台」的網頁使用者介面。您可以使用這個主控台來建立、管理及啟動代理程式。

Business Communications 開發人員控制台與 Google Cloud Platform 不同。 (GCP) 控制台。您可以使用 Business Communications 開發人員控制台管理 Business Messages 服務專員,同時使用 GCP 控制台管理 GCP 專屬設定 (例如帳單和 API) 和其他 GCP 資源。

雖然您可以使用 Business Communications 開發人員控制台建立及管理服務專員,但也可以使用 Business Communications API 建立及管理進階情境,例如與自有產品的整合項目。

快速入門導覽課程和使用指南會逐步引導您使用控制台和 API。本頁面會概略介紹使用者介面版面配置和控制台的用途。

主控台的使用方式

您可以透過這個控制台建立、管理、更新、驗證及啟動服務專員。 有了這項功能,您就能

控制台主畫面

一開始載入控制台時,您會看到代理程式選取畫面。 在該頁面中,「合作夥伴帳戶設定」連結會開啟您的合作夥伴帳戶設定頁面。

此外,主畫面的用途如下:

  • 選取現有的服務專員。
  • 建立新的服務專員。
  • 將服務專員排序。
  • 依合作夥伴帳戶篩選服務專員。

根據預設,服務專員會顯示在卡片檢視畫面中。代理程式會依上次更新的時間排序。如要變更為清單檢視,請使用右側的「View as」選項。在清單檢視畫面中,代理程式會按照名稱、類型、狀態和上次更新日期排序。

如果您有多個合作夥伴帳戶,可以使用合作夥伴帳戶下拉式選單來依合作夥伴帳戶篩選服務專員選項。

帳戶設定

在「設定」頁面中,您可以更新下列項目:

  • 商家名稱
  • 顯示名稱
  • 技術支援聯絡人
  • Webhook

在側邊導覽面板中,您可以存取品牌使用者管理以及服務帳戶

品牌管理

品牌是企業、機構或團體,服務專員是指品牌的對話方式。

使用這個頁面新增、編輯及移除品牌。如果移除品牌,所有相關聯的服務專員也會一併刪除。如果品牌與已啟用的服務專員相關聯,則無法移除。

使用者管理

這個頁面可讓你新增及移除已註冊合作夥伴帳戶的存取權。如要切換帳戶,請使用頂端導覽列的下拉式選單。

新增使用者

如要新增使用者,請在電子郵件地址輸入欄位中輸入對方的電子郵件地址,然後選取角色。

新使用者的角色可以是管理員讀取者。管理員角色可存取控制台中的所有功能,而讀取者角色可以為代理程式和位置資訊提供唯讀存取權。

新增使用者後,使用者會收到電子郵件通知,說明他們現在已可存取合作夥伴帳戶。

註冊合作夥伴帳戶的電子郵件地址具有擁有者角色。

移除使用者

如何移除使用者:

  1. 在清單中找出要移除的使用者。
  2. 按一下 按鈕。
  3. 選取「移除使用者」
  4. 確認移除。

你移除的使用者會收到電子郵件通知,說明他們已無法再存取該帳戶。

您無法移除具有擁有者角色的使用者。如要變更或移除擁有者,請與支援團隊聯絡。

變更使用者角色

如要更新使用者角色,請按照下列步驟操作:

  1. 找出要更新權限的使用者。
  2. 按一下 按鈕。
  3. 選取「編輯角色」
  4. 在下拉式選單中選擇新角色。
  5. 按一下「儲存」

服務帳戶

呼叫 Business Communications 和 Business Messages API 時,您必須使用服務帳戶金鑰來驗證呼叫。服務帳戶金鑰可讓您建立及管理品牌、代理程式和位置,也可以以代理程式的身分傳送訊息和要求。

如要產生服務帳戶金鑰,請選取側邊導覽列中的「Service accounts」(服務帳戶)。系統會開啟與目前所選合作夥伴帳戶相關聯的 GCP 專案 GCP 控制台。

如何建立服務帳戶和金鑰:

  1. 按一下「建立服務帳戶」
  2. 在「服務帳戶名稱」部分輸入代理程式名稱,然後按一下「建立」
  3. 點選「完成」
  4. 在表格中找到新的服務帳戶,然後依序按一下 >「Create key」(建立金鑰)
  5. 選擇「JSON」,然後按一下「Create」(建立)

瀏覽器會下載服務帳戶金鑰。

選取服務專員

選取代理程式之後,系統會將您帶往所選代理程式的「總覽」頁面。

總覽會顯示:

  • 公司行號名稱
  • 服務專員名稱
  • 建立服務專員時使用的合作夥伴帳戶
  • 公司行號 ID
  • 服務專員 ID
  • 代理程式測試網址,可讓您查看與這個代理程式的對話向使用者呈現的樣貌,並讓您有機會驗證訊息基礎架構
  • 服務專員驗證狀態
  • 服務專員預覽畫面
  • 與服務專員相關聯的地點
  • 相關說明文件的連結

左側導覽面板可讓您存取下列項目:

服務專員資訊

請使用服務專員資訊頁面,更新服務專員的屬性。

頁面分為兩欄。使用左欄中的輸入欄位來更新服務專員欄位,例如服務專員名稱、標誌、歡迎訊息、對話開頭句,以及位置和非本機進入點的屬性。啟動代理程式後,您就無法更新部分欄位,例如「Agent name」(代理程式名稱) 和「Logo」(標誌)

使用右欄取得服務專員的測試網址,預覽代理程式在使用者裝置上的外觀。

位置管理

請使用這個頁面新增地點、擷取商家所在地點的測試網址,並在驗證服務專員之後驗證地點。

整合

請在這個頁面中整合 Dialogflow,並設定機器人來回答常見問題。

問卷調查

使用這個頁面自訂服務專員的客戶問卷調查。

記錄檔

使用這個頁面為郵件傳送問題進行偵錯。記錄檔最長可保留 14 天。 依對話 ID、訊息 ID、時間戳記、方向或狀態進行篩選,尋找與使用者問題相關的記錄檔。您也可以查看這個頁面,確認是否有無意間傳送無效訊息。

記錄檔包含訊息酬載,但經過遮蓋的機密欄位 (例如訊息文字內容) 除外。失敗和遭拒的訊息還有其他錯誤詳細資料,可協助您偵錯。

某些事件 (例如輸入指標) 沒有提供收據,且狀態顯示為「已傳送」。

顯示「已放送」和「失敗」狀態的偵錯記錄

驗證

請使用這個頁面提交服務專員進行驗證

啟用

使用這個頁面啟動代理程式,查看位置和非本機進入點,以及啟動個別位置