如何使用 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 中的错误部分


连接(AWS CLI 命令参考)

创建提示

设置出站呼叫者 ID

这篇文章对您有帮助吗?


您是否需要账单或技术支持?