如何使用 Amazon Connect StartOutboundVoiceContact API 對客戶進行外撥通話？

解決方法

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

建立外撥聯絡流程

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

請完成下列步驟：

1. 使用您的存取網址登入 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. 將 Play prompt (播放提示) 區塊拖曳到畫布上。
3. 選擇 Play prompt (播放提示) 區塊標題。
4. 在 Prompt (提示)，選擇 Text to speech (Ad hoc) (文字轉語音 (暫時))。
5. 在 Enter text (輸入文字) 中，輸入訊息。例如，輸入 "Hello. This is a test call."
6. 確認解讀為已設定為文字。
7. 選擇 Save (儲存)。

如需詳細資訊，請參閱在 Amazon Polly 的流程區塊提示中新增文字轉語音功能和使用 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。呼叫 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 替換為您的聯絡流程 ID，將 instanceId 替換為您的 Amazon Connect 執行個體 ID。將 instancePhoneNumber 替換為 E.164 格式的聯絡中心電話號碼。

如果動作成功，命令回應將傳回 ContactId，但如果動作不成功，您將收到錯誤代碼。

相關資訊

在 Amazon Connect 中建立提示

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

使用 Amazon Connect 自動化對客戶的外撥電話