기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS 최종 사용자 메시징 SMS의 전화 풀
그냥 풀이라고도 하는 전화 풀은 메시지를 보내는 데 사용할 수 있는 것과 동일한 설정을 공유하는 전화번호 또는 발신자 ID의 모음입니다. 전화 풀을 통해 메시지를 보낼 경우 적절한 발신 자격 증명을 선택하여 메시지를 전송합니다. 전화 풀 내의 발신 자격 증명이 실패할 경우, 동일한 전화 풀에 다른 발신 자격 증명이 있으면 해당 발신 자격 증명으로 장애 조치가 이루어집니다.
**참고**
전화 풀을 알림 구성과 연결하여 템플릿 메시징에 AWS관리형 자격 증명과 함께 자체 전용 전화 번호를 사용할 수 있습니다. 자세한 내용은 [Notify에서 전용 번호 사용](notify-dedicated-numbers.md) 단원을 참조하십시오.
풀을 생성할 때 지정된 발신 자격 증명을 구성할 수 있습니다. 이 자격 증명에는 키워드, 메시지 유형, 옵트아웃 목록, 양방향 구성, 자체 관리형 옵트아웃 구성이 포함됩니다. 예를 들어 풀을 사용하면 수신 거부된 대상 전화번호의 목록을 특정 국가의 전화번호와 연결할 수 있습니다. 이렇게 하면 이미 메시지 수신을 옵트아웃한 사용자에게 메시지가 전송되지 않도록 할 수 있습니다.
풀에 추가하는 모든 전화번호의 구성은 풀 생성 시 지정한 첫 번째 전화번호의 구성과 일치해야 합니다. 예를 들어 양방향 메시징이 활성화된 전화번호가 포함된 풀을 생성하는 경우 풀에 추가하는 다른 번호에도 양방향 메시징이 활성화되어 있어야 합니다.
AWS RCS 에이전트를 전화번호 및 발신자 IDs와 함께 풀에 발신 자격 증명으로 추가할 수도 있습니다. AWS RCS 에이전트가 풀에 있는 경우 풀은 자동 RCS-to-SMS폴백을 활성화합니다. RCS 전송에 실패하면 서비스는 동일한 풀의 다른 발신 자격 증명을 사용하여 SMS를 통해 메시지를 자동으로 재시도합니다. 풀을 사용하여 RCS 폴백을 구성하는 방법에 대한 자세한 내용은 섹션을 참조하세요[전화 풀을 사용한 RCS에서 SMS로의 대체](rcs-sms-fallback.md).
**Topics**
+ [전화 풀 생성](phone-pool-create.md)
+ [전화번호 또는 발신자 ID 추가](phone-pool-add-number.md)
+ [모든 전화 풀 보기](phone-pool-list.md)
+ [전화 풀 삭제](phone-pool-delete.md)
+ [풀의 수신 거부 목록 변경](phone-pool-manage-opt-out-list.md)
+ [공유 경로 업데이트](phone-pool-shared-routes.md)
+ [전화 풀 삭제 방지 사용](phone-pool-deletion-protection.md)
+ [전화 풀에 대한 태그 관리](phone-pool-tags.md)
+ [공유 전화 풀 나열](phone-pool-shared.md)
+ [풀에서 AWS RCS 에이전트 관리](phone-pool-rcs-agents.md)
# AWS End User Messaging SMS에서 전화 풀 생성
새 전화 풀을 생성하면 추가된 첫 번째 전화번호 또는 발신자 ID의 모든 설정이 상속됩니다. 예를 들어 양방향 메시징이 활성화된 첫 번째 전화번호가 포함된 풀을 생성하는 경우 풀에 추가하는 다른 전화번호에도 양방향 메시징이 활성화되어 있어야 합니다.
------
#### [ Create a phone pool (Console) ]
AWS End User Messaging SMS 콘솔을 사용하여 풀을 생성하려면 다음 절차를 따르세요.
**풀을 생성하려면(콘솔)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 **전화 풀 생성**을 선택합니다.
1. **풀 설정** 섹션의 **풀 이름**에서 풀의 이름을 입력합니다.
1. 다음 옵션 중 하나를 선택합니다.
+ **전화번호** - **연결에 사용할 수 있는 전화번호** 섹션에서 풀과 연결할 전화번호를 선택합니다.
+ **시뮬레이터 번호**(선택 사항) - 전화번호가 없고 시뮬레이터 전화번호를 요청하려는 경우, **전화번호**를 선택한 후 **연결에 사용할 수 있는 전화번호** 섹션에서 다음을 수행합니다.
+ **시뮬레이터 번호 요청**을 선택합니다.
+ **시뮬레이터 번호 요청**의 드롭다운 목록에서 국가를 선택합니다.
+ **번호 요청**을 선택합니다.
+ **연결에 사용할 수 있는 전화번호**에서 새 시뮬레이터 전화번호를 선택합니다.
+ **발신자 ID** - **연결에 사용할 수 있는 발신자 ID** 섹션에서 풀과 연결할 발신자 ID를 선택합니다.
1. (선택 사항) **태그** 섹션을 펼치고 **새 태그 추가**를 선택합니다.
1. 새로운 빈 키/값 페어를 입력합니다.
1. (선택 사항) 다른 태그를 추가하려면 **새 태그 추가**를 선택합니다.
1. **전화 풀 생성**을 선택합니다.
------
#### [ Create a phone pool (AWS CLI) ]
[create-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-pool.html) 명령을 사용하여 새 풀을 생성할 수 있습니다.
`RequestPhoneNumber` API를 사용하여 전화번호를 구매할 때 풀에 전화번호를 추가할 수도 있습니다. 자세한 내용은 [AWS End User Messaging SMS에서 전화번호 요청](phone-numbers-request.md) 섹션을 참조하세요.
**AWS CLI를 사용하여 풀을 생성하려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 create-pool \
> --origination-identity originationIdentity \
> --iso-country-code XX \
> --message-type TRANSACTIONAL
```
위의 명령에서 다음과 같이 변경합니다.
+ *originationIdentity*를 풀에 추가하려는 발신자 ID 또는 전화번호의 고유 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
**작은 정보**
[describe-phone-numbers](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-phone-numbers.html) 작업을 사용하여 전화번호의 ID 및 ARN을 둘 다 찾을 수 있습니다. [describe-sender-ids](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-sender-ids.html) 작업을 사용하여 발신자 ID의 ID 및 ARN을 찾을 수 있습니다.
+ *XX*를 *originationIdentity*에 사용할 국가의 ISO-3166 alpha-2 식별자로 바꿉니다.
+ 풀을 사용하여 마케팅 또는 프로모션 메시지를 보내려는 경우 *TRANSACTIONAL*을 `PROMOTIONAL`으로 바꿉니다. 그렇지 않은 경우 `TRANSACTIONAL`을 사용합니다.
------
# 전화 풀에 전화번호 또는 발신자 ID 추가
다음 지침에 따라 전화번호 또는 발신자 ID를 전화 풀에 추가합니다. 풀에 추가하는 모든 전화번호 또는 발신자 ID의 구성은 전화 풀의 구성과 일치해야 합니다. 예를 들어 양방향 메시징이 활성화된 첫 번째 전화번호가 포함된 풀을 생성하는 경우 풀에 추가하는 다른 전화번호에도 양방향 메시징이 활성화되어 있어야 합니다.
------
#### [ Add a phone number or sender ID to a pool (Console) ]
AWS End User Messaging SMS 콘솔을 사용해 전화번호 또는 발신자 ID를 요청하려면 다음 단계를 따르세요.
**전화번호 또는 발신자 ID 추가(콘솔)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 발신 자격 증명을 추가할 전화 풀을 선택합니다.
1. **연결된 풀 발신자** 탭에서 **발신자 추가**를 선택합니다.
1. 다음 옵션 중 하나를 선택합니다.
+ **전화번호** - 이 옵션을 선택한 경우 **연결에 사용할 수 있는 전화번호** 섹션에서 다음을 수행합니다.
+ 전화 풀에 추가할 전화번호를 선택합니다.
+ **발신자 ID** - 이 옵션을 선택한 경우 **연결에 사용할 수 있는 발신자 ID** 섹션에서 다음을 수행합니다.
+ 발신자 ID를 선택하여 전화 풀을 추가합니다.
1. **풀에 발신자 추가**를 선택합니다.
------
#### [ Add a phone number or sender ID to a pool (AWS CLI) ]
[associate-origination-identity](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/associate-origination-identity.html) CLI를 사용하여 기존 풀에 전화번호 또는 발신자 ID를 추가할 수 있습니다.
풀에 추가하는 모든 전화번호 또는 발신자 ID의 구성은 풀 생성 시 지정한 첫 번째 전화번호 또는 발신자 ID의 구성과 일치해야 합니다. 예를 들어 양방향 메시징이 활성화된 전화번호가 포함된 풀을 생성하는 경우 풀에 추가하는 다른 번호에도 양방향 메시징이 활성화되어 있어야 합니다.
**AWS CLI를 사용하여 풀에 전화번호 또는 발신자 ID를 추가하려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 associate-origination-identity \
> --pool-id poolId \
> --origination-identity originationIdentity \
> --iso-country-code US
```
위의 명령에서 다음과 같이 변경합니다.
+ *poolId*를 발신 ID를 추가하려는 풀의 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
+ *originationIdentity*를 풀에 추가하려는 발신자 ID 또는 전화번호의 고유 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
+ *\$112065550142*를 풀에 추가하려는 발신 ID로 바꿉니다. 이 값은 단축 코드, 전화번호 또는 발신자 ID일 수 있습니다.
+ *US*를 발신 ID 국가의 2자리 ISO-3166 alpha-2 코드로 바꿉니다.
------
#### [ List origination identities (AWS CLI) ]
[list-pool-origination-identities](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/list-pool-origination-identities.html) CLI를 사용하여 특정 풀에 추가된 모든 발신 자격 증명에 대한 정보를 볼 수 있습니다.
**AWS CLI를 사용하여 풀의 발신 ID 목록을 보려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 list-pool-origination-identities \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
이전 명령에서 *poolId*를 풀의 고유 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
------
# AWS End User Messaging SMS에서 모든 전화 풀 보기
[describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI를 사용하여 기존 풀에 대한 정보를 볼 수 있습니다.
이 작업은 AWS End User Messaging SMS 계정에 있는 모든 풀의 전체 목록, 특정 풀에 대한 정보 또는 사용자가 정의한 기준에 따라 필터링된 풀 목록을 제공할 수 있습니다.
**AWS CLI를 사용하여 모든 풀의 목록을 가져오려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 describe-pools
```
특정 풀에 대한 정보를 찾으려면 `PoolId` 파라미터를 사용합니다.
**AWS CLI를 사용하여 특정 풀에 대한 정보를 얻으려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --pool-id poolId
```
이전 명령에서 *poolId*를 풀의 고유 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
필터링된 풀 목록을 보려면 `Filters` 파라미터를 사용합니다. 다음 필터 값을 사용할 수 있습니다.
+ `status` - 풀의 현재 상태, 예:`ACTIVE`.
+ `message-type` - 풀을 사용하여 보내는 메시지 유형. 가능한 값은 `TRANSACTIONAL` 또는 `PROMOTIONAL`입니다.
+ `two-way-enabled` - 풀의 번호에 대해 양방향 SMS 메시징이 활성화되었는지 여부를 나타내는 부울.
+ `self-managed-opt-outs-enabled` - 풀의 번호에 대해 자체 관리형 SMS 옵트아웃이 활성화되었는지 여부를 나타내는 부울.
+ `opt-out-list-name` - 풀과 연결된 옵트아웃 목록의 이름.
+ `shared-routes-enabled`— 풀에 공유 경로를 사용할 수 있는지 여부를 나타내는 부울.
+ `deletion-protection-enabled` - `DeletePhoneNumber` 작업을 사용하여 전화 번호를 삭제할 수 있는지 여부를 나타내는 부울.
예를 들어, 양방향 메시징을 지원하는 트랜잭션 메시지의 풀 목록을 보려면 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 describe-pools \
> --filters Name=message-type,Values=TRANSACTIONAL \
> --filters Name=two-way-enabled,Values=true
```
# AWS End User Messaging SMS에서 전화 풀 삭제
풀을 삭제하려면 우선 **삭제 방지**를 끄고 전화 풀에서 발신자 중 하나를 제외한 모든 발신자를 제거해야 합니다. 삭제 방지를 비활성화하는 방법에 대한 자세한 내용은 [AWS End User Messaging SMS에서 전화 풀 삭제 방지 사용](phone-pool-deletion-protection.md) 섹션을 참조하세요. 풀과 연결된 전화번호 및 발신자 IDs는 AWS End User Messaging SMS 계정에 남아 있습니다.
------
#### [ Delete a phone pool (Console) ]
풀을 삭제하려면 우선 삭제 방지를 끄고 전화 풀에서 모든 발신자를 제거해야 합니다. AWS End User Messaging SMS 콘솔을 사용하여 풀을 삭제하려면 다음 단계를 따릅니다.
**풀을 삭제하려면(콘솔)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/) AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 삭제할 풀을 선택합니다.
1. **삭제**를 선택합니다.
1. **release**를 입력한 다음 **확인**을 입력하여 풀을 삭제합니다.
------
#### [ Delete a phone pool (AWS CLI) ]
풀을 삭제하려면 우선 삭제 방지를 끄고 전화 풀에서 모든 발신자를 제거해야 합니다. [delete-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/delete-pool.html) API를 사용하여 풀을 삭제할 수 있습니다.
**를 사용하여 풀을 삭제하려면 AWS CLI**
+ 풀을 삭제하려면 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 delete-pool \
> --pool-id pool-78ec067f62f94d57bd3bab991example
```
이전 명령에서 *pool-78ec067f62f94d57bd3bab991example*을 풀의 고유 ID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다. [describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) 작업을 사용하여 이 두 값을 모두 찾을 수 있습니다.
------
# AWS End User Messaging SMS에서 풀의 수신 거부 목록 변경
*수신 거부 목록*은 메시지를 전송하면 안 되는 대상 전화번호의 목록입니다. SMS 메시지를 전송할 때 대상 ID가 STOP 키워드로 발신자 번호에 회신하면 옵트아웃 목록에 자동으로 추가됩니다(자체 관리형 옵트아웃 옵션을 활성화하지 않은 경우). 수신 거부 목록에 있는 대상 번호로 메시지를 보내려고 할 때 해당 수신 거부 목록이 메시지 전송에 사용되는 풀과 연결되어 있으면 AWS End User Messaging SMS에서 메시지를 전송하지 않습니다.
기본적으로 풀이 생성되면 해당 풀은 *기본* 수신 거부 목록에 할당됩니다. 풀은 동일한 수신 거부 목록을 서로 공유할 수 있습니다. 풀 수신 거부 목록을 변경하면 이전에 수신 거부한 수신자가 새 목록에 포함되지 않을 수 있으며 메시지를 수신하기 시작할 수 있습니다. 수신 거부 목록에서 대상 전화번호를 추가하거나 제거하는 방법에 대한 자세한 내용은 [AWS End User Messaging SMS의 옵트아웃 목록에 대상 전화번호 추가](opt-out-list-add-phone-number.md) 섹션을 참조하세요.
------
#### [ Change opt-out list (Console) ]
AWS End User Messaging SMS 콘솔을 사용하여 수신 거부 목록을 변경하려면 다음 단계를 따르세요.
**수신 거부 목록 변경**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 풀을 선택합니다.
1. **수신 거부 목록** 탭에서 **설정 편집**을 선택합니다.
+ **새 수신 거부 목록 생성** - 빈 수신 거부 목록을 새로 생성하고 표시 이름을 입력합니다.
+ **기존 수신 거부 목록 선택** - 드롭다운에서 이전에 생성한 수신 거부 목록을 선택합니다.
1. (선택 사항) 자체 관리형 수신 거부를 활성화하려면 **자체 관리형 수신 거부 활성화**를 선택합니다.
1. **변경 사항 저장**을 선택합니다.
------
#### [ Change opt-out list (AWS CLI) ]
[update-pool](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/update-pool.html) 명령을 사용하여 풀에서 사용된 수신 거부 목록을 변경할 수 있습니다.
명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 update-pool --pool-id poolid --opt-out-list-name OptOutListName
```
위의 명령에서 다음과 같이 변경합니다.
+ *poolid*를 풀의 poolID 또는 Amazon 리소스 이름(ARN)으로 바꿉니다.
+ *OptOutListName*을 Amazon 리소스 이름(ARN) 또는 수신 거부 목록 이름으로 바꿉니다.
------
# AWS End User Messaging SMS에서 공유 경로 업데이트
일부 국가에서는 AWS End User Messaging SMS에서 공유 발신 ID 풀을 유지 관리합니다. 공유 경로를 활성화하면 AWS End User Messaging SMS에서 공유 ID 중 하나를 사용하여 메시지를 전송하도록 수행합니다. 발신 자격 증명은 발신자 ID, 긴 코드 또는 단축 코드일 수 있으며 국가마다 다를 수 있습니다. 공유 경로가 발신자 ID를 발신 자격 증명으로 사용하는 경우 발신자 ID는 일반 발신자 ID(예: `NOTICE`)가 됩니다. 미국을 비롯한 일부 국가에서는 공유 자격 증명을 사용할 수 없습니다.
**참고**
공유 경로는 다운스트림 필터링이 증가할 수 있으며, 가능한 경우 전용 경로를 사용하는 것이 좋습니다.
**공유 경로를 켜는 방법(AWS Management Console)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 공유 경로가 활성화된 풀을 선택합니다.
1. **공유 경로** 탭에서 **설정 편집** 버튼을 선택합니다.
1. **공유 경로 활성화**를 선택한 다음 **변경 사항 저장**을 선택합니다.
# AWS End User Messaging SMS에서 전화 풀 삭제 방지 사용
삭제 방지를 켜면 삭제 방지 기능을 비활성화할 때까지 풀을 삭제할 수 없습니다. 기본적으로 삭제 방지 기능은 비활성화됩니다.
**삭제 방지 활성화(콘솔)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 삭제를 활성화할 전화 풀을 선택합니다.
1. **삭제 방지** 탭에서 **설정 편집**을 선택합니다.
1. **삭제 방지 활성화**를 선택한 다음 **변경 사항 저장**을 선택합니다.
# 전화 풀에 대한 AWS End User Messaging SMS 태그 관리
태그는 액세스 또는 사용량을 제어하기 위해 AWS 리소스에 선택적으로 적용할 수 있는 키와 값의 쌍입니다. 이름 키/값 페어의 값을 편집하여 풀 이름을 변경하려면
------
#### [ Manage tags (Console) ]
AWS End User Messaging SMS 콘솔을 사용하여 풀에서 태그를 추가하거나 편집합니다.
**태그 관리(콘솔)**
1. [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/)에서 AWS End User Messaging SMS 콘솔을 엽니다.
1. 탐색 창의 **구성**에서 **전화 풀**을 선택합니다.
1. **전화 풀** 페이지에서 태그를 추가할 전화 풀을 선택합니다.
1. **태그** 탭에서 **태그 관리**를 선택합니다.
+ **태그 추가** - **태그 관리**에서 **새 태그 추가**를 선택하여 새 빈 키/값 페어를 생성합니다.
+ **태그 삭제** - **태그 관리**에서 키/값 페어 옆에 있는 **제거**를 선택합니다.
+ **태그 편집** - **태그 관리**에서 **키** 또는 **값을** 선택하고 텍스트를 편집합니다.
1. **변경 사항 저장**을 선택합니다.
------
#### [ Manage tags (AWS CLI) ]
AWS CLI를 사용하여 태그를 추가하거나 편집합니다.
```
$ aws pinpoint-sms-voice-v2 tag-resource \
--resource-arn resource-arn \
--tags tags={key1=value1,key2=value2}
```
이전 예제에서 다음을 수행합니다.
+ *resource-arn*을 태그를 추가하려는 Amazon 리소스 이름(ARN)으로 바꿉니다.
+ *key1* 및 *key2*를 리소스에 추가하려는 태그의 키로 바꿉니다.
+ *value1* 및 *value2*를 각 키에 추가하려는 태그의 값으로 바꿉니다.
AWS CLI를 사용하여 태그를 삭제합니다.
```
$ aws pinpoint-sms-voice-v2 untag-resource \
--resource-arn resource-arn \
--tag-keys tags={key1=value1,key2=value2}
```
이전 예제에서 다음을 수행합니다.
+ *resource-arn*을 태그를 제거하려는 Amazon 리소스 이름(ARN)으로 바꿉니다.
+ *key1* 및 *key2*를 제거하려는 태그의 키로 바꿉니다.
+ *value1* 및 *value2*를 제거하려는 태그의 값으로 바꿉니다.
------
# AWS CLI를 사용하여 공유 전화 풀 나열
[describe-pools](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-pools.html) CLI 또는 [AWS RAM 콘솔](https://console.aws.amazon.com/ram)을 사용하여 계정과 공유된 풀에 대한 정보를 볼 수 있습니다. 공유 리소스에 관한 자세한 내용은 [AWS End User Messaging SMS에서 공유 리소스 작업](shared-resources.md) 섹션을 참조하세요.
**AWS CLI를 사용하여 공유 풀의 목록을 검색하려면**
+ 명령줄에 다음 명령을 입력합니다.
```
$ aws pinpoint-sms-voice-v2 describe-pools --owner SHARED
```
이전 명령에서 *SHARED*를 *SELF*로 바꾸어 계정에서 소유한 풀을 나열합니다.
# 풀에서 AWS RCS 에이전트 관리
SMS 전화번호와 함께 전화 풀에 AWS RCS 에이전트를 발신 자격 증명으로 추가할 수 있습니다. 풀에 AWS RCS 에이전트와 SMS 전화번호가 모두 포함된 경우 AWS End User Messaging은 먼저 RCS 전송을 시도하고 RCS 전송이 불가능한 경우 자동으로 SMS로 돌아갑니다. 폴백 작동 방식에 대한 자세한 내용은 섹션을 참조하세요[전화 풀을 사용한 RCS에서 SMS로의 대체](rcs-sms-fallback.md).
**참고**
AWS RCS 에이전트를 풀에 추가할 때를 ISO 국가 코드`ZZ`로 사용합니다. `ZZ` 코드는 RCS 에이전트가 풀 수준에서 국가별로 고유하지 않음을 나타냅니다. 국가별 라우팅은 에이전트의 국가 시작 등록을 통해 처리됩니다. 풀에는 RCS 에이전트와 함께 여러 국가의 전화번호가 포함될 수 있습니다.
ISO 국가 코드는 풀 생성 시 제공되지만 풀에는 유지되지 않습니다. `DescribePools`를 호출하면 ISO 국가 코드가 응답에 표시되지 않습니다.
## AWS RCS 에이전트를 사용하여 풀 생성
AWS End User Messaging 콘솔 또는 `CreatePool` API를 사용하여 AWS RCS 에이전트가 포함된 새 풀을 생성할 수 있습니다.
------
#### [ Console ]
**콘솔을 사용하여 AWS RCS 에이전트로 풀을 생성하려면**
1. AWS End User Messaging 콘솔을 엽니다.
1. 탐색 창에서 **전화 풀을** 선택합니다.
1. **풀 생성(Create pool)**을 선택합니다.
1. **발신 자격 증명**에서 AWS RCS 에이전트를 선택합니다. 풀은 선택한 발신 자격 증명에서 구성을 상속합니다.
1. 필요에 따라 풀 설정을 구성한 다음 **풀 생성을** 선택합니다.
1. 풀을 생성한 후 풀에 SMS 전화번호를 추가하여 SMS 폴백을 활성화합니다. 풀의 모든 발신 자격 증명에는 일치하는 구성이 있어야 합니다. 자세한 내용은 [RCS에 대한 풀 구성 요구 사항](#phone-pool-rcs-config)을 참조하세요.
------
#### [ AWS CLI ]
`CreatePool` API를 사용하여 AWS RCS 에이전트를 초기 발신 자격 증명으로 사용하여 풀을 생성합니다. 풀을 생성할 때 AWS RCS 에이전트 ARN을 발신 자격 증명으로 지정합니다.
다음 예제에서는 AWS CLI를 사용하여 풀을 생성합니다.
```
aws pinpoint-sms-voice-v2 create-pool \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ \
--message-type TRANSACTIONAL
```
풀을 생성한 후 `AssociateOriginationIdentity` API를 사용하여 폴백을 위해 풀에 SMS 전화번호를 추가합니다.
------
## 기존 풀에 AWS RCS 에이전트 추가
SMS 전화번호가 있는 풀이 이미 있는 경우 풀에 AWS RCS 에이전트를 추가하여 SMS 폴백을 통한 RCS 메시징을 활성화할 수 있습니다. AWS RCS 에이전트가 이미 포함된 풀에 SMS 전화번호를 추가할 수도 있습니다.
**중요**
기존 풀에 발신 자격 증명을 추가하기 전에 풀의 구성이 추가하려는 자격 증명과 일치하는지 확인합니다. 풀의 모든 발신 자격 증명에는 동일한 메타데이터가 있어야 합니다. 불일치가 있는 경우 작업은와 함께 실패합니다`ConflictException`. 일치시켜야 하는 필드와 불일치를 해결하는 방법에 대한 자세한 내용은 섹션을 참조하세요[RCS에 대한 풀 구성 요구 사항](#phone-pool-rcs-config).
------
#### [ Console ]
콘솔을 사용하여 풀에 AWS RCS 에이전트를 추가하기 전에 풀의 세부 정보 페이지를 검사하여 현재 구성을 검토합니다. 풀의 메시지 유형, ISO 국가 코드 및 기타 설정이 추가하려는 AWS RCS 에이전트와 호환되는지 확인합니다.
**콘솔을 사용하여 기존 풀에 AWS RCS 에이전트를 추가하려면**
1. AWS End User Messaging 콘솔을 엽니다.
1. 탐색 창에서 **전화 풀을** 선택합니다.
1. AWS RCS 에이전트를 추가할 풀을 선택합니다.
1. 세부 정보 페이지에서 풀의 구성을 검토합니다. 메시지 유형 및 기타 설정이 추가하려는 AWS RCS 에이전트와 일치하는지 확인합니다.
1. **발신 자격 증명** 섹션에서 **발신 자격 증명 추가를** 선택합니다.
1. 목록에서 AWS RCS 에이전트를 선택하고 **추가**를 선택합니다.
------
#### [ AWS CLI ]
CLI 또는 API를 사용하여 풀에 AWS RCS 에이전트를 추가하기 전에 `DescribePools` API를 사용하여 풀의 현재 구성을 검색합니다. 풀의 설정이 추가하려는 AWS RCS 에이전트와 일치하는지 확인합니다.
다음 예시에서는 풀 세부 정보를 검색합니다.
```
aws pinpoint-sms-voice-v2 describe-pools \
--pool-ids pool-id
```
구성 일치를 확인한 후 `AssociateOriginationIdentity` API를 사용하여 AWS RCS 에이전트를 풀에 추가합니다.
```
aws pinpoint-sms-voice-v2 associate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
------
## RCS에 대한 풀 구성 요구 사항
풀의 모든 발신 자격 증명에는 동일한 메타데이터가 있어야 합니다. 풀에 발신 자격 증명을 추가하면 AWS End User Messaging은 자격 증명의 구성을 풀의 기존 구성과 비교합니다. 불일치가 있는 경우 다른 특정 필드에 대한 세부 정보가 `ConflictException` 포함된에서 작업이 실패합니다.
풀 구성 필드는 풀이 생성될 때 설정되고 변경할 수 없는 변경 불가능한 필드와 생성 후 업데이트할 수 있는 변경 가능한 필드의 두 가지 범주로 나뉩니다.
**변경 불가능 풀 구성 필드와 변경 가능 풀 구성 필드**
| Field | 변경 가능성 | 참고 |
| --- | --- | --- |
| 메시지 유형 | 변경 불가능 | 풀 생성 시를 설정합니다. 모든 자격 증명이 일치해야 합니다. |
| ISO 국가 코드 | 변경 불가능 | 풀 생성 시를 설정합니다. AWS RCS 에이전트의 경우 값은 입니다ZZ. 풀에는 여러 국가의 전화번호가 포함될 수 있습니다. |
| 삭제 방지 | Mutable | 생성 후 전환할 수 있습니다. 자격 증명 간에 일관되어야 합니다. |
| 수신 거부 목록 | Mutable | 생성 후 변경할 수 있습니다. 자격 증명 간에 일관되어야 합니다. |
다음 구성 필드는 풀의 모든 발신 자격 증명에서 일치해야 합니다.
+ **메시지 유형** - 모든 자격 증명을 동일한 메시지 유형(예: TRANSACTIONAL 또는 PROMOTIONAL)으로 구성해야 합니다.
+ **ISO 국가 코드** - 풀 생성 시 설정합니다. AWS RCS 에이전트의 경우를 ISO 국가 코드`ZZ`로 사용합니다. 풀에는 여러 국가의 전화번호가 포함될 수 있습니다.
+ **삭제 방지** - 삭제 방지 설정은 자격 증명 간에 일관되어야 합니다.
+ **옵트아웃 목록** - 모든 자격 증명이 동일한 옵트아웃 목록과 연결되어 있거나 옵트아웃 목록이 없어야 합니다.
### ConflictException 오류 이해
풀에 발신 자격 증명을 추가하려고 하는데 구성이 일치하지 않으면 `AssociateOriginationIdentity` 또는 `CreatePool` API가를 반환합니다`ConflictException`. 예외 메시지에는 자격 증명과 풀 간에 다른 필드에 대한 세부 정보가 포함됩니다.
예를 들어 TRANSACTIONAL 메시지에 대해 구성된 풀에 PROMOTIONAL 메시지에 대해 구성된 전화번호를 추가하려고 하면 오류 메시지는 메시지 유형이 일치하지 않음을 나타냅니다.
를 해결하려면`ConflictException`:
1. 오류 메시지를 검토하여 어떤 필드가 다른지 식별합니다.
1. 필드가 일치하도록 발신 자격 증명 또는 풀 구성을 업데이트합니다.
1. `AssociateOriginationIdentity` 또는 `CreatePool` 작업을 다시 시도합니다.
**참고**
구성 불일치를 해결할 수 없는 경우 발신 자격 증명에 대해 별도의 풀을 생성하는 것이 좋습니다. 각 풀에는 고유한 구성이 있을 수 있으며 사용 사례에 따라 다른 풀을 사용할 수 있습니다.
## 풀에서 AWS RCS 에이전트 제거
AWS End User Messaging 콘솔 또는 `DisassociateOriginationIdentity` API를 사용하여 풀에서 AWS RCS 에이전트를 제거할 수 있습니다. 풀에서 AWS RCS 에이전트를 제거하면 해당 풀을 통해 전송된 메시지에 대한 RCS 전송이 비활성화됩니다. 에이전트가 제거된 후 풀로 전송된 메시지는 SMS를 통해서만 전송됩니다(풀의 나머지 전화번호 사용).
------
#### [ Console ]
**콘솔을 사용하여 풀에서 AWS RCS 에이전트를 제거하려면**
1. AWS End User Messaging 콘솔을 엽니다.
1. 탐색 창에서 **전화 풀을** 선택합니다.
1. 제거할 AWS RCS 에이전트가 포함된 풀을 선택합니다.
1. **발신 자격 증명** 섹션에서 AWS RCS 에이전트를 선택합니다.
1. **제거**를 선택한 다음 제거를 확인합니다.
------
#### [ AWS CLI ]
`DisassociateOriginationIdentity` API를 사용하여 풀에서 AWS RCS 에이전트를 제거합니다.
```
aws pinpoint-sms-voice-v2 disassociate-origination-identity \
--pool-id pool-id \
--origination-identity arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id \
--iso-country-code ZZ
```
AWS RCS 에이전트를 제거한 후 풀을 통해 전송된 메시지는 SMS를 통해서만 전송됩니다. RCS 전송을 다시 활성화하려면 `AssociateOriginationIdentity` API를 사용하여 AWS RCS 에이전트를 풀에 다시 추가합니다.
------