如何使用 Amazon Connect StartOutboundVoiceContact API 向客戶發起外撥通話？

解決方法

注意： 如果您在執行 AWS Command Line Interface (AWS CLI) 命令時收到錯誤訊息，請參閱對 AWS CLI 錯誤進行疑難排解。另外，請確認您目前使用的是最新版 AWS CLI。

完成先決條件

建立外撥聯絡流程前，請先完成以下操作：

• 為 Amazon Connect 執行個體啟用外撥通話。
• 確認目的地號碼已列入外撥允許清單。
• 在 Amazon Connect 中申請電話號碼，並確認已申請的電話號碼支援外撥通話。

注意： 若您使用新的 AWS 帳戶，該帳戶可能會受到外撥通話限制。如需申請提高配額，請參閱申請提高配額。

建立外撥聯絡流程

若要建立聯絡流程，請以具備足夠安全性設定檔權限的使用者身分，登入您的 Amazon Connect 執行個體。

請依照以下步驟操作：

1. 使用存取網址登入 Amazon Connect 執行個體。例如：https://alias.my.connect.aws。
   注意： 將 alias 替換為您的執行個體別名。
2. 在導覽窗格中，將滑鼠游標停留在 Routing (路由) 上，然後選擇 Contact flows (聯絡流程)。
3. 在 Contact flows (聯絡流程) 頁面上選擇一個範本。或者，選擇 Create contact flow (建立聯絡流程)，自行從頭設計聯絡流程。
4. 在聯絡流程設計器的 Enter a name (輸入名稱) 中，輸入聯絡流程名稱。例如，輸入「外撥通話」。
5. 選擇 Save (儲存)。

如需更多資訊，請參閱在 Amazon Connect 中使用流程設計器建立流程。

(選用) 新增設定記錄行為區塊

若要在聯絡人與流程互動時追蹤事件，請使用 Set logging behavior flow block (設定記錄行為流程區塊)。

請依照以下步驟操作：

1. 在聯絡流程設計器中，展開 Analyze (分析)。
2. 將 Set logging behavior (設定記錄行為) 區塊拖放至畫布。
3. 選擇 Set logging behavior (設定記錄行為) 區塊的標題。
4. 針對 Logging behavior (記錄行為)，選擇 Enable (啟用)。
5. 選擇 Save (儲存)。

如需更多資訊，請參閱在 Amazon CloudWatch 日誌群組中啟用 Amazon Connect 流程日誌。

(選用) 新增設定語音區塊

若要設定 Amazon Connect 向聯絡人說出提示時使用的文字轉語音 (TTS) 語言和語音，請使用 Set voice flow block (設定語音流程區塊)。

請依照以下步驟操作：

1. 在聯絡流程設計器中，展開 Set (設定)。
2. 將 Set voice (設定語音) 區塊拖放至畫布。
3. 選擇 Set voice (設定語音) 區塊的標題。
4. 針對 Language (語言)，選擇您偏好的語言。
5. 針對 Voice (語音)，選擇您偏好的語音。
6. (選用) 若要變更說話風格，請選擇 Override speaking style (覆寫說話風格)，然後選擇 Standard (標準)、Neutral (中性) 或 Generative (生成式)。
   注意： 使用生成式語音可能會產生額外費用。
7. 選擇 Save (儲存)。

如需更多資訊，請參閱在 Amazon Polly 中將文字轉語音新增至流程區塊的提示。

新增播放提示區塊

若要設定客戶在通話期間聽到的音訊提示，請使用 Play prompt flow block (播放提示流程區塊)。

請依照以下步驟操作：

1. 在聯絡流程設計器中，展開 Interact (互動)。
2. 將 Play prompt (播放提示) 區塊拖放至畫布。
3. 選擇 Play prompt (播放提示) 區塊的標題。
4. 針對 Prompt (提示)，選擇 Text to speech (Ad hoc) (文字轉語音 (臨時))。
5. 在 Enter text (輸入文字) 中輸入訊息。例如，輸入「您好。這是測試通話。」
6. 確認 Interpret as (解讀為) 已設定為 Text (文字)。
7. 選擇 Save (儲存)。

如需更多資訊，請參閱在 Amazon Polly 中將文字轉語音新增至流程區塊的提示和使用 Amazon Connect 聯絡屬性。

新增中斷連線/掛斷流程區塊

若要在播放外撥訊息後自動結束通話，請使用 Disconnect / hang up flow block (中斷連線/掛斷流程區塊)。

請依照以下步驟操作：

1. 選擇 Terminate/Transfer (終止/轉移)。
2. 將 Disconnect / hang up (中斷連線/掛斷) 區塊拖放至畫布上 Play prompt (播放提示) 區塊的右側。

連接聯絡區塊

將聯絡流程內的所有連接器依以下順序連接至區塊： Entry point (進入點)、Set logging behavior (設定記錄行為) (若已設定)、Set voice (設定語音) (若已設定)、Play prompt (播放提示)，以及 Disconnect / hang up (中斷連線/掛斷)。

發佈聯絡流程前，您必須將所有連接器連接至區塊。

儲存並發佈聯絡流程

請依照以下步驟操作：

1. 選擇 Save (儲存)，將流程儲存為草稿。
2. 選擇 Publish (發佈)，立即啟用流程。

取得 Amazon Connect 執行個體 ID 與聯絡流程 ID

請依照以下步驟操作：

1. 在聯絡流程設計器中，選擇 Details (詳細資訊) 索引標籤。
2. 在 ARN 下方，複製 Amazon Resource Name (ARN)。聯絡流程 ARN 包含您的 Amazon Connect 執行個體 ID 和聯絡流程 ID。呼叫 StartOutboundVoiceContact API 時需要提供這些 ID。

聯絡流程 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 和 instanceId 替換為您的聯絡流程 ID 和 Amazon Connect 執行個體 ID。將 instancePhoneNumber 替換為採用 E.164 格式的您的聯絡中心電話號碼。

如果此動作順利完成，命令回應會傳回 ContactId。如果此動作失敗，您會收到錯誤碼。

相關資訊

在 Amazon Connect 中建立提示

在 Amazon Connect 中設定外撥來電者 ID

使用 Amazon Connect 自動向客戶發起外撥通話