网络钩子是合作伙伴创建的 HTTPS 回调,用于指定您的代理 响应消息和事件。除非您使用的是预构建的 解决方案,例如 Dialogflow, 您需要设置自定义 webhook 以定义代理的行为。
合作伙伴级和客服人员级网络钩子
您可以在合作伙伴级别或客服人员级别设置网络钩子。 合作伙伴级别的网络钩子适用于您维护的每个客服人员,而客服人员级别的网络钩子 每个网络钩子都应用于单个代理。
如果您运营的多个代理具有不同的行为,则可能需要设置 为每位客服人员设置不同的 webhook。另一个 如果您的客服人员有类似行为,或者您只有一个客服人员, 可以使用合作伙伴级网络钩子
如果您同时配置了合作伙伴级网络钩子和代理级网络钩子, 代理级别的 webhook 优先于其特定的代理,而 合作伙伴级别的网络钩子适用于没有客服人员级别的客服人员 webhook。
设置合作伙伴级网络钩子
如需设置合作伙伴级网络钩子,请按以下步骤操作:
- 打开 Business Communications 开发者控制台 并使用您的 Business Messages Google 账号登录。
- 打开账号设置。
- 请确保选择了正确的合作伙伴账号。
- 在 Business Messages 网络钩子网址部分,点击配置。
- 对于网络钩子端点网址,输入应用的网址 +“/callback/”。 例如,它可能类似于“https://PROJECT_ID.appspot.com/callback/”。
- 记下您的
clientToken
值。您需要使用它来验证收到的邮件是否来自 Google。 将您的 webhook 配置为接受带有指定
clientToken
参数,并发送包含纯文本的200 OK
响应 Secret 参数的值作为响应正文。例如,假设您的 webhook 会收到包含以下正文内容的 POST 请求:{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
在这种情况下,webhook 应确认
clientToken
值,如果clientToken
正确,则返回200 OK
响应,并将0123456789
作为 响应正文。在控制台中,点击验证。Business Messages 验证您的网络钩子后, 该对话框就会关闭。
设置代理级 webhook
您会在合作伙伴级网络钩子处收到发送给客服人员的消息。如果您 而是希望特定代理的消息到达其他网络钩子, 可以设置代理级别的 webhook。
- 打开 Business Communications 开发者控制台 并使用您的 Business Messages Google 账号登录。
- 点击您的代理。
- 点击集成。
- 对于网络钩子,点击配置。
- 在网络钩子端点网址部分,输入 webhook 的网址,以“https://”开头。
- 记下您的
clientToken
值。您需要使用它来验证 来自 Google 的邮件。 将您的 webhook 配置为接受带有指定
clientToken
参数,并发送 200 OK 响应(其中包含 Secret 参数。例如,假设 webhook 收到 POST 请求 正文内容如下:{ "clientToken":"SJENCPGJESMGUFPY", "secret":"0123456789" }
在这种情况下,webhook 应确认
clientToken
值,如果clientToken
正确,返回包含密钥网址的200 OK
响应 参数设为0123456789
。在控制台中,点击验证。Business Messages 验证您的网络钩子后, 该对话框就会关闭。