IBM Cloud Docs
电话集成配置

电话集成配置

IBM Cloud

为助手设置电话集成后,可以修改电话集成设置以定制呼叫行为。

处理呼叫和转移失败

您可以配置电话集成,以便在电话连接因任何原因中断时,将呼叫者转接到真人座席。 要将调用者自动传输到人员,请转至电话集成设置中的 高级 选项卡,并进行以下配置选择:

  • 呼叫失败时的 SIP 目标:添加支持座席服务的 SIP 端点。 为通用呼叫队列指定可将请求重定向到其他队列的 SIP 或电话 URI。 有关更多信息,请参阅 配置备份服务台解决方案

  • 调用失败消息: 添加您希望助手在将调用传输到实时代理之前对调用者说的话的消息。

如果您将呼叫转接给真人客服,但出于某种原因无法与真人客服建立连接,您可以设置如何处理。

  • 传输失败消息: 如果传输到实时代理程序失败,请将您希望助手向调用者说明的消息添加到该消息。 信息长度不得超过150个字符。

  • 转移失败时断开通话:选择是否在出现失败信息后断开通话。 缺省情况下,此选项已启用。 如果禁用此选项,那么当呼叫转移失败时,助手可以断开连接或处理其他操作。

    如果在传输失败的情况下选择保持呼叫连接,那么 watsonx Assistant 将启动新的轮次以确定下一步。 使用可处理此场景的“操作”或 "Webhook" 来配置“助手”很重要。

电话集成通过提供对其他区域执行快速故障转移的能力来支持灾难恢复,而不是在发生服务中断时将呼叫路由到实时代理程序。 这是通过向上游 SIP 中继提供者发送 SIP 503 响应来完成的,而不是在呼叫设置期间发生故障时自动将呼叫引用到实时代理。 然后,SIP 中继提供者可以使用此 503 响应将呼叫重新路由到另一个区域。 如果要利用此功能,请针对需要灾难恢复的 watsonx Assistant 服务实例开具服务凭单。

保护电话连接

通过转至电话集成设置中的 高级选项 选项卡,并选择下列其中一个或两个选项,可以向电话连接添加安全性:

  • 强制安全中继:选择此选项可使用安全实时传输协议(SRTP)来保护通过电话传输的音频。 有关 RTP 的更多信息,请参阅呼叫路由详细信息

  • 启用 SIP 认证: 如果要需要 SIP 摘要认证,请选择此选项。

    当需要 SIP 认证时,所有入站流量 (表示从 SIP 提供程序到助手的请求) 都将使用 SIP 摘要认证进行认证,并且必须使用传输层安全性 (TLS) 发送。 如果选择此选项,那么必须配置 SIP 摘要用户名和密码,并且必须将用于连接到 Assistant 的 SIP 中继配置为仅使用 TLS。

    如果使用 Twilio 作为 SIP 中继提供程序,那么无法对到 watsonx Assistant的出站 SIP 中继启用 SIP 认证。

应用高级SIP中继配置设置

要配置助手如何从外部提供者与 SIP 干线进行交互,请转至电话集成设置中的 SIP 干线 选项卡,并更新 SIP 干线集成 部分中的以下选项:

  • 要抽取的 SIP INVITE 头: 列出希望助手使用的头。

    SIP INVITE 请求可以在头中包含有关调用的元数据,这些头可以使用上下文变量抽取并发送到助手。 例如,许多公司使用交互式语音应答(IVR)系统,通过SIP报头传递来电信息。 如果要使用其中任何头,请在此处列出头名称。

    指定的头 (如果存在于请求中) 与从 SIP INVITE 自动抽取的其他相关元数据一起存储在上下文变量 sip_custom_invite_headers 中。 此变量是一个数组,其中每个键/值对都表示来自请求的头,如以下示例中所示:

    {
      "input": {
        "text": "",
          ...
      },
      "context" : {
        "global" : {...},
        "skills" : {...},
        "integrations" : {
          "voice_telephony": {
            "private":{
              "user_phone_number":"+18594213456",
            },  
            "sip_call_id": "Aob2-2743-5678-1234",
            "assistant_phone_number":"+18882346789",
            "sip_custom_invite_headers": {
              "X-customer-name": "my_name",
              "X-account-number": "12345"
            }
          }
        }
      }
    }
    

    然后,可以在助手中引用这些头。 例如,您可以在步骤条件中检查头值以确定下一步。 您还可以在搜索助手日志时使用这些头; 例如,您可以搜索定制头以查找与特定帐户关联的所有消息。

  • 禁用呼叫者在联系助手时听到的铃声:选择是否要呼叫者听到提示正在联系助手的信号。

    助手处理入局呼叫邀请时,会将 180 Ringing响应从助手发送回 SIP 中继提供者。 缺省情况下会发送“正在响铃”响应。

  • 转接到实时座席时不将呼叫者挂起:选择电话集成是否将呼叫者挂起。

    如果是 SIP 中继提供者管理挂起,请禁用此功能。 例如,某些 SIP 中继提供者希望助手发送 SIP REFER 请求,以便他们可以自己将呼叫挂起。

有关SIP协议的更多信息,请参阅 RFC 3261 ;有关RTP协议的更多信息,请参阅 RFC 3550

配置备份服务台解决方案

当您将电话集成作为客户的第一线援助时,最好有现场代理作为后备。 您可以设计助理,在电话连接失败或用户要求与某人通话时,将电话转接给真人。

贵公司可能已经有一个或多个连接到自动呼叫分配器(ACD)的电话号码,该号码可以将呼叫者排队等候,直到有合适的接线员接听。 如果没有,请选择一个服务台解决方案作为备份。

交谈无法从一种集成类型转接到另一种集成类型。 例如,如果使用与服务台支持的 Web 聊天集成,那么无法将电话转接到为 Web 聊天设置的服务台。

您必须为您使用的服务台支持解决方案提供服务台 SIP URI。 当您从对话节点或操作步骤启用呼叫转移时,必须在助手中指定此信息。 有关更多信息,请参阅 将呼叫转移到实时代理

优化行动,实现电话互动

为了获得最佳的客户体验,设计对话时请考虑电话集成的功能:

  • 请勿在操作响应中包含HTML元素。 要添加格式,请使用 Markdown。 有关更多信息,请参阅 格式化响应

  • 您可以使用搜索扩展将搜索结果包含在电话集成将读取的操作中。 返回搜索结果时,电话集成将读取介绍性消息 (例如,I found this information that might be helpful),然后仅读取第一个搜索结果的主体。

    整个搜索响应(即介绍性信息加上第一个搜索结果的正文)不得超过5000个字符,否则将无法阅读。 请确保测试返回的搜索结果,并根据需要整理使用的数据集合。

有关使用搜索集成的更多信息,请参阅 利用现有帮助内容

有关如何执行对话中的常见操作,请参阅 处理电话交互

创建 SIP 干线

如果不使用该选项来生成免费电话号码,那么必须设置电话集成所使用的 SIP 中继。 查找提供者并创建 SIP 中继帐户,您必须为该帐户按使用量付费。

您可以通过以下方式设置 SIP 干线:

设置 Twilio SIP 干线

在开始设置 Twilio SIP 中继之前,请执行以下先决条件步骤:

如果已创建 SIP 干线,请遵循 配置 SIP 干线 中的步骤。

创建 SIP 干线

  1. 登录您的Twilio控制台,进入弹性SIP中继部分

    注意:如果您没有看到弹性SIP中继,请执行以下操作:

    1. 在搜索栏中搜索 Elastic SIP Trunking
    2. 单击 弹性 SIP 中继仪表板
  2. 在左侧导航菜单中,进入概述,点击开始

  3. 在“后备箱” 导航栏中点击 “新建后备箱”。

  4. “友好名称”字段中输入SIP中继的名称。

  5. 点击创建按钮。 创建新后备箱后,系统将分配一个 后备箱 SID

对于 SIP 干线的配置,请遵循 配置 SIP 干线 中的步骤。

配置 SIP 干线

要配置 SIP 干线,请执行以下操作:

  1. 从“弹性 SIP 中继仪表板”页面,转至 弹性 SIP 中继

  2. 点击左侧导航菜单中的 “管理”。

  3. 单击 Trunks,然后选择您创建的 SIP 干线。

  4. 点击 “来源” 进行设置。

  5. 要添加起始 SIP URI,请点击 “添加新的起始 URI”按钮,并为以下字段提供值:

    • 发起 SIP URI- 您可以在 watsonx Assistant 的电话集成配置页面上获取用于电话集成的 SIP URI。 watsonx Assistant执行此操作,请启动工具和创建助手。 选择 添加集成,然后选择 电话。 从助手中,复制 SIP URI 并将其粘贴到 Twilio 的 源 SIP URI 字段中。
    • 优先级-优先级对 URI 的重要性进行排序。 较小的数字表示最高的重要性。
    • 权重-当多个 URI 具有相同的优先级时,权重用于确定负载的份额。 值越高,提供的 URI 负载越高。
    • 已启用-您需要将 已启用 切换开关切换到 Yes。 这意味着已启用发起 SIP URI。
  6. 如果计划支持呼叫转移,请在 SIP 中继中启用呼叫转移 (SIP REFER)。 如果您希望将呼叫转移到公共交换电话网 (PSTN),请在干线上启用 PSTN 传输。

  7. 从导航栏中选择您的SIP 中继号码,然后执行以下操作之一:

    1. 单击 添加数字,然后单击 购买数字*。
    2. 如果您已有数字,那么可以单击 添加数字,然后单击 添加现有数字

如果是将轻量或试用 Twilio 帐户用于测试,请确保验证转接目标。 更多信息,请参阅 Twilio 文档

如果选择将 Twilio 作为 SIP 中继提供者,那么无法启用 SIP 认证。 Twilio 不支持对使用 SIPS 发起呼叫。

使用其他第三方提供者

您可以通过开具支持请求来要求帮助设置其他 SIP 中继提供者的帐户。

IBM 已与以下 SIP 中继提供者建立关系:

SIP 中继提供者设置 SIP 中继来处理语音流量,并管理从允许的 IP 地址进行的访问。 大多数主要 SIP 中继提供者都与 IBM 存在现有关系。 因此,通常可以极其轻松地为您处理支持 SIP 中继连接所需的网络配置。

  1. 创建 IBM Cloud 案例

  2. 主题 字段中,输入 watsonx Assistant

  3. 子主题 下拉列表中,选择 Phone & SMS Integration

  4. 主题 字段中,输入 SIP trunk provider setup for watsonx Assistant

  5. 在描述中包含以下信息:

    • 公司名称
    • 您的 IBM Cloud 帐户标识
    • 您的 watsonx Assistant 服务名称
    • 网络图,其中包含 IP 地址或 SIP 中继提供者信息

自带 SIP 干线

如果选择使用 IBM 未与之建立关系的 SIP 中继运营商,那么可以执行此操作。

下表列出了用于 SIP 连接的标准域名和 IP 地址。

SIP 网络信息
地区 域名 IP 地址
达拉斯 public.0001.voip.us-south.assistant.watson.cloud.ibm.com
public.0002.voip.us-south.assistant.watson.cloud.ibm.com
public.0003.voip.us-south。assistant.watson.cloud.ibm.com
67.228.108.82
169.63.5.162
150.239.30.146
法兰克福 public.0001.voip.eu-de.assistant.watson.cloud.ibm.com
public.0002.voip.eu-de.assistant.watson.cloud.ibm.com
public.0003.voip.eu-de。assistant.watson.cloud.ibm.com
161.156.178.162
169.50.56.146
149.81.86.82
伦敦 public.0001.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0002.voip.eu-gb.assistant.watson.cloud.ibm.com
public.0003.voip.eu-gb.assistant.watson.cloud.ibm.com
158.176.120.162
141.125.102.34
158.175.99.34
首尔 public.0001.voip.kr-seo.assistant.watson.cloud.ibm.com
悉尼 public.0001.voip.au-syd.assistant.watson.cloud.ibm.com
public.0002.voip.au-syd.assistant.watson.cloud.ibm.com
public.0003.voip.au-syd。assistant.watson.cloud.ibm.com
168.1.47.2
135.90.86.50
168.1.106.130
东京 public.0001.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0002.voip.jp-tok.assistant.watson.cloud.ibm.com
public.0003.voip.jp-tok。assistant.watson.cloud.ibm.com
165.192.69.82
128.168.105.178
161.202.149.162
华盛顿特区 public.0001.voip.us-east.assistant.watson.cloud.ibm.com
public.0002.voip.us-east.assistant.watson.cloud.ibm.com
public.0003.voip.us-east。assistant.watson.cloud.ibm.com
52.116.100.158
169.61.70.162
169.59.136.194

从 Voice Agent with Watson 迁移

如果在 IBM Cloud 中创建了 IBM® Voice Agent with Watson 服务实例以使客户能够通过电话连接到助手,请考虑改为使用电话集成。 您可以使用配置为在电话集成中与 Voice Agent with Watson 配合使用的相同 SIP 帐户和电话号码。

电话集成提供了与助手的更无缝集成。 但是,集成当前不支持以下功能:

  • 出站调用
  • 配置备份位置
  • 用于在 IBM Cloudant for IBM Cloud 数据库服务中保存呼叫详细报告的事件转发
  • 查看使用情况摘要页面。 请改为使用 IBM Log Analysis。 有关更多信息,请参阅查看日志

要从 Voice Agent with Watson 迁移到 watsonx Assistant 电话集成,请完成以下步骤:

  1. 从 Voice Agent with Watson 页面,复制用于 SIP 帐户的电话号码。

  2. 设置 watsonx Assistant 电话集成时,请添加您在上一步中复制的电话号码或号码集。

  3. 从电话集成设置页面,复制 SIP 统一资源标识 (URI)。

  4. 在 SIP 干线帐户中,将先前指定的 Voice Agent with Watson URI 替换为先前步骤中从电话集成设置页面复制的 URI。

    例如,如果使用 Twilio SIP 干线,那么会将助手的 SIP 统一资源标识 (URI) 添加到 Twilio 源 SIP URI 字段。

  5. 如果 SIP 中继提供者尚未随您要迁移到的 watsonx Assistant 区域一起列出,请遵循以下 指示信息 以获取对 SIP 中继的访问权。

呼叫路由详细信息

向助手发出的入局呼叫遵循以下路径:

  1. 客户呼叫由会话发起协议 (SIP) 中继提供者管理的客户支持电话号码。

  2. SIP中继服务会向您的助手的手机发送SIP INVITE 请求,以建立连接。

  3. 电话集成连接到支持交互所需的语音服务。

  4. 服务准备就绪后,将建立连接,并通过实时传输协议 (RTP) 发送音频。

    RTP 是一种网络协议,用于通过 IP 网络传递音频和视频。

  5. 将处理助手的问候操作。 响应文本将发送到 Text to Speech 服务以转换为音频,然后该音频会发送给呼叫者。

  6. 当客户说出一些内容时,音频会通过 Speech to Text 服务转换为文本,并发送给您的助理进行评估。

  7. 助手处理输入并计算最佳响应。 助手的回复文本将发送至 Text to Speech 服务,转换为音频,并通过现有连接发送回给呼叫者。

  8. 如果呼叫者要求与人员交谈,那么助手可以将此人转接到呼叫中心。 SIP REFER 请求会发送到 SIP 中继提供者,以便它可以将呼叫转接到配置了转接操作的对话节点中指定的呼叫中心 SIP URI。

  9. 当通话中的一方挂断电话时,SIP BYE 请求将发送给另一方。