Amazon Connect StartOutboundVoiceContact API를 사용하여 고객에게 아웃바운드 전화를 걸려면 어떻게 해야 하나요?

3분 분량

Amazon Connect StartOutboundVoiceContact API를 사용하여 고객에게 연락하기 위한 아웃바운드 통화를 프로그래밍하려고 합니다.

간략한 설명

다음 예제 설정에서는 StartOutboundVoiceContact API를 사용하여 통화를 시작할 수 있습니다. 이 예에서는 Amazon Connect 고객 센터가 대상 번호로 전화를 걸어 수신자에게 "Hello"와 함께 사용자가 지정한 이름으로 인사합니다. 그러면 통화 연결이 자동으로 끊깁니다. 다른 예제 설정은 Amazon Connect를 사용하는 고객에 대한 아웃바운드 통화 자동화를 참조하세요.

해결 방법

참고 AWS Command Line Interface(AWS CLI) 명령 실행 시 오류가 발생하는 경우, AWS CLI 오류 문제 해결을 참고하세요. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하세요.

아웃바운드 고객 응대 흐름 생성

중요: 고객 응대 흐름을 생성하려면 보안 프로필에 충분한 권한이 있는 사용자로 Amazon Connect 인스턴스에 로그인합니다.

액세스 URL을 사용하여 Amazon Connect 인스턴스에 로그인합니다(https://alias.awsapps.com/connect/login -또는- https://alias.awsapps.com/connect/login).
참고 별칭을 인스턴스의 별칭으로 바꿉니다.
왼쪽 탐색 창에서 라우팅 위로 마우스를 가져간 다음 고객 응대 흐름을 선택합니다.
고객 응대 흐름 페이지에서 템플릿을 선택합니다. 또는 고객 응대 흐름 생성을 선택하여 고객 응대 흐름을 처음부터 디자인할 수 있습니다.
고객 응대 흐름 디자이너에서 이름 입력에 고객 응대 흐름의 이름을 입력합니다. 예를 들면, 다음과 같습니다. 아웃바운드 통화.
저장을 선택합니다.

자세한 내용을 보려면 흐름 생성을 참조하세요.

프롬프트 재생 블록 추가

통화 중에 고객이 듣는 오디오 프롬프트를 구성하려면 프롬프트 재생 연락처 블록을 사용합니다.

고객 응대 흐름 디자이너에서 상호 작용을 확장합니다.
프롬프트 재생 블록을 캔버스에 드래그 앤 드롭합니다.
프롬프트 재생 블록 제목을 선택합니다. 블록의 설정 메뉴가 열립니다.
프롬프트의 경우 다음 단계를 완료하세요.
**텍스트 음성 변환(Ad Hoc)**을 선택합니다.
텍스트 입력에 “Hello”를 입력합니다. 테스트 콜입니다."
다음으로 해석이 Text로 설정되어 있는지 확인합니다.
저장을 선택합니다.

자세한 내용을 보려면 프롬프트에 텍스트 음성 변환 추가 및 Amazon Connect 연락처 속성 사용을 참조하세요.

연결 해제/끊기 블록 추가

발신 메시지가 재생된 후 통화를 자동으로 종료하려면 연결 해제/끊기 연락처 블록을 사용하세요.

종료/전송을 선택합니다.
연결 해제/끊기 블록을 프롬프트 재생 블록 오른쪽에 있는 캔버스로 끌어다 놓습니다.

연락처 블록 연결

고객 응대 흐름의 모든 커넥터를 다음 순서로 블록에 연결합니다.
진입점 > 프롬프트 재생 > 연결 해제/끊기
중요: 고객 응대 흐름을 게시하려면 먼저 모든 커넥터를 블록에 연결해야 합니다.

고객 응대 흐름 저장 및 게시

흐름의 초안을 저장하려면 저장을 선택합니다.
게시를 선택하여 흐름을 즉시 활성화합니다.

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

고객 응대 흐름 디자이너에서 추가 흐름 정보 표시를 확장합니다.
ARN에서 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-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의 오류 섹션을 참조하세요.