**지원 종료 알림:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon Pinpoint의 SMS 이벤트 데이터 스트림 프로젝트에 SMS 채널을 활성화한 경우, Amazon Pinpoint는 프로젝트의 SMS 메시지 전송에 대한 이벤트 데이터를 스트리밍할 수 있습니다. 이벤트 스트리밍을 설정한 후 Amazon Pinpoint는 설정 중에 지정한 대상에서 이벤트 데이터를 검색하여 볼 수 있도록 합니다. 이벤트 스트리밍 설정 방법에 대한 자세한 내용은 [Amazon Kinesis 또는 Amazon Data Firehose를 통해 앱 이벤트 데이터를 스트리밍하도록 Amazon Pinpoint 설정](event-streams-setup.md) 섹션을 참조하세요. **참고** 통신사에서 생성한 SMS 이벤트는 수신될 때까지 최대 72시간이 걸릴 수 있으며, 아웃바운드 메시지 배달의 지연 여부를 판단하는 데 사용해서는 안 됩니다. 72시간이 지난 후에도 Amazon Pinpoint가 통신사로부터 최종 이벤트를 수신하지 않은 경우, 해당 메시지가 어떻게 되었는지 알 수 없으므로 서비스는 자동으로 UNKNOWN record\_status를 반환합니다. ## SMS 이벤트 예 SMS 이벤트에 대한 JSON 객체에는 다음 예제의 데이터가 포함되어 있습니다. ``` { "event_type": "_SMS.SUCCESS", "event_timestamp": 1553104954322, "arrival_timestamp": 1553104954064, "event_version": "3.1", "application": { "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6", "sdk": {} }, "client": { "client_id": "123456789012" }, "device": { "platform": {} }, "session": {}, "attributes": { "sender_request_id": "565d4425-4b3a-11e9-b0a5-example", "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example", "origination_phone_number": "+12065550142", "destination_phone_number": "+14255550199", "record_status": "DELIVERED", "iso_country_code": "US", "treatment_id": "0", "number_of_message_parts": "1", "message_id": "1111-2222-3333", "message_type": "Transactional", "campaign_id": "52dc44b35c4742c98c5935269example" "customer_context": "{\"userId\":\"user-id-4\"}" }, "metrics": { "price_in_millicents_usd": 645.0 }, "awsAccountId": "123456789012" } ``` ## SMS 이벤트 속성 이 섹션에서는 SMS 메시지를 보낼 때 Amazon Pinpoint에서 생성하는 이벤트 스트림 데이터의 이전 예제에 포함된 속성을 정의합니다. **Event** | 속성 | 설명 | | --- | --- | | event\_type | 이벤트의 유형입니다. 가능한 값은 다음과 같습니다.+ **\_SMS.BUFFERED** – 메시지가 수신자에게 배달되는 중입니다.
+ **\_SMS.SUCCESS** – 메시지가 수신자에게 전달되었습니다.
+ **\_SMS.FAILURE** – Amazon Pinpoint가 메시지를 수신자에게 배달할 수 없었습니다. 메시지 배달을 방해하는 오류에 대한 자세한 내용은 `attributes.record_status` 단원을 참조하십시오.
+ **\_SMS.OPTOUT** – 고객이 메시지를 수신하고 옵트아웃 키워드(보통 "STOP")를 전송하여 응답했습니다. | | event\_timestamp | 이벤트가 보고된 시간입니다(밀리초 단위 Unix 시간). | | arrival\_timestamp | Amazon Pinpoint에서 이벤트가 수신된 시간입니다(밀리초 단위 Unix 시간). | | event\_version | 이벤트 JSON 스키마의 버전입니다. 스키마 업데이트에 대응하여 언제 애플리케이션을 업데이트해야 하는지 알 수 있도록 이벤트 처리 애플리케이션에서 이 버전을 확인합니다. | | application | 이벤트와 관련된 Amazon Pinpoint 프로젝트에 대한 정보입니다. 자세한 내용은 [애플리케이션](#event-streams-data-sms-attributes-application) 표를 참조하십시오. | | client | 이벤트를 보고한 디바이스에 설치된 앱 클라이언트에 대한 정보입니다. 자세한 내용은 [클라이언트](#event-streams-data-sms-attributes-client) 표를 참조하십시오. | | device | 이벤트를 보고한 디바이스에 대한 정보입니다. 자세한 내용은 [디바이스](#event-streams-data-sms-attributes-device) 표를 참조하십시오.
SMS 이벤트의 경우 이 객체가 비어 있습니다. | | session | SMS 이벤트의 경우 이 객체가 비어 있습니다. | | attributes | 이벤트와 연결된 속성입니다. 앱 중 하나에서 보고한 이벤트의 경우 이 객체에는 앱에서 정의한 사용자 지정 속성이 포함될 수 있습니다. 캠페인을 전송할 때 생성되는 이벤트의 경우 이 객체에는 캠페인과 연결된 속성이 포함됩니다. 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 객체에는 메시지 자체와 관련된 정보가 포함됩니다.
자세한 내용은 [속성](#event-streams-data-sms-attributes-attrs) 표를 참조하십시오. | | metrics | 이벤트와 연결된 추가 지표입니다. 자세한 내용은 [지표](#event-streams-data-sms-attributes-metrics) 표를 참조하십시오. | | awsAccountId | 메시지를 전송하는 데 사용된 AWS 계정의 ID입니다. | ### Application 이벤트와 연결된 Amazon Pinpoint 프로젝트와 이벤트 보고에 사용된 SDK(해당하는 경우)에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | app\_id | 이벤트를 보고한 Amazon Pinpoint 프로젝트의 고유 ID입니다. | | sdk | 이벤트를 보고하는 데 사용된 SDK입니다. Amazon Pinpoint API를 직접 호출하거나 Amazon Pinpoint 콘솔을 사용하여 트랜잭션 SMS 메시지를 전송하는 경우 이 객체는 비어 있습니다. | ### 속성 이벤트와 연결된 속성에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | sender\_request\_id | SMS 메시지 전송 요청과 연결된 고유 ID입니다. | | campaign\_activity\_id | 캠페인 내 활동의 고유 ID입니다. | | origination\_phone\_number | 메시지를 전송한 전화 번호입니다. | | destination\_phone\_number | 메시지 전송을 시도한 전화 번호입니다. | | record\_status | 메시지 상태에 대한 추가 정보입니다. 가능한 값은 다음과 같습니다.+ **SUCCESSFUL/DELIVERED** – 메시지가 성공적으로 배달되었습니다.
+ **PENDING** – 메시지가 아직 수신자의 디바이스로 배달되지 않았습니다.
+ **INVALID** – 대상 전화번호가 잘못되었습니다.
+ **UNREACHABLE** – 수신자의 디바이스가 현재 연결할 수 없거나 사용할 수 없습니다. 예를 들어, 디바이스의 전원이 꺼져 있거나 네트워크와의 연결이 끊어졌을 수 있습니다. 나중에 메시지 전송을 다시 시도할 수 있습니다.
+ **UNKNOWN** – 메시지 배달을 방해하는 오류가 발생했습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.
+ **BLOCKED** – 수신자의 디바이스가 발신 번호로부터의 SMS 메시지를 차단하고 있습니다.
+ **CARRIER\_UNREACHABLE** – 수신자의 모바일 네트워크 문제로 인해 메시지가 배달되지 않았습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.
+ **SPAM** – 수신자의 통신사에서 메시지의 콘텐츠를 스팸으로 식별하여 메시지 배달을 차단했습니다.
+ **INVALID\_MESSAGE** – SMS 메시지 본문이 잘못되어 배달할 수 없습니다.
+ **CARRIER\_BLOCKED **– 수신자의 이동 통신 업체에서 이 메시지 배달을 차단했습니다. 이는 이동 통신 업체에서 메시지 콘텐츠를 원치 않는 메시지 또는 악성 메시지로 식별할 때 종종 발생합니다.
+ **TTL\_EXPIRED** – 특정 시간 내에 SMS 메시지를 배달할 수 없었습니다. 이 오류는 일반적으로 일시적이며 나중에 메시지 전송을 다시 시도할 수 있습니다.
+ **MAX\_PRICE\_EXCEEDED** – 메시지를 전송할 경우 해당 계정의 월별 SMS 지출 할당량을 초과하는 요금이 발생합니다. *Amazon Pinpoint 사용 설명서*의 [월별 SMS 지출 할당량 증가 요청](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html)의 절차를 완료하여 이러한 할당량 증가를 요청할 수 있습니다.
+ **OPTED\_OUT** – 수신자가 나의 메시지 수신을 옵트아웃했기 때문에 SMS 메시지가 전송되지 않았습니다.
+ **NO\_QUOTA\_LEFT\_ON\_ACCOUNT** – 계정에 남은 지출 할당량이 부족하여 메시지를 전송할 수 없습니다. *AWS End User Messaging SMS 사용 설명서*의 [월별 SMS 지출 할당량 증가 요청](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html)의 절차를 완료하여 이러한 할당량 증가를 요청할 수 있습니다.
+ **NO\_ORIGINATION\_IDENTITY\_AVAILABLE\_TO\_SEND** – 계정에 대상으로 메시지를 전송하는 데 사용할 수 있는 전화번호가 포함되어 있지 않습니다.
+ **DESTINATION\_COUNTRY\_NOT\_SUPPORTED** – 대상 국가가 차단되었습니다. 지원되는 모든 국가에 대해서는 *AWS End User Messaging SMS 사용 설명서*의 [지원되는 국가 및 리전(SMS 채널)](https://docs.aws.amazon.com/sms-voice/latest/userguide/channels-sms-countries.html)을 참조하세요.
+ **ACCOUNT\_IN\_SANDBOX** – 계정이 샌드박스에 있으며 인증된 대상 번호로만 이를 전송할 수 있습니다. Amazon Pinpoint 콘솔에서 대상 번호를 확인하거나 프로세스를 시작하여 샌드박스에서 계정을 이동할 수 있습니다. *AWS End User Messaging SMS 사용 설명서*[의 SMS/MMS 및 음성 샌드박스 정보](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html#sandbox-sms-move-to-production)를 참조하세요.
+ **RATE\_EXCEEDED** – 메시지를 너무 빨리 전송하려고 시도하여 조절되었습니다. 호출 속도를 낮춰야 합니다. 제한에 대한 자세한 내용은 *AWS End User Messaging SMS 사용 설명서*의 [초당 메시지 부분(MPS) 제한](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html)을 참조하세요.
+ **INVALID\_ORIGINATION\_IDENTITY** – 제공된 발신 ID가 잘못되었습니다.
+ **ORIGINATION\_IDENTITY\_DOES\_NOT\_EXIST** – 제공된 발신 ID가 존재하지 않습니다.
+ **INVALID\_DLT\_PARAMETERS** – 잘못된 DLT 파라미터(인도 내의 대상에 필요)가 제공되었습니다.
+ **INVALID\_PARAMETERS** – 잘못된 파라미터가 제공되었습니다.
+ **ACCESS\_DENIED** – 계정의 메시지 전송이 차단되었습니다. 고객 지원팀에 문의하여 원인을 확인하고 문제를 해결하세요.
+ **INVALID\_KEYWORD** – 제공된 키워드가 잘못되었습니다. 키워드 형식이 잘못되었거나 계정에 설정되지 않은 것일 수 있습니다.
+ **INVALID\_SENDER\_ID** – 제공된 발신자 ID가 잘못되었습니다. 발신자 ID의 형식이나 길이가 잘못되었을 수 있습니다.
+ **INVALID\_POOL\_ID** – 제공된 풀 ID가 잘못되었습니다. 풀 ID 형식이 잘못되었거나 계정에 속하지 않은 것일 수 있습니다.
+ **SENDER\_ID\_NOT\_SUPPORTED\_FOR\_DESTINATION** – 대상 국가가 발신자 ID를 지원하지 않습니다. 전송하려면 전화번호 또는 다른 발신자 ID를 사용해야 합니다.
+ **INVALID\_PHONE\_NUMBER** – 제공된 발신자 전화번호가 잘못되었습니다. 전화번호의 형식이나 길이가 잘못되었을 수 있습니다. | | iso\_country\_code | 수신자의 전화 번호와 관련된 국가 이며, ISO 3166-1 alpha-2 형식으로 표시됩니다. | | treatment\_id | 메시지가 A/B 캠페인으로 전송된 경우 메시지 처리의 ID입니다. | | treatment\_id | A/B 테스트 캠페인을 사용하여 메시지를 전송한 경우 이 값은 메시지의 처리 번호를 나타냅니다. 트랜잭션 SMS 메시지의 경우 이 값은 0입니다. | | number\_of\_message\_parts | Amazon Pinpoint가 메시지를 전송하기 위해 생성한 메시지 부분 수입니다.
일반적으로 SMS 메시지는 160개의 GSM-7 문자 또는 67개의 비GSM 문자만 포함할 수 있지만 이러한 한도는 국가 에 따라 다를 수 있습니다. 이 한도를 초과하는 메시지를 전송하면 Amazon Pinpoint에서 자동으로 메시지를 더 작게 분할합니다. 전송하는 메시지 부분 수에 따라 요금이 청구됩니다. | | message\_id | 메시지를 수락할 때 Amazon Pinpoint에서 생성하는 고유 ID입니다. | | message\_type | 메시지 유형. 가능한 값은 **Promotional** 및 **Transactional**입니다. 캠페인을 생성할 경우 또는 Amazon Pinpoint API에서 [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) 작업을 사용하여 트랜잭션 메시지를 전송할 경우 이 값을 지정합니다. | | campaign\_id | 메시지를 전송한 Amazon Pinpoint 캠페인의 고유 ID입니다. | | customer\_context | Amazon Pinpoint [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) 작업에서 전송된 `Context` 맵의 콘텐츠 JSON 문자열입니다. | ### 클라이언트 이벤트를 보고한 디바이스에 설치된 앱 클라이언트에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | client\_id | 앱에서 생성된 이벤트의 경우 이 값은 디바이스에 설치된 앱 클라이언트의 고유 ID입니다. 이 ID는 AWS Mobile SDK for iOS 및 AWS Mobile SDK for Android에 의해 자동으로 생성됩니다.
캠페인 및 트랜잭션 메시지를 전송할 때 생성되는 이벤트의 경우 이 값은 메시지를 전송한 엔드포인트의 ID와 같습니다. | | cognito\_id | 앱이 사용하는 Amazon Cognito 자격 증명 풀에서 앱 클라이언트에 지정된 고유 ID입니다. | ### 디바이스 이벤트를 보고한 디바이스에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | locale | 디바이스 로캘입니다. | | make | 디바이스 제조사입니다(예: Apple 또는 Samsung). | | model | 디바이스 모델입니다(예: iPhone). | | platform | 디바이스 플랫폼입니다(예: ios 또는 android). | ### 지표 이벤트와 연결된 지표에 대한 정보를 포함합니다. | 속성 | 설명 | | --- | --- | | price\_in\_millicents\_usd | 메시지 전송에 대해 청구된 금액입니다. 이 가격은 미국 센트의 1/1000로 표시됩니다. 예를 들어 이 속성의 값이 `645`인 경우, 메시지 전송에 대해 0.645¢가 청구된 것입니다(645 / 1000 = 0.645¢ = $0.00645). 이 속성은 `event_type`이 **\_SMS.BUFFERED**인 메시지에는 표시되지 않습니다. |