를 사용한 Amazon Connect 예제 AWS CLI - AWS Command Line Interface

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 Amazon Connect 예제 AWS CLI

다음 코드 예제에서는 Amazon Connect AWS Command Line Interface 와 함께 를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.

각 예제에는 컨텍스트에서 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있는 전체 소스 코드에 대한 링크가 포함되어 있습니다.

주제

작업

다음 코드 예시에서는 create-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자를 생성하려면

다음 create-user 예제에서는 지정된 속성을 가진 사용자를 지정된 Amazon Connect 인스턴스에 추가합니다.

aws connect create-user \ --username Mary \ --password Pass@Word1 \ --identity-info FirstName=Mary,LastName=Major \ --phone-config PhoneType=DESK_PHONE,AutoAccept=true,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+15555551212 \ --security-profile-id 12345678-1111-2222-aaaa-a1b2c3d4f5g7 \ --routing-profile-id 87654321-9999-3434-abcd-x1y2z3a1b2c3 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "UserId": "87654321-2222-1234-1234-111234567891", "UserArn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent/87654321-2222-1234-1234-111234567891" }

자세한 내용은 Amazon Connect 관리자 안내서사용자 추가를 참조하세요.

  • 자세한 API 내용은 명령 참조CreateUser의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 delete-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자 삭제

다음 delete-user 예제에서는 지정된 Amazon Connect 인스턴스에서 지정된 사용자를 삭제합니다.

aws connect delete-user \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --user-id 87654321-2222-1234-1234-111234567891

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서사용자 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteUser의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 describe-user-hierarchy-group을 사용하는 방법을 보여 줍니다.

AWS CLI

계층 구조 그룹의 세부 정보를 표시하려면

다음 describe-user-hierarchy-group 예제에서는 지정된 Amazon Connect 계층 구조 그룹에 대한 세부 정보를 표시합니다.

aws connect describe-user-hierarchy-group \ --hierarchy-group-id 12345678-1111-2222-800e-aaabbb555gg \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "HierarchyGroup": { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Example Corporation", "LevelId": "1", "HierarchyPath": { "LevelOne": { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group/abcdefgh-3333-4444-8af3-201123456789", "Name": "Example Corporation" } } } }

자세한 내용은 Amazon Connect 관리자 안내서에이전트 계층 설정을 참조하세요.

다음 코드 예시에서는 describe-user-hierarchy-structure을 사용하는 방법을 보여 줍니다.

AWS CLI

계층 구조에 대한 세부 정보를 표시하려면

다음 describe-user-hierarchy-structure 예제에서는 지정된 Amazon Connect 인스턴스의 계층 구조에 대한 세부 정보를 표시합니다.

aws connect describe-user-hierarchy-group \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "HierarchyStructure": { "LevelOne": { "Id": "12345678-1111-2222-800e-aaabbb555gg", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/1", "Name": "Corporation" }, "LevelTwo": { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/2", "Name": "Services Division" }, "LevelThree": { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/agent-group-level/3", "Name": "EU Site" } } }

자세한 내용은 Amazon Connect 관리자 안내서에이전트 계층 설정을 참조하세요.

다음 코드 예시에서는 describe-user을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 세부 정보를 표시하려면

다음 describe-user 예제에서는 지정된 Amazon Connect 사용자에 대한 세부 정보를 표시합니다.

aws connect describe-user \ --user-id 0c245dc0-0cf5-4e37-800e-2a7481cc8a60 --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e

출력:

{ "User": { "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Username": "Jane", "IdentityInfo": { "FirstName": "Jane", "LastName": "Doe", "Email": "example.com" }, "PhoneConfig": { "PhoneType": "SOFT_PHONE", "AutoAccept": false, "AfterContactWorkTimeLimit": 0, "DeskPhoneNumber": "" }, "DirectoryUserId": "8b444cf6-b368-4f29-ba18-07af27405658", "SecurityProfileIds": [ "b6f85a42-1dc5-443b-b621-de0abf70c9cf" ], "RoutingProfileId": "0be36ee9-2b5f-4ef4-bcf7-87738e5be0e5", "Tags": {} } }

자세한 내용은 Amazon Connect 관리자 안내서사용자 관리를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeUser의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 get-contact-attributes을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 속성을 검색하려면

다음 get-contact-attributes 예제에서는 지정된 Amazon Connect 연락처에 대해 설정된 속성을 검색합니다.

aws connect get-contact-attributes \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --initial-contact-id 12345678-1111-2222-800e-a2b3c4d5f6g7

출력:

{ "Attributes": { "greetingPlayed": "true" } }

자세한 내용은 Amazon Connect 관리자 안내서의 Amazon Connect 연락처 속성 사용을 참조하세요. Amazon Connect

다음 코드 예시에서는 list-contact-flows을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 고객 응대 흐름을 나열하려면

다음 list-contact-flows 예제에서는 지정된 Amazon Connect 인스턴스의 고객 응대 흐름을 나열합니다.

aws connect list-contact-flows \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "ContactFlowSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Default queue transfer", "ContactFlowType": "QUEUE_TRANSFER" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/87654321-2222-3333-ac99-123456789102", "Name": "Default agent hold", "ContactFlowType": "AGENT_HOLD" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/contact-flow/abcdefgh-3333-4444-8af3-201123456789", "Name": "Default customer hold", "ContactFlowType": "CUSTOMER_HOLD" }, ] }

자세한 내용은 Amazon Connect 관리자 안내서의 Amazon Connect 고객 응대 흐름 생성을 참조하세요. Amazon Connect

  • 자세한 API 내용은 명령 참조ListContactFlows의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-hours-of-operations을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스에서 작업 시간을 나열하려면

다음 list-hours-of-operations 예제에서는 지정된 Amazon Connect 인스턴스의 작업 시간을 나열합니다.

aws connect list-hours-of-operations \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e

출력:

{ "HoursOfOperationSummaryList": [ { "Id": "d69f1f84-7457-4924-8fbe-e64875546259", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/operating-hours/d69f1f84-7457-4924-8fbe-e64875546259", "Name": "Basic Hours" } ] }

자세한 내용은 Amazon Connect 관리자 안내서의 대기열에 대한 작업 시간 설정을 참조하세요.

다음 코드 예시에서는 list-phone-numbers을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 전화번호를 나열하려면

다음 list-phone-numbers 예제에서는 지정된 Amazon Connect 인스턴스의 전화번호를 나열합니다.

aws connect list-phone-numbers \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "PhoneNumberSummaryList": [ { "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/xyz80zxy-xyz1-80zx-zx80-11111EXAMPLE", "PhoneNumber": "+17065551212", "PhoneNumberType": "DID", "PhoneNumberCountryCode": "US" }, { "Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/phone-number/ccc0ccc-xyz1-80zx-zx80-22222EXAMPLE", "PhoneNumber": "+18555551212", "PhoneNumberType": "TOLL_FREE", "PhoneNumberCountryCode": "US" } ] }

자세한 내용은 Amazon Connect 관리자 안내서고객 센터에 대한 전화번호 설정을 참조하세요.

  • 자세한 API 내용은 명령 참조ListPhoneNumbers의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-queues을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 대기열을 나열하려면

다음 list-queues 예제에서는 지정된 Amazon Connect 인스턴스의 대기열을 나열합니다.

aws connect list-queues \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "QueueSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/12345678-1111-2222-800e-a2b3c4d5f6g7", "QueueType": "AGENT" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/87654321-2222-3333-ac99-123456789102", "QueueType": "AGENT" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/agent/abcdefgh-3333-4444-8af3-201123456789", "QueueType": "AGENT" }, { "Id": "hgfedcba-4444-5555-a31f-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/queue/hgfedcba-4444-5555-a31f-123456789102", "Name": "BasicQueue", "QueueType": "STANDARD" }, ] }

자세한 내용은 Amazon Connect 관리자 안내서대기열 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조ListQueues의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-routing-profiles을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 라우팅 프로파일을 나열하려면

다음 list-routing-profiles 예제에서는 지정된 Amazon Connect 인스턴스의 라우팅 프로파일을 나열합니다.

aws connect list-routing-profiles \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "RoutingProfileSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/routing-profile/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "Basic Routing Profile" }, ] }

자세한 내용은 Amazon Connect 관리자 안내서라우팅 프로필 생성을 참조하세요.

  • 자세한 API 내용은 명령 참조ListRoutingProfiles의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 list-security-profiles을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 보안 프로파일을 나열하려면

다음 list-security-profiles 예제에서는 지정된 Amazon Connect 인스턴스의 보안 프로파일을 나열합니다.

aws connect list-security-profiles \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

출력:

{ "SecurityProfileSummaryList": [ { "Id": "12345678-1111-2222-800e-a2b3c4d5f6g7", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-a2b3c4d5f6g7", "Name": "CallCenterManager" }, { "Id": "87654321-2222-3333-ac99-123456789102", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/87654321-2222-3333-ac99-123456789102", "Name": "QualityAnalyst" }, { "Id": "abcdefgh-3333-4444-8af3-201123456789", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/abcdefgh-3333-4444-8af3-201123456789", "Name": "Agent" }, { "Id": "12345678-1111-2222-800e-x2y3c4d5fzzzz", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111/security-profile/12345678-1111-2222-800e-x2y3c4d5fzzzz", "Name": "Admin" } ] }

자세한 내용은 Amazon Connect 관리자 안내서권한 할당: 보안 프로필을 참조하세요.

다음 코드 예시에서는 list-user-hierarchy-groups을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 사용자 계층 그룹을 나열하려면

다음 list-user-hierarchy-groups 예제에서는 지정된 Amazon Connect 인스턴스의 사용자 계층 그룹을 나열합니다.

aws connect list-user-hierarchy-groups \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e

출력:

{ "UserHierarchyGroupSummaryList": [ { "Id": "0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent-group/0e2f6d1d-b3ca-494b-8dbc-ba81d9f8182a", "Name": "Example Corporation" }, ] }

자세한 내용은 Amazon Connect 관리자 안내서에이전트 계층 설정을 참조하세요.

다음 코드 예시에서는 list-users을 사용하는 방법을 보여 줍니다.

AWS CLI

인스턴스의 사용자 계층 그룹을 나열하려면

다음 list-users 예제에서는 지정된 Amazon Connect 인스턴스의 사용자를 나열합니다.

aws connect list-users \ --instance-id 40c83b68-ea62-414c-97bb-d018e39e158e

출력:

{ "UserSummaryList": [ { "Id": "0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/0c245dc0-0cf5-4e37-800e-2a7481cc8a60", "Username": "Jane" }, { "Id": "46f0c67c-3fc7-4806-ac99-403798788c14", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/46f0c67c-3fc7-4806-ac99-403798788c14", "Username": "Paulo" }, { "Id": "55a83578-95e1-4710-8af3-2b7afe310e48", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/55a83578-95e1-4710-8af3-2b7afe310e48", "Username": "JohnD" }, { "Id": "703e27b5-c9f0-4f1f-a239-64ccbb160125", "Arn": "arn:aws:connect:us-west-2:123456789012:instance/40c83b68-ea62-414c-97bb-d018e39e158e/agent/703e27b5-c9f0-4f1f-a239-64ccbb160125", "Username": "JohnS" } ] }

자세한 내용은 Amazon Connect 관리자 안내서사용자 추가를 참조하세요.

  • 자세한 API 내용은 명령 참조ListUsers의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-contact-attributes을 사용하는 방법을 보여 줍니다.

AWS CLI

연락처의 속성을 업데이트하려면

다음 update-contact-attributes 예제에서는 지정된 Amazon Connect 사용자의 greetingPlayed 속성을 업데이트합니다.

aws connect update-contact-attributes \ --initial-contact-id 11111111-2222-3333-4444-12345678910 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \ --attributes greetingPlayed=false

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서의 Amazon Connect 연락처 속성 사용을 참조하세요. Amazon Connect

다음 코드 예시에서는 update-user-hierarchy을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 계층을 업데이트하려면

다음 update-user-hierarchy 예제에서는 지정된 Amazon Connect 사용자의 에이전트 계층 구조를 업데이트합니다.

aws connect update-user-hierarchy \ --hierarchy-group-id 12345678-a1b2-c3d4-e5f6-123456789abc \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서에이전트 설정 구성을 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateUserHierarchy의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 update-user-identity-info을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 자격 증명 정보를 업데이트하려면

다음 update-user-identity-info 예제에서는 지정된 Amazon Connect 사용자의 자격 증명 정보를 업데이트합니다.

aws connect update-user-identity-info \ --identity-info FirstName=Mary,LastName=Major,Email=marym@example.com \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서에이전트 설정 구성을 참조하세요.

다음 코드 예시에서는 update-user-phone-config을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 전화 구성을 업데이트하려면

다음 update-user-phone-config 예제에서는 지정된 사용자의 전화 구성을 업데이트합니다.

aws connect update-user-phone-config \ --phone-config PhoneType=SOFT_PHONE,AutoAccept=false,AfterContactWorkTimeLimit=60,DeskPhoneNumber=+18005551212 \ --user-id 12345678-4444-3333-2222-111122223333 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서에이전트 설정 구성을 참조하세요.

다음 코드 예시에서는 update-user-routing-profile을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 라우팅 프로필을 업데이트하려면

다음 update-user-routing-profile 예제에서는 지정된 Amazon Connect 사용자의 라우팅 프로파일을 업데이트합니다.

aws connect update-user-routing-profile \ --routing-profile-id 12345678-1111-3333-2222-4444EXAMPLE \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서에이전트 설정 구성을 참조하세요.

다음 코드 예시에서는 update-user-security-profiles을 사용하는 방법을 보여 줍니다.

AWS CLI

사용자의 보안 프로필을 업데이트하려면

다음 update-user-security-profiles 예제에서는 지정된 Amazon Connect 사용자의 보안 프로파일을 업데이트합니다.

aws connect update-user-security-profiles \ --security-profile-ids 12345678-1234-1234-1234-1234567892111 \ --user-id 87654321-2222-1234-1234-111234567891 \ --instance-id a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

이 명령은 출력을 생성하지 않습니다.

자세한 내용은 Amazon Connect 관리자 안내서권한 할당: 보안 프로필을 참조하세요.