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

RCS 파일 메시지 전송

SendRcsMessage API의 FileMessage 콘텐츠 유형을 사용하여 이미지, 비디오, 오디오 파일 및 PDFs 수신자에게 독립 실행형 메시지로 보낼 수 있습니다. 파일 메시지는 수신자의 메시징 앱에 인라인 미디어로 표시됩니다.

파일 메시지는 리치 카드 미디어와 다릅니다. 파일 메시지는 단일 미디어를 전체 메시지 콘텐츠로 전달하는 반면, 리치 카드는 미디어를 텍스트 및 제안된 작업과 결합합니다. 리치 카드에 대한 자세한 내용은 섹션을 참조하세요RCS 리치 카드 전송.

메시지 수준 제안(예: 회신 칩 또는 작업 버튼)을 파일 메시지에 연결할 수 있습니다. 제안에 대한 자세한 내용은 섹션을 참조하세요RCS 제안 구성.

FileMessage 구조

FileMessage 객체는 RcsMessageContent 파라미터의 Content 필드 내에 중첩됩니다. 메시지 수준은의 형제Suggestions입니다Content(그 안에 중첩되지 않음).

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

파일 URL 소스

FileUrl 파라미터는 다음 두 가지 URL 형식을 허용합니다.

파일 전송을 위한 S3 버킷 정책

AWS End User Messaging이 Amazon S3 버킷에서 파일을 검색하도록 허용하려면 다음 리소스 기반 정책을 버킷에 연결합니다.

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

YOUR-BUCKET을 버킷의 이름으로 바꿉니다. 특정 접두사에 대한 액세스를 제한하려면를 원하는 경로(예: arn:aws:s3:::YOUR-BUCKET/rcs-media/*)/*로 바꿉니다.

지원되는 미디어 유형 및 크기 제한

다음 표에는에서 지원하는 미디어 유형이 나열되어 있습니다FileMessage.

썸네일

ThumbnailUrl 파라미터를 사용하여 비디오 및 PDF 파일 메시지에 대한 썸네일 이미지를 제공할 수 있습니다. 수신자가 전체 파일을 열거나 다운로드하기 전에 썸네일이 대화에서 미리 보기로 표시됩니다.

파일 메시지 전송

파일 메시지를 보내려면 RcsMessageContent 파라미터 내에 FileMessage 객체가 있는 SendRcsMessage API를 호출합니다. --origination-identity 파라미터를 사용하여 발신 자격 증명(풀 또는 AWS RCS 에이전트)을 지정합니다.

다음 JSON은 파일 메시지의 RcsMessageContent 값을 제안과 함께 보여줍니다.

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

전송 및 대체

파일 메시지를 보내면 AWS End User Messaging은 RCS 채널을 통해 전송을 시도합니다. 수신자의 디바이스가 RCS를 지원하지 않거나 메시지가 전송 전에 만료되는 경우(TimeToLive값 기준) 폴백 구성에 따라 서비스가 SMS 또는 MMS로 폴백될 수 있습니다.

풀 수준에서 또는 메시지별로 SMS 또는 MMS 폴백을 구성할 수 있습니다. 폴백 동작에 대한 자세한 내용은 섹션을 참조하세요리치 RCS 메시지 전송.