如何使用 Amazon Connect StartOutboundVoiceContact API 外拨电话以联系客户？

2 分钟阅读

我想使用 Amazon Connect StartOutboundVoiceContact API 来编程，实现外拨电话以联系客户。

简述

以下示例设置允许您使用 StartOutboundVoiceContact API 发起呼叫。在此示例中，您的 Amazon Connect 联络中心拨打目标号码，并会用以下方式向接听方打招呼：“您好”+您指定的名字。然后，呼叫会自动断开。有关其他示例设置，请参阅Automating outbound calling to customers using Amazon Connect。

解决方案

**注意：**如果您在运行 AWS 命令行界面（AWS CLI）命令时收到错误，请参阅排查 AWS CLI 错误。此外，确保您使用的是最新版本的 AWS CLI。

创建呼出联系流

**重要信息：**要创建联系流，请以安全配置文件中具有足够权限的用户身份登录您的 Amazon Connect 实例。

使用您的访问 URL 登录您的 Amazon Connect 实例：（https://alias.awsapps.com/connect/login -或- https://alias.awsapps.com/connect/login）。
**注意：**用您的实例的别名替换 alias。
在左侧导航窗格中，将鼠标悬停在路由上，然后选择联系流。
在联系流页面上，选择一个模板。或者，选择创建联系流，从头开始设计联系流。
在联系流编辑器中，在输入名称中，输入联系流的名称。例如： 外拨电话。
选择保存。

有关更多信息，请参阅Create a flow。

添加播放提示块

要配置客户在通话期间听到的音频提示，请使用播放提示联系块。

在联系流编辑器中，展开互动。
将播放提示块拖放到画布上。
选择播放提示块的标题。系统会打开块的设置菜单。
对于提示，请完成以下步骤：
选择文字到语音转换（即席）。
对于输入文本，输入“您好。这是一次呼叫测试。”
确认解释为已设置为文本。
选择保存。

有关更多信息，请参阅Add text-to-speech to prompts和Use Amazon Connect contact attributes。

添加断开连接/挂断块

要在呼出信息播放完毕后自动结束通话，请使用断开连接/挂断联系块。

选择终止/转移。
将断开连接/挂断块拖放到播放提示块右侧的画布上。

连接这些联系块

按以下顺序将联系流中的所有连接器连接到一个块：
入口点 > 播放提示 > 断开连接/挂断
**重要信息：**在发布联系流之前，您必须将所有连接器连接到一个块。

保存并发布联系流

要保存流草稿，请选择保存。
选择发布以立即激活这个流。

获取您的 Amazon Connect 实例 ID 和联系流 ID

在联系流编辑器中，展开显示其他流信息。
在 ARN 下，复制 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-flow/*"
    }
  ]
}

调用 StartOutboundVoiceContact API

在 AWS CLI 中运行下列命令：

**重要信息：**将 awsRegion 替换为您的 Amazon Connect 实例的 AWS 区域。将 phoneNumber 替换为接听方的电话号码（E.164 格式）。将 contactFlowId 替换为您的联系流 ID。将 instanceId 替换为您的 Amazon Connect 实例 ID。将 instancePhoneNumber 替换为您的联络中心的电话号码（E.164 格式）。有关更多信息，请参阅 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 中的Errors部分。