如何使用 Amazon Connect StartOutboundVoiceContact API 对客户进行外拨呼叫？

解决方案

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

创建呼出联系流

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

完成以下步骤：

1. 使用您的访问 URL 登录您的 Amazon Connect 实例。使用 https://alias.awsapps.com/connect/login 或 https://alias.awsapps.com/connect/login。
   **注意：**将 alias 替换为您的实例的别名。
2. 在导航窗格中，将鼠标悬停在 Routing（路由）上，然后选择 Contact flows（联系流）。
3. 在 Contact flows（联系流）页面上，选择一个模板。或者，选择 Create contact flow（创建联系流），从头开始设计联系流。
4. 在联系流设计器中，对于 Enter a name（输入名称），输入联系流的名称。例如，"Outbound calling."
5. 选择 Save（保存）。

有关详细信息，请参阅使用 Amazon Connect 中的流设计器创建流。

添加播放提示块

要配置客户在通话期间听到的音频提示，请使用 Amazon Connect 中的流块： 播放提示。

完成以下步骤：

1. 在联系流设计器中，展开 Interact（互动）。
2. 将播放提示块拖放到画布上。
3. 选择 Play prompt（播放提示）块的标题。
4. 对于 Prompt（提示），选择 Text to speech (Ad hoc)（文字转语音（临时））。
5. 对于 Enter text（输入文本），输入消息。例如，输入"Hello. This is a test call."
6. 确认 Interpret as（解释为）已设置为 Text（文本）。
7. 选择 Save（保存）。

有关详细信息，请参阅在 Amazon Polly 的流块中为提示添加文字转语音和使用 Amazon Connect 联系人属性。

添加断开连接/挂断流块

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

完成以下步骤：

1. 选择 Terminate/Transfer（终止/转接）。
2. 将断开连接/挂断块拖放到播放提示块右侧的画布上。

连接这些联系块

按以下顺序将联系流中的所有连接器连接到一个块： 入口点、播放提示和断开连接/挂断。

在发布联系流之前，您必须将所有连接器连接到一个块。

保存并发布联系流

完成以下步骤：

1. 选择 Save（保存）以保存流草稿。
2. 选择发布以立即激活这个流。

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

完成以下步骤：

1. 在联系流设计器中，展开 Show additional flow information（显示其他流信息）。
2. 在 ARN 下，复制 Amazon 资源名称 (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 (IAM) 策略附加到您的 IAM 角色以调用 connect:StartOutboundVoiceContact API。

提供所需权限的 JSON 策略示例：

{  "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/*"
    }
  ]
}

**注意：**将 ARN 替换为您的 Amazon Connect 实例的 ARN。

调用 StartOutboundVoiceContact API

运行 start-outbound-voice-contact AWS CLI 命令调用 StartOutboundVoiceContact API：

aws connect start-outbound-voice-contact --region awsRegion --destination-phone-number phoneNumber --contact-flow-id contactFlowId --instance-id instanceId --source-phone-number instancePhoneNumber

**注意：**将 awsRegion 替换为您的 Amazon Connect 实例的 AWS 区域。将 phoneNumber 替换为接听方的电话号码（E.164 格式）。将 contactFlowId 替换为您的联系流 ID，将 instanceId 替换为您的 Amazon Connect 实例 ID。将 instancePhoneNumber 替换为您的联络中心的电话号码（E.164 格式）。

操作成功后，命令响应会返回 ContactId，但如果操作不成功，则会收到错误代码。

相关信息

在 Amazon Connect 中创建提示

在 Amazon Connect 中设置外拨来电显示

Automating outbound calling to customers using Amazon Connect（使用 Amazon Connect 自动向客户进行外拨呼叫）