View a markdown version of this page

RCS 문자 메시지 전송 - AWS 최종 사용자 메시징 SMS
RCS 문자 메시지와 SMS의 차이점텍스트 메시지에 대한 RcsMessageContent 구조문자 메시지 전송SMS 또는 MMS 대체문자 메시지 제한문자 메시지 사용 시기

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

RCS 문자 메시지 전송

TextMessage는 SendRcsMessage API로 전송할 수 있는 가장 간단한 콘텐츠 유형입니다. 메시지 아래에 대화형 버튼으로 표시되는 선택적 제안 칩이 있는 일반 텍스트 본문(최대 3,072자)으로 구성됩니다.

RCS 문자 메시지와 SMS의 차이점

를 통해 전송되는 텍스트 메시지는 다음 두 가지 방법으로 SendTextMessage (SMS)를 통해 전송되는 것과 SendRcsMessage 다릅니다.

  • 제안 칩: RCS 텍스트 메시지에 최대 11개의 제안 칩을 연결할 수 있습니다. 이러한 칩을 사용하면 수신자가 한 번에 회신하거나, URL을 열거나, 전화번호로 전화를 걸거나, 위치를 공유하거나, 일정 이벤트를 생성할 수 있습니다. SMS는 제안을 지원하지 않습니다.

  • 단일 메시지 전송: 길이(최대 3,072자)에 관계없이 RCS 텍스트 메시지가 단일 메시지로 도착합니다. 통신 사업자는 160자를 초과하는 SMS 메시지를 여러 세그먼트로 분할하며, 이는 순서에 맞지 않거나 세그먼트 간에 지연이 발생할 수 있습니다.

사용 가능한 모든 제안 유형 및 해당 파라미터에 대한 자세한 내용은 섹션을 참조하세요RCS 제안 구성.

텍스트 메시지에 대한 RcsMessageContent 구조

를 호출할 때 메시지 페이로드를 RcsMessageContent 파라미터로 SendRcsMessage전달합니다. 텍스트 메시지의 경우 Content 필드를 Body 문자열이 포함된 TextMessage 객체로 설정합니다. 제안 칩을 포함하려면 Suggestions 배열을의 최상위 형제로 추가합니다Content.

다음 JSON 코드 조각은 제안RcsMessageContent이 포함된 텍스트 메시지의 구조를 보여줍니다.

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

이 예시는 다음과 같이 설정되어 있습니다.

  • Content.TextMessage.Body 에는 메시지 텍스트(필수, 1~3,072자)가 포함되어 있습니다.

  • Suggestions는 최상위 배열입니다(선택 사항, 최대 11개 항목). 각 제안에는 Text 필드(최대 25자)와 PostbackData 필드(최대 2,048자)가 필요합니다.

Suggestions 배열은 , Reply, , OpenUrl, DialPhoneRequestLocation, ShowLocation의 6가지 작업 유형을 지원합니다CreateCalendarEvent. 단일 메시지에서 다양한 제안 유형을 혼합할 수 있습니다. 각 유형에 대한 자세한 내용은 섹션을 참조하세요RCS 제안 구성.

문자 메시지 전송

RCS 문자 메시지를 보내려면 다음 필수 파라미터SendRcsMessage와 함께를 호출합니다.

  • DestinationPhoneNumber: E.164 형식의 수신자 전화번호입니다.

  • OriginationIdentity: 메시지를 보내는 풀 ID 또는 AWS RCS 에이전트입니다.

  • RcsMessageContent: TextMessage 객체Content가 포함된를 포함하는 JSON 문자열입니다.

AWS CLI(aws pinpoint-sms-voice-v2 send-rcs-message) 또는 boto3 pinpoint-sms-voice-v2 클라이언트와 같은 AWS SDK를 사용하여 API를 호출합니다.

SMS 또는 MMS 대체

수신자의 디바이스가 RCS를 지원하지 않거나 RCS 채널에서 일시적으로 연결할 수 없는 경우 SMS 또는 MMS로 돌아가도록 메시지를 구성할 수 있습니다. 대체를 활성화하려면 SendRcsMessage 요청에 FallbackConfiguration 객체를 포함합니다. 는 폴백 메시지에 사용할 폴백 채널(SMS 또는 MMS), 폴백 메시지 본문 및 발신 자격 증명(전화 번호 또는 발신자 ID)을 FallbackConfiguration 지정합니다.

폴백은 선택 사항입니다. 생략FallbackConfiguration했는데 수신자가 RCS를 수신할 수 없는 경우 메시지가 전송되지 않습니다.

대체 동작 구성에 대한 자세한 내용은 섹션을 참조하세요리치 RCS 메시지 전송.

문자 메시지 제한

Resource Limit 참고
메시지 본문(Body) 3,072자(UTF-8) 필수 사항입니다. 1자 이상이어야 합니다.
메시지당 제안 사항 11 총 회신 및 작업 수입니다.
제안 표시 텍스트(Text) 25자 모든 제안 유형에 적용됩니다.
포스트백 데이터(PostbackData) 2,048자 모든 제안 유형에 필요합니다.

문자 메시지 사용 시기

를 다음 TextMessage 용도로 사용합니다.

  • 주문 확인, 배송 업데이트 및 예약 알림과 같은 알림.

  • 일회용 암호 및 확인 코드.

  • 응답 옵션을 제안 칩으로 제공하여 자유 텍스트 입력 없이 안내 상호 작용을 활성화하는 대화 프롬프트입니다.

  • 콘텐츠에 이미지나 구조화된 레이아웃이 필요하지 않은 짧은 상태 업데이트입니다.

제목과 설명이 포함된 이미지, 비디오 또는 구조화된 레이아웃이 필요한 메시지의 경우 대신 리치 카드 또는 캐러셀을 사용합니다. 리치 RCS 메시지 전송을(를) 참조하세요.