View a markdown version of this page

풀에서 AWS RCS 에이전트 관리 - AWS 최종 사용자 메시징 SMS
AWS RCS 에이전트를 사용하여 풀 생성기존 풀에 AWS RCS 에이전트 추가RCS에 대한 풀 구성 요구 사항풀에서 AWS RCS 에이전트 제거

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

풀에서 AWS RCS 에이전트 관리

SMS 전화번호와 함께 전화 풀에 AWS RCS 에이전트를 발신 자격 증명으로 추가할 수 있습니다. 풀에 AWS RCS 에이전트와 SMS 전화번호가 모두 포함된 경우 AWS End User Messaging은 먼저 RCS 전송을 시도하고 RCS 전송이 불가능한 경우 자동으로 SMS로 돌아갑니다. 폴백 작동 방식에 대한 자세한 내용은 섹션을 참조하세요전화 풀을 사용한 RCS에서 SMS로의 대체.

참고

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 콘솔을 엽니다.

  2. 탐색 창에서 전화 풀을 선택합니다.

  3. 풀 생성(Create pool)을 선택합니다.

  4. 발신 자격 증명에서 AWS RCS 에이전트를 선택합니다. 풀은 선택한 발신 자격 증명에서 구성을 상속합니다.

  5. 필요에 따라 풀 설정을 구성한 다음 풀 생성을 선택합니다.

  6. 풀을 생성한 후 풀에 SMS 전화번호를 추가하여 SMS 폴백을 활성화합니다. 풀의 모든 발신 자격 증명에는 일치하는 구성이 있어야 합니다. 자세한 내용은 RCS에 대한 풀 구성 요구 사항을 참조하세요.

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에 대한 풀 구성 요구 사항.

Console

콘솔을 사용하여 풀에 AWS RCS 에이전트를 추가하기 전에 풀의 세부 정보 페이지를 검사하여 현재 구성을 검토합니다. 풀의 메시지 유형, ISO 국가 코드 및 기타 설정이 추가하려는 AWS RCS 에이전트와 호환되는지 확인합니다.

콘솔을 사용하여 기존 풀에 AWS RCS 에이전트를 추가하려면

  1. AWS End User Messaging 콘솔을 엽니다.

  2. 탐색 창에서 전화 풀을 선택합니다.

  3. AWS RCS 에이전트를 추가할 풀을 선택합니다.

  4. 세부 정보 페이지에서 풀의 구성을 검토합니다. 메시지 유형 및 기타 설정이 추가하려는 AWS RCS 에이전트와 일치하는지 확인합니다.

  5. 발신 자격 증명 섹션에서 발신 자격 증명 추가를 선택합니다.

  6. 목록에서 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. 오류 메시지를 검토하여 어떤 필드가 다른지 식별합니다.

  2. 필드가 일치하도록 발신 자격 증명 또는 풀 구성을 업데이트합니다.

  3. AssociateOriginationIdentity 또는 CreatePool 작업을 다시 시도합니다.

참고

구성 불일치를 해결할 수 없는 경우 발신 자격 증명에 대해 별도의 풀을 생성하는 것이 좋습니다. 각 풀에는 고유한 구성이 있을 수 있으며 사용 사례에 따라 다른 풀을 사용할 수 있습니다.

풀에서 AWS RCS 에이전트 제거

AWS End User Messaging 콘솔 또는 DisassociateOriginationIdentity API를 사용하여 풀에서 AWS RCS 에이전트를 제거할 수 있습니다. 풀에서 AWS RCS 에이전트를 제거하면 해당 풀을 통해 전송된 메시지에 대한 RCS 전송이 비활성화됩니다. 에이전트가 제거된 후 풀로 전송된 메시지는 SMS를 통해서만 전송됩니다(풀의 나머지 전화번호 사용).

Console
콘솔을 사용하여 풀에서 AWS RCS 에이전트를 제거하려면

  1. AWS End User Messaging 콘솔을 엽니다.

  2. 탐색 창에서 전화 풀을 선택합니다.

  3. 제거할 AWS RCS 에이전트가 포함된 풀을 선택합니다.

  4. 발신 자격 증명 섹션에서 AWS RCS 에이전트를 선택합니다.

  5. 제거를 선택한 다음 제거를 확인합니다.

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 에이전트를 풀에 다시 추가합니다.