Google Business Messages 功能將於 2024 年 7 月 31 日終止服務。請按這裡瞭解詳情。

本頁面由 Cloud Translation API 翻譯而成。

接收郵件

向商家註冊後訊息、即可代表測試員接收訊息你可以接收訊息 create、驗證並啟動為這些品牌打造更多代理程式

當客戶傳送訊息給您管理的代理商時，Business Messages 傳送 JSON 酬載至您的 Webhook，其中包含各種 ID、訊息內容和位置資訊。

使用 Business Communications 開發人員控制台記錄頁面即可對郵件傳送問題進行偵錯。

處理傳入訊息

服務專員如何處理及回應使用者的訊息掌握商業邏輯的表現一般而言，回應使用者的步驟訊息是否一致

確認訊息

如要確認 Webhook 收到的訊息，請傳回有效的 HTTP 回應傳送到您 Webhook 的訊息

如果訊息因傳送逾時而無法傳送、Webhook 可連性，重新導向或權限問題，Google 會儲存及轉寄訊息，多次重試，為期 7 天，或是直到 Webhook 成功收到撰寫新的電子郵件訊息

驗證訊息是否來自 Google

您應該確認訊息已傳送給 Google，然後再處理訊息內容。

為確認 Google 是否傳送了訊息，

剖析訊息的 X-Goog-Signature 標頭。這是經過雜湊處理的訊息內文酬載的 Base64 編碼副本，
使用用戶端憑證 (在設定 Webhook) 以金鑰的形式建立訊息酬載的 SHA512 HMAC base64 編碼結果。

注意： 如果您在向商家註冊時收到合作夥伴金鑰訊息，以該金鑰做為 SHA512 HMAC 的金鑰，而非用戶端產生下一個符記如果您更新 Webhook，請使用用戶端憑證傳送訊息進行驗證。
比較 X-Goog-Signature 雜湊與您建立的雜湊。
- 如果雜湊值相符，就表示 Google 已傳送訊息。
- 如果雜湊不相符，請檢查雜湊程序，瞭解已知的良好產品撰寫新的電子郵件訊息如果雜湊處理程序正常運作，而您收到或您認為是誤傳的郵件與我們聯絡 (您必須先 Google Business Messages Google 帳戶)。

查看 GitHub 存放區中 Echo 機器人的訊息驗證範例在 Java 中， Node.js、和 Python。

辨識語言代碼

使用者來自多個地區且使用多種語言溝通。Business Messages 代表使用者使用 resolvedLocale 和 userDeviceLocale 欄位，以孩子的裝置為依據語言代碼設定。請參閱本地化和語言代碼

請盡可能轉送郵件，或根據使用者的語言偏好設定。

根據內容轉送郵件

訊息情境會決定使用者可能正在尋找的資訊。舉例來說，如果使用者傳送含有 placeId敬上值時，他們已傳送訊息到特定位置 (透過 placeId 識別)，並已詢問與位置相關的問題同樣地，如果郵件包含 nearPlaceId 值，用於識別使用者附近的位置 (使用者可能) 想瞭解特定位置的相關資訊，但服務專員應確認也就是使用者在開始對話前想聊天的位置。

使用訊息的情境資訊，將訊息轉送至最佳位置適合回應：

如果郵件是出現在新的對話中，您遇到許多常見問題，您可以自動生成回覆
如果自動化功能無法處理問題，請將問題轉給真人服務專員。
如果訊息的語言代碼與代理程式的預設語言代碼不相符，請轉送訊息傳送給可以該語言代碼的真人服務專員。
如果問題與特定地點有關，請將該問題轉達給以下人員：提供該地點的相關資訊
如果訊息仍在對話中，請將訊息轉送給真人服務專員參與討論。

辨別使用者傳送的訊息類型

使用者可以傳送三種類型的訊息：

文字訊息屬於任意形式的回應。
圖片訊息包含使用者的已簽署圖片網址已上傳。
建議訊息包含回傳資料和以下文字的使用者輕觸的建議動作或建議回覆。

處理訊息內容

如果虛擬服務專員採用自動化機制，使用者訊息內容應將如何判斷對話中的代理程式邏輯和後續回應

要找出使用者意圖，最簡單的方法是運用來自好友的回傳資料，建議回覆或建議動作。無論建議，回傳資料可由機器讀取

如果使用者傳送簡訊，您的代理程式可能會剖析或採用自然語言理解 (例如 Dialogflow 整合處理使用者的訊息並找出路徑前進

如果服務專員不知道如何回覆使用者的訊息，傳回錯誤狀態，並嘗試按照提示使用者輸入其他資訊，或將對話交給真人服務專員。

回覆使用者

服務專員透過自動化或真人服務專員—會訊息然後繼續與使用者對話。

撰寫回應時，請考量使用者的語言代碼。您也可以從每個元素的 userInfo 物件中擷取值，藉此自訂回應收到的訊息。

訊息類型

以下程式碼顯示服務專員如何接收訊息。

如需格式設定和值的相關資訊，請參閱 UserMessage。

文字

使用者最常回覆的方法是使用純文字。簡訊使用的格式如下。

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "message": {
    "messageId": "MESSAGE_ID",
    "name": "conversations/CONVERSATION_ID/messages/MESSAGE_ID",
    "text": "MESSAGE_TEXT",
    "createTime": "MESSAGE_CREATE_TIME",
  },
  "dialogflowResponse": {
    "autoResponded": "BOOLEAN",
    "faqResponse": {
      "userQuestion": "USER_QUESTION",
      "answers": [{
        "faqQuestion": "FAQ_QUESTION",
        "faqAnswer": "FAQ_ANSWER",
        "matchConfidenceLevel": "CONFIDENCE_LEVEL",
        "matchConfidence": "CONFIDENCE_NUMERIC",
      }],
    },
  },
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

如需格式設定和值選項，請參閱： Message。

圖片

除了傳送簡訊外，使用者還能以訊息的形式將圖片傳送給服務專員。 Business Messages 儲存共用圖片的時間為 7 天，且須由已簽署網址並在訊息酬載的 text 欄位中納入這些網址。

如果代理程式包含自動化動作，請確保自動化動作知道如何回應當使用者分享圖片時如果是真人服務專員，請務必傳送圖片或訊息中的網址可點選

...
"message": {
    "text": "https://storage.googleapis.com/business-messages-us/936640919331/jzsu6cdguNGsBhmGJGuLs1DS?x-goog-algorithm\u003dGOOG4-RSA-SHA256\u0026x-goog-credential\u003duranium%40rcs-uranium.iam.gserviceaccount.com%2F20190826%2Fauto%2Fstorage%2Fgoog4_request\u0026x-goog-date\u003d20190826T201038Z\u0026x-goog-expires\u003d604800\u0026x-goog-signedheaders\u003dhost\u0026x-goog-signature\u003d89dbf7a74d21ab42ad25be071b37840a544a43d68e67270382054e1442d375b0b53d15496dbba12896b9d88a6501cac03b5cfca45d789da3e0cae75b050a89d8f54c1ffb27e467bd6ba1d146b7d42e30504c295c5c372a46e44728f554ba74b7b99bd9c6d3ed45f18588ed1b04522af1a47330cff73a711a6a8c65bb15e3289f480486f6695127e1014727cac949e284a7f74afd8220840159c589d48dddef1cc97b248dfc34802570448242eac4d7190b1b10a008404a330b4ff6f9656fa84e87f9a18ab59dc9b91e54ad11ffdc0ad1dc9d1ccc7855c0d263d93fce6f999971ec79879f922b582cf3bb196a1fedc3eefa226bb412e49af7dfd91cc072608e98"
  }
...

如需格式設定和值選項，請參閱： Message。

建議

建議回覆和操作建議可讓使用者回覆或執行您可以輕觸畫面來完成各項操作使用者輕觸建議時，代理程式會收到酬載當中包含建議文字和回傳資料

建議訊息使用以下格式。

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "suggestionResponse": {
    "message": "conversations/CONVERSATION_ID/messages/MESSAGE_ID",
    "postbackData": "POSTBACK_DATA",
    "createTime": "RESPONSE_CREATE_TIME",
    "text": "SUGGESTION_TEXT",
    "suggestionType": "SUGGESTION_TYPE",
  }
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

如需格式設定和值選項，請參閱： SuggestionResponse。

驗證要求

驗證要求建議可讓使用者以 OAuth 登入向服務專員提供身分詳細資料，或允許服務專員在使用者執行動作時請參閱透過以下服務進行驗證： OAuth。

如果使用者成功透過指定的 OAuth 供應商登入，代理程式就會會收到內含授權碼的酬載如果使用者未能在代理程式會收到包含錯誤詳細資料的酬載。

驗證要求訊息的格式如下。

{
  "agent": "brands/BRAND_ID/agents/AGENT_ID",
  "conversationId": "CONVERSATION_ID",
  "customAgentId": "CUSTOM_AGENT_ID",
  "requestId": "REQUEST_ID",
  "authenticationResponse": {
    "code": "AUTHORIZATION_CODE",
    "redirect_uri": "REDIRECT_URI",
    "errorDetails": {
      "error": "ERROR",
      "errorDescription": "ERROR_DESCRIPTION",
    },
  }
  "context": {
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
  },
  "sendTime": "SEND_TIME",
}

如需格式設定和值選項，請參閱： AuthenticationResponse。

訊息情境

每封郵件都包含來自郵件來源的情境資訊。

...
  "context": {
    "customContext": "CUSTOM_CONTEXT",
    "entryPoint": "CONVERSATION_ENTRYPOINT",
    "placeId": "LOCATION_PLACE_ID",
    "nearPlaceId": "NEARBY_LOCATION_PLACE_ID",
    "deflectedPhoneNumber": "DEFLECTED_PHONE_NUMBER",
    "resolvedLocale": "MATCH_OF_USER_AND_AGENT_LOCALES",
    "userInfo": {
      "displayName": "USER_NAME",
      "userDeviceLocale": "USER_LOCALE",
    },
    "widget": {
      "url": "WEBSITE_URL",
      "widgetContext": "WIDGET_CONTEXT",
    },
  },
...

欄位	說明
`customContext`	合作夥伴指定的背景資訊。
`entryPoint`	使用者發起對話的訊息途徑，定義如下 EntryPoint 製作。
`placeId`	Google 地方資訊資料庫中的地點專屬 ID 傳送要求這個文字只會顯示在來自特定地區的訊息進入點。
`nearPlaceId`	Google 地方資訊資料庫中的第一個安裝在「本機包」中的位置確認使用者想進行即時通訊的地點會在您收到 `nearPlaceId` 值時觸發。
`deflectedPhoneNumber`	Business Messages 禁止使用者撥打電話的電話號碼對話開始時
`resolvedLocale`	計算出來的使用者所屬地區最佳比對結果 (回報為 `userDeviceLocale`) 和代理程式支援的語言代碼 (取決於指定的對話設定)。詳情請見本地化和開始對話。語言代碼值是格式正確的 IETF BCP 47 語言代碼。
`userInfo.displayName`	傳送訊息的使用者名稱。如果使用者選擇不採用身分共用時，則這個欄位空白。
`userInfo.userDeviceLocale`	使用者裝置回報的語言代碼，而且格式正確 IETF BCP 47 語言代碼。
`widget.url`	推出對話式介面的網站網址。
`widget.widgetContext`	所用小工具的 `data-bm-widget-context` 屬性值即可開始對話

對話記錄

Google 不會提供對話記錄。保存資料記錄並遵循您的隱私權政策和最佳做法方便您日後向使用者傳送訊息。