Amazon Connect StartOutboundVoiceContact API를 사용하여 고객에게 아웃바운드 호출을 수행하려면 어떻게 해야 합니까?

간략한 설명

이 문서의 지침에 따라 StartOutboundVoiceContact API를 사용하여 호출을 시작할 수 있는 예제 설정을 만들 수 있습니다.

이 예제 설정에서 Amazon Connect 고객 센터는 대상 번호로 전화를 걸어 수신자에게 “안녕하세요”와 지정한 이름으로 인사합니다. 그 다음 통화 연결이 자동으로 끊어집니다.

다른 설정 예는 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.    좌측 탐색 창에서 [라우팅] 위로 마우스를 가져간 다음 [고객 응대 흐름]을 선택합니다.

3.    고객 응대 흐름(Contact flows) 페이지에서 템플릿을 선택하거나, **고객 응대 흐름 생성(Create contact flow)**을 선택하여 고객 응대 흐름을 새로 만듭니다.

4.    고객 응대 흐름 디자이너에서 **이름 입력(Enter a name)**에 고객 응대 흐름의 이름을 입력합니다. 예: 아웃바운드 호출.

5.    **저장(Save)**을 선택합니다.

자세한 내용은 새 고객 응대 흐름 생성을 참조하세요.

프롬프트 재생 블록 추가

호출 중에 고객에게 들리는 오디오 프롬프트를 구성하려면 프롬프트 고객 응대 재생 블록을 사용합니다.

1.    고객 응대 흐름 디자이너에서 **상호 작용(Interact)**을 펼칩니다.

2.    프롬프트 재생(Play prompt) 블록을 캔버스로 끌어 놓습니다.

3.    Play prompt(프롬프트 재생) 블록 제목을 선택합니다. 블록의 설정 메뉴가 열립니다.

4.    프롬프트에 대해 다음을 수행합니다. **텍스트를 음성으로 변환(Ad Hoc)**을 선택합니다. [텍스트 입력(Enter text)]에서 “안녕하세요. 테스트 호출입니다.“ [다음으로 해석(Interpret as)]이 [텍스트(Text)]로 설정되어 있는지 확인합니다. [저장(Save)]을 선택합니다.

자세한 내용은 프롬프트에 텍스트를 음성으로 변환 추가 및 Amazon Connect 연락처 속성 사용을 참조하십시오.

연결 해제/중단 블록 추가

발신 메시지가 재생된 후 호출을 자동으로 종료하려면 고객 응대 연결 해제/중단 블록을 사용합니다.

1.    [종료/전달(Terminate/Transfer)]을 선택합니다.

2.    연결 해제/중단 블록을 프롬프트 재생 블록의 오른쪽에 있는 캔버스로 끌어 놓습니다.

고객 응대 블록 연결

다음과 같이 고객 응대 흐름의 모든 커넥터를 블록에 연결합니다.

[진입점(Entry point)] > [프롬프트 재생(Play prompt)] > [ 연결 해제/중단(Disconnect / hang up)]

중요: 고객 응대 흐름을 게시하려면 먼저 모든 커넥터가 블록에 연결되어야 합니다.

고객 응대 흐름 저장 및 게시

1.    **저장(Save)**을 선택하여 흐름의 초안을 저장합니다.

2.    **게시(Publish)**를 선택하여 흐름을 즉시 활성화합니다.

Amazon Connect 인스턴스 ID 및 고객 응대 흐름 ID 가져오기

1.    고객 응대 흐름 디자이너에서 [추가 흐름 정보 표시(Show additional flow information)]를 확장합니다.

2.    [ARN]에서 [Amazon 리소스 이름(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 권한 확인

아직 호출하지 않은 경우 connect:StartOutboundVoiceContact API를 호출할 수 있는 AWS Identity and Access Management(AWS IAM) 정책을 생성하고 연결합니다.

다음 예제 JSON 정책 문서는 필요한 권한을 제공합니다.

중요: 인스턴스 ARN(“리소스” 값)을 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에서 다음 명령을 실행합니다.

중요: 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의 오류 섹션을 참조하십시오.

---

관련 정보

connect(AWS CLI 명령 참조)

프롬프트 생성

아웃바운드 발신자 ID 설정