设置网络钩子

<ph type="x-smartling-placeholder">

网络钩子是合作伙伴创建的 HTTPS 回调，用于指定您的代理 响应消息和事件。除非您使用的是预构建的 解决方案，例如 Dialogflow， 您需要设置自定义 webhook 以定义代理的行为。

合作伙伴级和客服人员级网络钩子

您可以在合作伙伴级别或客服人员级别设置网络钩子。 合作伙伴级别的网络钩子适用于您维护的每个客服人员，而客服人员级别的网络钩子 每个网络钩子都应用于单个代理。

如果您运营的多个代理具有不同的行为，则可能需要设置 为每位客服人员设置不同的 webhook。另一个 如果您的客服人员有类似行为，或者您只有一个客服人员， 可以使用合作伙伴级网络钩子

如果您同时配置了合作伙伴级网络钩子和代理级网络钩子， 代理级别的 webhook 优先于其特定的代理，而 合作伙伴级别的网络钩子适用于没有客服人员级别的客服人员 webhook。

设置合作伙伴级网络钩子

如需设置合作伙伴级网络钩子，请按以下步骤操作：

  1. 打开 Business Communications 开发者控制台 并使用您的 Business Messages Google 账号登录。
  2. 打开账号设置。
  3. 请确保选择了正确的合作伙伴账号。
  4. 在 Business Messages 网络钩子网址部分，点击配置。
  5. 对于网络钩子端点网址，输入应用的网址 +“/callback/”。 例如，它可能类似于“https://PROJECT_ID.appspot.com/callback/”。
  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

您会在合作伙伴级网络钩子处收到发送给客服人员的消息。如果您 而是希望特定代理的消息到达其他网络钩子， 可以设置代理级别的 webhook。

  1. 打开 Business Communications 开发者控制台 并使用您的 Business Messages Google 账号登录。
  2. 点击您的代理。
  3. 点击集成。
  4. 对于网络钩子，点击配置。
  5. 在网络钩子端点网址部分，输入 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 验证您的网络钩子后， 该对话框就会关闭。