电话集成配置
为助手设置电话集成后,可以修改电话集成设置,自定义通话行为。
处理呼叫和转接失败
您可以对电话集成进行配置,以便在电话连接因任何原因出现故障时将呼叫转接给实时座席。 要将呼叫自动转接给人工,请转到电话集成设置中的高级选项卡,并进行以下配置选择:
呼叫失败时的 SIP 目标:添加支持座席服务的 SIP 端点。 为通用呼叫队列指定可将请求重定向到其他队列的 SIP 或电话 URI。 有关详细信息,请参阅 配置备份服务台解决方案。
呼叫失败消息:添加您希望助理在将呼叫转移到实时座席之前对呼叫者说的话。
如果在将呼叫转移给人工值班人员后,由于任何原因与实时座席的连接失败,您可以配置如何处理。
转接失败消息:添加您希望助理在呼叫转移到实时座席失败时向呼叫者传达的信息。 信息长度不超过 150 个字符。
转接失败时断开通话:选择是否在收到失败消息后断开呼叫。 缺省情况下会启用此选项。 如果禁用该选项,当呼叫转移失败时,您的助手可以断开连接或处理其他操作。
如果您选择在转接失败后仍保持通话连接 ,AI 助手将启动新一轮交互以确定后续步骤。 重要的是,助理必须配置能处理这种情况的动作或网络钩子。
电话集成支持灾难恢复,当服务中断时,它能够快速故障切换到另一个区域,而不是将呼叫路由到现场座席。 这可以通过向上游 SIP 中继提供商发送 SIP 503 响应来实现,而不是在呼叫设置过程中发生故障时自动将呼叫转给现场座席。 然后,SIP 中继提供商可使用此 503 响应将呼叫重新路由到另一个区域。 如果您希望利用此功能,请针对需要灾难恢复的 AI 助手服务实例提交服务工单。
保护电话连接
您可以通过访问手机集成设置中的高级选项选项卡,并选择以下一个或两个选项,为手机连接添加安全性:
强制安全中继:选择此选项可使用安全实时传输协议 (SRTP) 保护通过电话传输的音频。 有关 RTP 的更多信息,请参阅 呼叫路由详细信息。
启用 SIP 身份验证:如果需要 SIP 摘要身份验证,请选择此选项。
当需要SIP身份验证时,所有入站流量(即SIP提供商发送到您助理的请求)均通过SIP摘要认证进行身份验证,且必须使用传输层安全协议( TLS )发送。 若选择此选项,则必须配置SIP摘要用户名和密码,并且用于连接助理的SIP中继必须配置为仅使用 TLS。
如果您使用 Twilio 作为 SIP 中继提供商,则无法为发往 AI 助手的出站 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"
}
}
}
}
}
然后,您就可以在助手中引用这些标题。 例如,您可以检查步骤条件中的标题值,以确定下一步。 在搜索助手日志时,您也可以使用这些标题;例如,您可以搜索自定义标题来查找与特定账户相关的所有邮件。
禁用呼叫者在与助手联系时听到的铃声:选择是否要让呼叫者听到表示正在与助手联系的信号。
当助手处理来电邀请时,助手会向 SIP 中继提供商发送 180 Ringing 响应。 缺省情况下会发送“正在响铃”响应。
转接到实时座席时不将呼叫者挂起:选择电话集成是否将呼叫者挂起。
如果是 SIP 中继提供者管理挂起,请禁用此功能。 例如,某些 SIP 中继提供者希望助手发送 SIP REFER 请求,以便他们可以自己将呼叫挂起。
配置备份服务台解决方案
当您使用电话集成作为客户求助的第一线时,最好有一名后备即时代理。 您可以设计您的助手,在电话连接失败或用户要求与某人通话时将呼叫转移给人工接听。
您的公司可能已经有一个或多个电话号码连接到自动呼叫分配器 (ACD),该分配器可将呼叫者排成队列,直到有合适的座席可用。 如果没有,请选择一个服务台解决方案作为备份。
交谈无法从一种集成类型转接到另一种集成类型。 例如,如果您使用网络聊天与服务台支持集成,则无法将电话呼叫转移到为网络聊天设置的服务台。
您必须为所使用的服务台支持解决方案提供服务台 SIP URI。 从对话节点或操作步骤启用呼叫转移时,必须在助手中指定此信息。 有关更多信息,请参阅 将呼叫转移到实时座席。
针对电话互动优化操作
为了获得最佳的客户体验,设计对话时请考虑电话集成的功能:
请勿在操作回复中包含 HTML 元素。 要添加格式,请使用 Markdown。 有关更多信息,请参阅 格式化响应。
您可以使用搜索扩展名,将搜索结果包含在手机集成将读取的操作中。 返回搜索结果时,手机集成会读取介绍信息(例如,
I found this information that might be helpful),然后只读取第一个搜索结果的正文。
整个搜索回复(指介绍信息和第一个搜索结果的正文)的长度必须少于 5000 个字符,否则将无法读取回复。 请确保测试返回的搜索结果,并根据需要整理使用的数据集合。
有关使用搜索集成的更多信息,请参阅 “添加搜索 ”。
有关如何在对话框中执行常见操作的更多信息,请参阅 “处理电话交互 ”。
创建 SIP 中继
如果不使用选项生成免费电话号码,则必须设置电话集成使用的 SIP 中继。 查找供应商并创建 SIP 中继账户,您必须按使用量付费。
您可以通过以下方式设置 SIP 中继:
设置 Twilio SIP 中继
在开始设置 Twilio SIP 中继之前,请执行以下前提步骤:
如果已经创建了 SIP 中继,请按照 配置 SIP 中继 中的步骤操作。
创建 SIP 中继
登录 Twilio 帐户并转至 探索产品。
注意:如果您在侧边栏上没有看到探索产品,请执行以下操作:
在搜索栏中搜索 "Elastic SIP Trunking"。
单击 Elastic SIP 中继控制面板。
转至步骤 3。
单击 Elastic SIP Trunking 面板。
在 Elastic SIP 中继仪表板页面,单击 Get Started。
单击 Create a SIP Trunk 按钮打开 Create A New SIP Trunk 对话框。
在 FRIENDLY NAME 字段中输入 SIP 中继的名称。
单击 Create 按钮。
要配置 SIP 中继,请按照配置 SIP 中继中的步骤操作。
配置 SIP 中继
配置 SIP 中继的步骤如下:
从 Elastic SIP 中继仪表板页面,转到 Elastic SIP 中继。
单击 管理。
单击 Trunks 并选择您创建的 SIP 中继。
单击 SIP 中继导航栏中的 Origination 。
要添加发端 SIP URI,请单击 Add new Origination URI 按钮,并为以下字段提供值:
Origination SIP URI - 您可以从助手的电话集成配置页面获取电话集成的 SIP URI。 要在助手中执行此操作,请启动工具并创建助手。 选择 添加集成,然后选择 电话。 从助手中复制 SIP URI 并粘贴到 Twilio 的 Origination SIP URI 字段中。
Priority - 优先级排列 URI 的重要性。 数字越小,表示重要性越高。
Weight - 权重用于确定多个 URI 具有相同优先级时的负载份额。 值越大,URI 的负载就越大。
Enabled - 您需要将 Enabled 切换为
Yes。 这表示已启用发端 SIP URI。
如果计划支持呼叫转移,请在 SIP 中继中启用呼叫转移(SIP REFER)。 如果您希望将呼叫转移到公共交换电话网络 (PSTN),也请在中继线上启用 PSTN 转移功能。
针对您的 SIP 中继,从导航栏中选择号码,然后执行下列其中一个操作:
单击 添加号码,然后单击 购买号码*。
如果您已经有一个号码,可以单击 添加一个号码,然后单击 添加一个现有号码。
如果是将轻量或试用 Twilio 帐户用于测试,请确保验证转接目标。 如需更多信息,请参阅 Twilio 文档。
如果选择将 Twilio 作为 SIP 中继提供者,那么无法启用 SIP 认证。 Twilio 不支持对使用 SIPS 发起呼叫。
使用其他第三方提供者
您可以通过开具支持请求来要求帮助设置其他 SIP 中继提供者的帐户。
IBM已与下列 SIP 中继提供商建立了合作关系:
SIP 中继提供者设置 SIP 中继来处理语音流量,并管理从允许的 IP 地址进行的访问。 大多数主要 SIP 中继提供者都与 IBM 存在现有关系。 因此,通常可以极其轻松地为您处理支持 SIP 中继连接所需的网络配置。
创建 支持案例。
如果适用,请为您的案件提供以下详细信息:
主题:
AI assistantSubtopic:
Phone & SMS Integration主题:
SIP trunk provider setup for AI assistant描述 :
公司名称
您的 IBM Cloud 账户 ID
您的 AI 助手服务名称
网络图,其中包含 IP 地址或 SIP 中继提供者信息
自带 SIP 中继
如果您选择使用一家与 IBM 尚未建立合作关系的 SIP 中继运营商,请根据 watsonx Orchestrate 中的部署说明以及您环境的托管区域,在您的网络中允许相应的域名和 IP 地址。
关于 watsonx Orchestrate 上的 Amazon Web Services ( AWS ),请参阅下表以获取 SIP 网络信息:
位置 |
域名 |
IP 地址 |
|---|---|---|
美国东部(北 弗吉尼亚) |
public.01.voip.us-east-1.aws.watsonassistant.ibm.com public.02.voip.us-east-1.aws.watsonassistant.ibm.com |
35.172.81.217 52.206.161.38 |
美国东部HIPAA(N. 弗吉尼亚) |
public.01.voip.us-east-1-reg.aws.watsonassistant.ibm.com public.02.voip.us-east-1-reg.aws.watsonassistant.ibm.com |
100.30.253.64 35.153.121.106 |
有关 watsonx Orchestrate (位于 IBM Cloud )的 SIP 网络信息,请参阅下表:
位置 |
域名 |
IP 地址 |
|---|---|---|
IBM Cloud 美国南部(达拉斯) |
public.0001.voip.us-south.assistant-builder.watson.cloud.ibm.com public.0002.voip.us-south.assistant-builder.watson.cloud.ibm.com public.0003.voip.us-south.assistant-builder.watson.cloud.ibm.com |
150.239.30.150 169.63.5.170 67.228.108.90 |
IBM Cloud 欧盟-GB(伦敦) |
public.0001.voip.eu-gb.assistant-builder.watson.cloud.ibm.com public.0002.voip.eu-gb.assistant-builder.watson.cloud.ibm.com public.0003.voip.eu-gb.assistant-builder.watson.cloud.ibm.com |
141.125.102.38 158.175.99.38 158.176.120.166 |
IBM Cloud 欧盟-德国(法兰克福) |
public.0001.voip.eu-de.assistant-builder.watson.cloud.ibm.com public.0002.voip.eu-de.assistant-builder.watson.cloud.ibm.com public.0003.voip.eu-de.assistant-builder.watson.cloud.ibm.com |
169.50.56.150 161.156.178.166 149.81.86.86 |
IBM Cloud AU-SYD(悉尼) |
public.0001.voip.au-syd.assistant-builder.watson.cloud.ibm.com public.0002.voip.au-syd.assistant-builder.watson.cloud.ibm.com public.0003.voip.au-syd.assistant-builder.watson.cloud.ibm.com |
168.1.47.6 168.1.106.134 135.90.86.54 |
IBM Cloud 美国东部(华盛顿特区) |
public.0001.voip.us-east.assistant-builder.watson.cloud.ibm.com public.0002.voip.us-east.assistant-builder.watson.cloud.ibm.com public.0003.voip.us-east.assistant-builder.watson.cloud.ibm.com |
52.116.100.150 169.59.136.198 169.61.70.16 |
IBM Cloud JP-TOK (东京) |
public.0001.voip.jp-tok.assistant-builder.watson.cloud.ibm.com public.0002.voip.jp-tok.assistant-builder.watson.cloud.ibm.com public.0003.voip.jp-tok.assistant-builder.watson.cloud.ibm.com |
161.202.149.166 128.168.105.182 165.192.69.86 |
IBM Cloud BR-SAO(圣保罗) |
public.0001.voip.br-sao.assistant-builder.watson.cloud.ibm.com public.0002.voip.br-sao.assistant-builder.watson.cloud.ibm.com public.0003.voip.br-sao.assistant-builder.watson.cloud.ibm.com |
169.57.170.210 163.107.73.146 163.109.71.2 |
从 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 ”迁移至 AI 助手电话集成,请完成以下步骤:
请从 Voice Agent with Watson 页面中,复制您用于 SIP 账户的电话号码。
在设置 AI 助手与手机的集成时,请添加上一步中复制的电话号码或号码组。
从电话集成设置页面,复制 SIP 统一资源标识符 (URI)。
在您的 SIP 中继账户中,将之前指定的 Voice Agent with Watson URI 替换为上一步从电话集成设置页面复制的 URI。
例如,如果您使用 Twilio SIP 中继,则应将助手的 SIP 统一资源标识符 (URI) 添加到 Twilio Origination SIP URI 字段中。
如果您的 SIP 中继提供商尚未被您迁移目标的 AI 助手区域列入白名单,请按照以下说明操作以获取 SIP 中继的访问权限。
呼叫路由详细信息
向助手发出的入局呼叫遵循以下路径:
客户呼叫由会话发起协议 (SIP) 中继提供者管理的客户支持电话号码。
SIP 中继服务向您助手的电话集成发送 SIP
INVITE请求,以建立连接。电话集成连接到支持交互所需的语音服务。
服务准备就绪后,将建立连接,并通过实时传输协议 (RTP) 发送音频。
RTP 是一种网络协议,用于通过 IP 网络传递音频和视频。
处理助理的问候动作。 响应文本将发送至 Text to Speech 服务进行语音转换,随后将语音发送给呼叫者。
当客户说话时, Speech to Text 服务会将语音转换为文本,并发送给您的助手进行评估。
助手会处理输入,并计算出最佳响应。 助手的回复文本会被发送至 Text to Speech 服务进行语音转换,随后通过现有连接将语音发回给呼叫者。
如果呼叫者要求与人员交谈,那么助手可以将此人转接到呼叫中心。 SIP
REFER请求会发送到 SIP 中继提供者,以便它可以将呼叫转接到配置了转接操作的对话节点中指定的呼叫中心 SIP URI。当通话的其中一个参与者挂断电话时,将向另一个参与者发送 SIP
BYE请求。