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