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

RCS 제안 구성

제안은 RCS 메시지 아래 또는 내에 나타나는 대화형 칩입니다. 수신자가 입력할 필요 없이 URL 열기, 전화 번호 호출 또는 위치 공유와 같은 사전 정의된 응답과 작업을 제시하여 대화 과정을 안내합니다. 제안 사항은를 사용하여 대화형 대화형 경험을 구축하는 방법입니다SendRcsMessage.

두 가지 수준에서 모든 콘텐츠 유형(텍스트, 파일, 리치 카드 및 캐러셀)에 제안을 추가할 수 있습니다.

AWSEnd User Messaging은 , Reply, , OpenUrl, RequestLocation, ShowLocationDialPhone의 6가지 제안 유형을 지원합니다CreateCalendarEvent. 모든 제안에는 Text 레이블(최대 25자)과 PostbackData (최대 2,048자)이 필요합니다.

포스트백 데이터의 작동 방식

각 제안에는 수신자가 제안을 선택할 때 AWSEnd User Messaging이 애플리케이션으로 다시 보내는 최대 2,048자의 PostbackData 문자열이 포함됩니다. 포스트백 데이터는 수신자에게 표시되지 않습니다. 이를 사용하여 라우팅 정보, 의도 식별자, 세션 컨텍스트 또는 백엔드가 선택을 처리하는 데 필요한 메타데이터를 인코딩합니다.

수신자가 제안을 선택하면 AWSEnd User Messaging은 양방향 메시징을 위해 구성한 Amazon SNS 주제에 인바운드 메시지 이벤트를 전송합니다. 표시 텍스트postbackData가 아닌에 로직을 라우팅합니다. 인바운드 이벤트에 대한 자세한 내용은 섹션을 참조하세요RCS 메시지 이벤트.

제안 표시

Reply

Reply 제안은 미리 정의된 텍스트 회신을 에이전트에게 다시 보냅니다. 디스플레이 텍스트는 대화에서 전송된 메시지로 표시되며 PostbackData는 애플리케이션에 전달됩니다.

{ "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } }

OpenUrl

OpenUrl 제안은 URL을 엽니다. 기본적으로 URL은 디바이스 브라우저에서 열립니다. 메시징 앱 내에 수신자를 유지하는 웹 보기에서 URL을 열려면를 Application로 설정하고를 WEBVIEW 지정합니다WebviewViewMode.

{
  "OpenUrl": {
    "Text": "Complete payment",
    "PostbackData": "pay_12345",
    "Url": "https://example.com/pay",
    "Application": "WEBVIEW",
    "WebviewViewMode": "TALL"
  }
}

DialPhone

DialPhone 제안은 지정한 번호로 전화를 걸기 시작합니다.

{ "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } }

ShowLocation

ShowLocation 제안은 지정한 좌표에서 맵을 엽니다.

{
  "ShowLocation": {
    "Text": "View on map",
    "PostbackData": "show_store_loc",
    "Latitude": 47.6062,
    "Longitude": -122.3321,
    "Label": "Seattle store"
  }
}

RequestLocation

RequestLocation 제안은 수신자에게 현재 위치를 공유하라는 메시지를 표시합니다. 공유 좌표는 별도의 인바운드 위치 이벤트로 도착합니다.

{ "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } }

CreateCalendarEvent

CreateCalendarEvent 제안은 지정한 세부 정보를 사용하여 수신자의 디바이스에 일정 이벤트를 생성합니다.

{
  "CreateCalendarEvent": {
    "Text": "Add to calendar",
    "PostbackData": "calendar_appt_5678",
    "Title": "Service appointment",
    "StartTime": "2026-05-28T14:00:00Z",
    "EndTime": "2026-05-28T15:00:00Z",
    "Description": "Downtown location. Arrive 10 minutes early."
  }
}

제안 탭 수신

수신자가 제안을 선택하면 AWSEnd User Messaging은 양방향 SNS 주제에 인바운드 메시지를 게시합니다. 에는 제안 유형, 표시 텍스트 및 설정한가 있는 JSON 객체가 messageBody 포함되어 postbackData 있습니다. 에서 로직을 라우팅합니다postbackData.

{
  "originationNumber": "+12065551234",
  "destinationNumber": "rcs-a1b2c3d4",
  "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}",
  "inboundMessageId": "msg-abc123def456"
}

RequestLocation 탭의 경우 수신자의 좌표는 별도의 인바운드 위치 이벤트에 도착합니다. 전체 인바운드 이벤트 참조는 섹션을 참조하세요RCS 메시지 이벤트.

제안 제한

모범 사례

자세한 지침은 섹션을 참조하세요RCS 모범 사례.

관련 주제