如何使用 Amazon Connect StartOutboundVoiceContact API 对客户发起出站呼叫?
上次更新日期:2022 年 1 月 25 日
我想使用 Amazon Connect 对出站呼叫进行编程,以联系客户。如何使用 Amazon Connect StartOutboundVoiceContact API 自动进行出站呼叫?
简短描述
您可以按照本文中的说明创建示例设置,从而使用 StartOutboundVoiceContact API 发起呼叫。
在此示例设置中,您的 Amazon Connect 联系中心会呼叫目标号码,并使用 “Hello” 以及您指定的名字与接听人打招呼,然后自动断开呼叫。
有关其他设置示例,请参阅使用 Amazon Connect 自动对客户发起出站呼叫。
解决方法
注意:如果您在运行 AWS Command Line Interface (AWS CLI) 命令时遇到错误,请确保您使用的是最新版的 AWS CLI。
创建出站联系流
重要提示:要创建联系流,您必须以用户身份登录您的 Amazon Connect 实例,而且该用户身份要在其安全配置文件中有足够权限。
1. 使用您的访问 URL(https://alias.awsapps.com/connect/login -或- https://alias.awsapps.com/connect/login)登录您的 Amazon Connect 实例。
注:将 alias 替换成您的实例的别名。
2. 在左侧导航窗格中,将鼠标悬停在 Routing (路由) 上,然后选择 Contact flows (联系流)。
3. 在 Contact flows(联系流)页面,选择模板,或选择 Create contact flow(创建联系流)以从头开始设计一个联系流。
4. 在联系流设计器中,对于 Enter a name(输入名称),为联系流输入名称。(例如,“出站呼叫”。)
5. 选择 Save(保存)。
有关更多信息,请参阅创建新的联系流。
添加“播放提示”数据块
要配置客户在通话期间听到的音频提示,请使用播放提示联系数据块。
1. 在联系流设计器中,展开 Interact(交互)。
2. 将播放提示数据块拖放到画布中。
3. 选择播放提示数据块标题。这时将打开该数据块的设置菜单。
4. 对于 Prompt(提示),请执行以下操作:选择 Text to Speech (Ad hoc)(语音转文本(临时))。在Enter text(输入文本)中输入“Hello.This is a test call.",并确认 Interpret as(解读方式)设置为 Text(文本)。选择 Save(保存)。
如需更多信息,请参阅将文本转语音添加到提示和使用 Amazon Connect 联系人属性。
添加“断开/挂断”数据块
要在播放外发消息后自动结束通话,请使用“断开/挂断”联系数据块。
1. 选择 Terminate/Transfer终止/转移)。
2. 将 Disconnect / hang up(断开/挂断)数据块拖放到 Play prompt(播放提示)数据块右侧的画布上。
连接联系数据块
按以下顺序将联系流中的所有连接器连接到数据块:
接入点 > 播放提示 > 断开/挂断
重要提示:所有连接器都必须连接到一个块,然后才能发布联系流。
保存并发布联系流
1. 选择 Save(保存)以保存流程草稿。
2. 选择 Publish(发布)以立即激活此流程。
获取您的 Amazon Connect 实例 ID 和联系流 ID
1. 在联系流设计器中,展开 Show additional flow information(显示更多联系流信息)。
2. 在 ARN 下方,复制 Amazon Resource Name (ARN)。该联系流 ARN 包含您的 Amazon Connect 实例 ID 和您的联系流 ID。您需要这些 ID 来调用 StartOutboundVoiceContact API。
联系流 ARN 示例
arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact-flow/123a45b6-c7d8-9012-34e5-6fab789c012d
确认 Amazon Connect 的 IAM 权限
如果您没有权限,请创建并附加 AWS Identity and Access Management (AWS IAM) 策略,以允许您调用 connect:StartOutboundVoiceContact API。
以下示例 JSON 策略文档提供了所需的权限:
重要提示:将实例 ARN("Resource" 值)替换为您的 Amazon Connect 实例的 ARN。
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "connect:StartOutboundVoiceContact",
"Resource": "arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact/*"
}
]
}
调用 StartOutboundVoiceContact API
在 AWS CLI 中,运行以下命令:
重要提示:使用您的 Amazon Connect 实例的 AWS 区域替换 awsRegion。使用采用 E.164 格式的接听人电话号码替换 phoneNumber。使用您的联系流 ID 替换 contactFlowId。使用您的 Amazon Connect 实例 ID 替换 instanceId。使用采用 E.164 格式的联系中心的电话号码替换 instancePhoneNumber。如需更多信息,见 AWS CLI 命令界面中的 start-outbound-voice-contact。
$ aws connect start-outbound-voice-contact --region awsRegion --destination-phone-number phoneNumber --contact-flow-id contactFlowId --instance-id instanceId --source-phone-number instancePhoneNumber
操作成功时,命令响应 返回 ContactId,失败时返回错误代码。
有关 StartOutboundVoiceContact API 常见错误的更多信息,请参阅 StartOutboundVoiceContact 中的错误部分。