AWS End User Messaging SMS를 사용하여 MMS 메시지를 전송하는 예 - AWS End User Messaging SMS
사전 조건AWS CLI를 사용하여 MMS 전송S3 버킷 설정

AWS End User Messaging SMS를 사용하여 MMS 메시지를 전송하는 예

공유 리소스를 사용하는 경우 해당 리소스의 전체 Amazon 리소스 이름(ARN)을 사용해야 합니다. AWS CLI 또는 AWS End User Messaging SMS 및 음성 v2 API를 사용하여 고객에게 MMS 메시지를 전송할 수 있습니다.

send-media-message AWS CLI 명령을 사용하여 MMS 메시지를 전송합니다. AWS CLI 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 AWS CLI 구성 섹션을 참조하세요.

중요

MMS 기능은 일부 국가에서만 사용할 수 있습니다. SMS 및 MMS가 지원되는 국가에 대한 자세한 내용은 AWS End User Messaging SMS를 사용한 SMS 메시징이 지원되는 국가 및 지역 및 AWS End User Messaging SMS에서 MMS 메시징이 지원되는 국가 및 리전 섹션을 참조하세요.

발신 자격 증명이 MMS를 지원하는지 확인하려면 AWS End User Messaging SMS에서 전화번호 상태 및 기능 보기 섹션을 참조하세요.

공유 리소스를 사용하려면 전체 Amazon 리소스 이름(ARN)을 사용해야 합니다.

사전 조건

시작하기 전에 다음 사전 요구 사항이 충족되어야 합니다.

  • MMS 메시지 전송을 지원하는 발신 자격 증명이 있어야 합니다.

  • MMS를 지원하는 발신 자격 증명과 동일한 AWS 리전에 있는 Amazon S3 버킷에 미디어 파일을 업로드해야 합니다. MMS 파일용 Amazon S3 버킷 설정 섹션을 참조하세요.

    지원되는 파일 형식과 크기 목록은 섹션을 참조하세요.

  • 각 MMS 파일의 S3 URI입니다.

  • send-media-message를 호출하는 데 사용되는 자격 증명은 미디어 파일이 포함된 Amazon S3 버킷에 대한 읽기 액세스 권한이 있어야 합니다. 자세한 내용은 Amazon S3 사용 설명서의 Amazon S3의 ID 기반 정책 예시를 참조하세요.

AWS CLI를 사용하여 MMS 전송

send-media-message에 필요한 유일한 파라미터는 destination-phone-number 및 origination-identity입니다. media-urls 파라미터를 생략하여 텍스트만 포함된 메시지를 보낼 수 있습니다. message-body 파라미터를 생략하면 미디어 파일만 포함된 메시지도 보낼 수도 있습니다.

MMS 메시지를 전송하려면

  • 명령줄에 다음 명령을 입력합니다.

    aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'

    위의 명령에서 다음과 같이 변경하세요.

    • us-east-1을 발신 자격 증명이 저장된 AWS 리전으로 바꿉니다.

    • +12065550150을 대상 전화번호로 바꿉니다.

    • +14255550120을 발신 자격 증명으로 바꿉니다. 발신 자격 증명은 ACTIVE여야 하며 대상 전화번호로 전송할 수 있어야 합니다.

    • 텍스트 본문을 텍스트 메시지로 바꿉니다.

    • s3://s3-bucket/media_file.jpg를 MMS 파일의 S3 URI로 바꿉니다. 지원되는 미디어 파일 형식은 MMS 파일 형식, 크기 및 문자 제한에 나열되어 있습니다. S3 버킷 생성 및 객체 관리에 대한 자세한 내용은 Amazon S3 사용 설명서의 MMS 파일용 Amazon S3 버킷 설정 또는 버킷 생성 및 객체 업로드를 참조하세요.

AWS End User Messaging SMS가 명령을 수락하면 MessageID가 수신됩니다. 이는 명령이 성공적으로 수신되었으며 대상 기기가 아직 메시지를 수신하지 않았음을 의미합니다. 오류 코드 목록은 SendMediaMessage 오류를 참조하세요.

{
   "MessageId": "string"
}

MMS 파일용 Amazon S3 버킷 설정

MMS 파일은 Amazon S3 버킷에 저장해야 합니다. Amazon S3 버킷은 MMS 지원 발신 자격 증명과 동일한 AWS 계정 및 AWS 리전에 있어야 합니다. 이 지침은 Amazon S3 버킷을 생성하고 파일을 업로드한 다음 해당 파일의 URI를 구성하는 방법을 보여줍니다. Amazon S3 명령에 대한 자세한 내용은 AWS CLI에서 상위 수준(s3) 명령 사용을 참조하세요. AWS CLI 구성에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 AWS CLI 구성 섹션을 참조하세요.

Amazon S3 버킷을 생성하려면 create-bucket AWS CLI 명령을 사용합니다. 명령줄에 다음 명령을 입력합니다.

aws s3api create-bucket --region 'us-east-1' --bucket BucketName

앞의 명령에서:

  • us-east-1을 MMS 지원 발신 자격 증명이 있는 AWS 리전으로 바꿉니다.

  • BucketName을 새 버킷 이름으로 바꿉니다.

파일을 Amazon S3 버킷에 복사하려면 cp AWS CLI 명령을 사용합니다. 명령줄에 다음 명령을 입력합니다.

aws s3 cp SourceFilePathAndName s3://BucketName/FileName

앞의 명령에서:

  • SourceFilePathAndName을 복사할 파일의 파일 경로 및 이름으로 바꿉니다.

  • BucketName을 버킷 이름으로 바꿉니다.

  • FileName을 파일에 사용할 이름으로 바꿉니다.

전송할 때 사용할 URI는 다음과 같습니다.

s3://BucketName/FileName