View a markdown version of this page

메시지당 SMS 또는 MMS 폴백 구성 - AWS 최종 사용자 메시징 SMS

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

메시지당 SMS 또는 MMS 폴백 구성

RCS 메시지를 보내면 수신자의 디바이스가 RCS를 지원하지 않거나 메시지가 전송 전에 만료될 수 있습니다. 메시지당 폴백을 사용하면 RCS 메시지가 수신자에게 도달할 수 없을 때 AWSEnd User Messaging이 자동으로 전송하는 대체 SMS 또는 MMS 콘텐츠를 지정할 수 있습니다. FallbackConfiguration 파라미터를 포함하여 각 SendRcsMessage 요청에 대해 대체를 구성합니다.

폴백 트리거 시

AWSEnd User Messaging은 두 가지 상황에서 대체 메시지를 트리거합니다.

  • 즉각적인 RCS 실패: 수신자의 디바이스 또는 통신사가 RCS를 지원하지 않거나 RCS 채널이 메시지를 거부합니다.

  • TTL 만료: TimeToLive 값을 설정하면 타이머가 만료되기 전에 메시지가 전송되지 않습니다. 메시지 만료에 대한 자세한 내용은 섹션을 참조하세요RCS 메시지 만료 구성.

요청에 FallbackConfiguration를 포함하지 않고 RCS 메시지가 실패하거나 만료되면 폴백 메시지가 전송되지 않습니다.

풀 기반 폴백과 메시지당 폴백 비교

의 메시지별 폴백은에서 사용할 수 있는 자동 풀 기반 폴백과 SendRcsMessage 다릅니다SendTextMessage. 풀 기반 대체에 대한 자세한 내용은 섹션을 참조하세요전화 풀을 사용한 RCS에서 SMS로의 대체.

대체 메커니즘 비교
기능 풀 기반 대체(SendTextMessage) 메시지당 폴백(SendRcsMessage)
구성 풀에 RCS 에이전트와 SMS 자격 증명이 모두 포함된 경우 자동 명시적: 각 요청에 FallbackConfiguration 포함
폴백 채널 SMS(풀에서 선택) SMS 또는 MMS(로 선택Channel)
폴백 콘텐츠 동일한 메시지 본문 SMS 또는 MMS에 맞게 조정된 별도의 콘텐츠를 제공합니다.
자격 증명 선택 풀은 발신 자격 증명을 선택합니다. 전화번호 또는 발신자 ID를 지정합니다.
트리거 RCS 지원되지 않음(제한 시간 기반) 즉각적인 RCS 실패 또는 TTL 만료

FallbackConfiguration 구조

FallbackConfiguration 파라미터는 SendRcsMessage 요청에 대한 단일 객체입니다. 대체가 SMS인지 MMS인지 표시하도록 Channel 필드를 설정한 다음 해당 콘텐츠 필드를 제공합니다.

FallbackConfiguration 필드
Field 유형 필수 설명
Channel 문자열 대체 채널입니다. 유효한 값: SMS 또는 MMS.
MessageBody 문자열 조건부 대체 메시지의 텍스트 본문입니다. 최대 1,600자. Channel가 일 때 필요합니다SMS. 의 경우 MessageBody 또는 중 하나 MMS이상을 제공해야 MediaUrls 합니다.
MediaUrls 문자열 목록 조건부 MMS 폴백에 대한 하나 이상의 미디어 URLs입니다. 의 경우 MessageBody 또는 중 하나 MMS이상을 제공해야 MediaUrls 합니다.
OriginationIdentity 문자열 조건부 폴백 메시지의 발신 자격 증명입니다. 전화번호 또는 발신자 ID(값, ID 또는 ARN 기준)를 수락합니다. 풀 또는 RCS 에이전트를 지정할 수 없습니다. 이 필드를 생략하고 원본 메시지가 풀을 통해 전송된 경우 서비스는 해당 풀에서 적절한 번호를 선택합니다.
중요

폴백 MessageBody 제한은 1,600자입니다. 이는 RCS TextMessage 본문에 대한 3,072자 제한보다 짧습니다. SMS 또는 MMS 문자 제약 조건에 맞게 폴백 콘텐츠를 합성합니다.

다음 JSON은 SMS 폴백에 대한 FallbackConfiguration 객체의 구조를 보여줍니다.

{ "Channel": "SMS", "MessageBody": "Your order has shipped. Track at https://example.com/track/12345", "OriginationIdentity": "+18005550199" }

다음 JSON은 MMS 폴백의 구조를 보여줍니다.

{ "Channel": "MMS", "MessageBody": "Your order has shipped.", "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"], "OriginationIdentity": "+18005550199" }

SMS 대체 구성

SMS로 돌아가려면를 Channel로 설정하고를 SMS 제공합니다MessageBody. SMS는 제안 칩 또는 리치 카드를 지원하지 않으므로 메시지 본문에 중요한 URLs 일반 텍스트로 포함합니다.

MMS 대체 구성

MMS로 돌아가려면를 MMS Channel로 설정하고에서 하나 이상의 미디어 URLs 제공합니다MediaUrls. RCS 메시지에 시각적 콘텐츠(예: 이미지가 있는 리치 카드)가 포함되어 있고 RCS를 지원하지 않는 수신자의 시각적 환경을 보존하려는 경우 MMS 폴백을 사용합니다.

폴백을 메시지 만료와 결합

요청 FallbackConfigurationTimeToLive 및를 모두 설정하면 AWSEnd User Messaging은 TTL 기간 동안 RCS 전송을 시도합니다. 타이머가 만료되기 전에 메시지가 전송되지 않으면 서비스가 대체 메시지를 보냅니다. 이 패턴은 일회용 암호 또는 약속 미리 알림과 같은 시간에 민감한 콘텐츠에 유용합니다.

메시지 만료 구성에 대한 자세한 내용은 섹션을 참조하세요RCS 메시지 만료 구성.

다음 예제에서는 SMS 폴백을 사용하여 60초 TTL을 설정합니다.

{ "DestinationPhoneNumber": "+12065550100", "OriginationIdentity": "rcs-agent-1234567890", "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}", "TimeToLive": 60, "FallbackConfiguration": { "Channel": "SMS", "MessageBody": "Your verification code is 483291.", "OriginationIdentity": "+18005550199" } }

모범 사례

  • 대체 콘텐츠를 별도로 작성합니다. 리치 RCS 콘텐츠(제안 칩, 리치 카드, 캐러셀)는 SMS 또는 MMS로 직접 변환되지 않습니다. RCS 본문 축어를 재사용하는 대신 간결하고 독립적인 폴백 메시지를 작성합니다.

  • SMS 폴백에 URLs 일반 텍스트로 포함합니다. 대화형 제안 칩(예: OpenUrl 작업)을의 인라인 URLs로 바꿉니다MessageBody.

  • 시각적 콘텐츠에 MMS 폴백을 사용합니다. RCS 메시지에 이미지가 포함된 리치 카드 또는 캐러셀이 있는 경우 MMS 폴백은 RCS 지원 없이 수신자의 시각적 컨텍스트를 유지합니다.

  • 적절한 TTL을 설정합니다. 폴백을와 결합할 때 전송 시도와 타임라인의 균형을 맞추는 TTL을 TimeToLive선택합니다. 시간에 민감한 메시지의 경우 30~60초의 TTL은 감소하기 전에 짧은 RCS 전송 기간을 제공합니다. 일반 메시지의 경우 기간이 길수록(분~시간) RCS 채널이 성공할 기회가 늘어납니다.

  • 발신 자격 증명을 확인합니다. 대체 구성OriginationIdentity의는 AWS최종 사용자 메시징 계정에 등록되어 대상 국가로 SMS 또는 MMS를 전송할 수 있는 전화번호 또는 발신자 ID여야 합니다.