在处理信息前拨打电话

每当客户提交输入时,预消息网络挂钩都会调用外部服务或应用程序。 外部服务可以先于助手处理信息。

AWS IBM Cloud 本地部署

如果您希望在助手处理每条新消息之前触发网络挂钩,请为助手添加一条预消息网络挂钩。

API 参考

您可以在以下用例中使用预发消息网络钩子:

  • 将客户的输入翻译成助理使用的语言。

  • 检查并删除客户可能提交的任何个人身份信息,如电子邮件地址或社会保险号。

您可以将此网络挂钩与消息后网络挂钩配合使用。 例如,消息后的网络挂钩可以执行一些操作,例如将响应翻译回客户的语言,或者添加因隐私原因而被删除的信息。 如需更多信息,请参阅 “处理消息后发起呼叫 ”。

注:

注意:在使用私有端点的环境中,请注意 Webhook 会通过互联网传输数据。

如果需要在对话期间执行一次性操作,请使用对话 webhook。 例如,当助手收集到所有必需的详细信息(如账号、用户 ID 和账户保密信息)时,就满足了条件。 如需了解更多信息,请参阅 《从对话框发起程序化调用》

定义 Webhook

您可以定义一个网络钩子 URL ,用于对每条传入消息进行预处理。

准备工作

对外部服务的程序性调用必须满足以下要求:

  • 请勿在部署了助手并与客户互动的生产环境中设置和测试 webhook。

  • 调用必须是 POST HTTP 请求。

  • 请求体必须是一个 JSON 对象(Content-Type: application/json)。

  • 呼叫必须在 30 秒或更短时间内返回。

注:

注意:如果您的外部服务仅支持 GET 请求,或者您需要在运行时动态指定 URL 参数,请考虑创建一个中间服务,该服务接受包含任何运行时值的 JSON 有效载荷的 POST 请求。 然后,中间服务可以向目标服务发送请求,将这些值作为 URL 参数传递,并将其响应返回给对话框。

选择部署方法

选择您使用的部署方法,查看设置消息后 webhook 的正确步骤。

要查看您正在使用的部署类型,请点击“管理 ”菜单 管理菜单。 如果您看到切换到经典体验 ,说明您正在使用新体验。 如果您看到 “切换到新体验” ,则表示您正在使用经典体验

注:

注意:此部署类型不适用于 watsonx Orchestrate

使用以下链接,根据您的部署类型了解相关程序: