設定 Webhook

Webhook 是由合作夥伴建立的 HTTPS 回呼,用於指定代理程式的方式 回應訊息和事件。除非您使用預先建構的自動化功能 Dialogflow 等解決方案 您必須先設定自訂 Webhook,才能定義代理程式的行為。

合作夥伴層級和服務專員層級的 Webhook

你可以在合作夥伴層級或服務專員層級設定 Webhook。 合作夥伴層級的 Webhook 適用於您維護的各個服務專員,而非服務專員層級的 每個 Webhook 都適用於個別代理程式。

如果您運作多個具有不同行為的代理程式,建議您設定 呼叫不同 Webhook另一部 如果你的服務專員有類似行為,或只有一個服務專員 可以使用夥伴層級的 Webhook

如果您同時設定了合作夥伴層級 Webhook 及服務專員層級的 Webhook, 代理程式層級的 Webhook 會優先於該代理程式的特定代理程式 合作夥伴層級 Webhook 適用於沒有服務專員層級的代理程式 Webhook。

設定夥伴層級的 Webhook

如要設定夥伴層級的 Webhook,請按照下列步驟操作:

  1. 開啟 Business Communications 開發人員控制台 然後使用 Business Messages Google 帳戶登入
  2. 開啟「帳戶設定」
  3. 確認已選取正確的合作夥伴帳戶。
  4. 在「Business Messages Webhook 網址」部分,按一下「設定」
  5. 在「Webhook 端點網址」部分,輸入應用程式的網址 +「/callback/」。 例如,目標網址可能類似「https://PROJECT_ID.appspot.com/callback/」。
  6. 記下 clientToken 值。因此,您需要驗證您收到的訊息是否來自 Google
  7. 將 Webhook 設定為接受 clientToken 參數,並傳送包含純文字的 200 OK 回應 做為回應主體。舉例來說,假設您的 Webhook 會收到含有以下內容的 POST 要求:

    {
    "clientToken":"SJENCPGJESMGUFPY",
      "secret":"0123456789"
    }
    

    在這種情況下,Webhook 應確認 clientToken 值,並 clientToken 正確,請傳回 200 OK 回應,並將 0123456789 做為 回應內文。

  8. 在控制台中按一下「驗證」。Business Messages 驗證 Webhook 後, 對話方塊就會關閉

設定服務專員層級 Webhook

你會透過合作夥伴層級的 Webhook 接收傳送給服務專員的訊息。如果發生以下情況: 希望特定服務專員的訊息改為傳送至不同的 Webhook 可以設定服務專員層級的 Webhook

  1. 開啟 Business Communications 開發人員控制台 然後使用 Business Messages Google 帳戶登入
  2. 按一下代理程式。
  3. 點選 [Integrations] (整合)。
  4. 在「Webhook」部分,按一下「設定」
  5. 在「Webhook 端點網址」部分中,輸入 Webhook 的網址 (開頭為 「https://」。
  6. 記下 clientToken 值。你必須開啟這項功能,才能驗證訊息 都來自 Google
  7. 將 Webhook 設定為接受 clientToken 參數,並傳送 200 OK 回應,並將 Secret 參數。舉例來說,假設您的 Webhook 收到 POST 要求 包含下列內文:

    {
      "clientToken":"SJENCPGJESMGUFPY",
      "secret":"0123456789"
    }
    

    在這種情況下,Webhook 應確認 clientToken 值,並 clientToken 正確,請使用密鑰網址傳回 200 OK 回應 參數已設為 0123456789

  8. 在控制台中按一下「驗證」。Business Messages 驗證 Webhook 後, 對話方塊就會關閉