**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** API yang terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh Pesan Pengguna AWS Akhir.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Aliran data acara SMS dari Amazon Pinpoint
<a name="event-streams-data-sms"></a>

Jika saluran SMS diaktifkan untuk suatu proyek, Amazon Pinpoint dapat mengalirkan data peristiwa tentang pengiriman pesan SMS untuk proyek tersebut. Setelah mengatur streaming acara, Amazon Pinpoint mengambil data peristiwa dari tujuan yang Anda tentukan selama penyiapan untuk dilihat. Untuk informasi tentang cara mengatur streaming acara, lihat[Siapkan Amazon Pinpoint untuk mengalirkan data peristiwa aplikasi melalui Amazon Kinesis atau Amazon Data Firehose](event-streams-setup.md). 

**catatan**  
Acara SMS yang dihasilkan oleh operator dapat memakan waktu hingga 72 jam untuk diterima dan tidak boleh digunakan untuk menentukan apakah ada keterlambatan pengiriman pesan keluar. Setelah 72 jam, jika Amazon Pinpoint belum menerima peristiwa terakhir dari operator, layanan secara otomatis mengembalikan record\_status TIDAK DIKETAHUI, karena Amazon Pinpoint tidak tahu apa yang terjadi pada pesan itu.

## Contoh acara SMS
<a name="event-streams-data-sms-example"></a>

Objek JSON untuk acara SMS berisi data yang ditunjukkan dalam contoh berikut.

```
{
  "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"
}
```

## Atribut acara SMS
<a name="event-streams-data-sms-attributes"></a>

Bagian ini mendefinisikan atribut yang disertakan dalam contoh data aliran peristiwa sebelumnya yang dihasilkan Amazon Pinpoint saat Anda mengirim pesan SMS.


**Peristiwa**  

| Atribut | Deskripsi | 
| --- | --- | 
| event\_type | Jenis peristiwa. Kemungkinan nilainya adalah:+  **\_SMS.BUFFERED** — Pesan masih dalam proses dikirim ke penerima. <br />+  **\_SMS.SUCCESS** — Pesan berhasil diterima oleh pengangkut/dikirim ke penerima.  <br />+  **\_SMS.FAILURE** - Amazon Pinpoint tidak dapat mengirimkan pesan ke penerima. Untuk mempelajari lebih lanjut tentang kesalahan yang mencegah pesan terkirim, lihat`attributes.record_status`. <br />+  **\_SMS.OPTOUT** — Pelanggan menerima pesan dan membalas dengan mengirimkan kata kunci opt-out (biasanya “STOP”).   | 
| event\_timestamp | Waktu ketika peristiwa dilaporkan, ditampilkan sebagai waktu Unix dalam milidetik. | 
| arrival\_timestamp | Waktu ketika acara diterima oleh Amazon Pinpoint, ditampilkan sebagai waktu Unix dalam milidetik. | 
| event\_version | Versi skema acara JSON. Periksa versi ini di aplikasi pemrosesan acara Anda sehingga Anda tahu kapan harus memperbarui aplikasi sebagai respons terhadap pembaruan skema.  | 
| application | Informasi tentang proyek Amazon Pinpoint yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Aplikasi](#event-streams-data-sms-attributes-application). | 
| client | Informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut. Untuk informasi selengkapnya, lihat tabel [Klien](#event-streams-data-sms-attributes-client). | 
| device | Informasi tentang perangkat yang melaporkan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Perangkat](#event-streams-data-sms-attributes-device).<br />Untuk acara SMS, objek ini kosong. | 
| session | Untuk acara SMS, objek ini kosong. | 
| attributes | Atribut yang terkait dengan acara tersebut. Untuk peristiwa yang dilaporkan oleh salah satu aplikasi Anda, objek ini dapat menyertakan atribut khusus yang ditentukan oleh aplikasi. Untuk peristiwa yang dibuat saat Anda mengirim kampanye, objek ini berisi atribut yang terkait dengan kampanye. Untuk peristiwa yang dihasilkan saat Anda mengirim pesan transaksional, objek ini berisi informasi yang terkait dengan pesan itu sendiri.<br />Untuk informasi selengkapnya, lihat tabel [Atribut](#event-streams-data-sms-attributes-attrs). | 
| metrics | Metrik tambahan yang terkait dengan acara tersebut. Untuk informasi selengkapnya, lihat tabel [Metrik](#event-streams-data-sms-attributes-metrics). | 
| awsAccountId | ID AWS akun yang digunakan untuk mengirim pesan. | 

### Aplikasi
<a name="event-streams-data-sms-attributes-application"></a>

Menyertakan informasi tentang proyek Amazon Pinpoint yang terkait dengan peristiwa tersebut dan, jika berlaku, SDK yang digunakan untuk melaporkan peristiwa tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| app\_id | ID unik dari proyek Amazon Pinpoint yang melaporkan acara tersebut. | 
| sdk | SDK yang digunakan untuk melaporkan peristiwa tersebut. Jika Anda mengirim pesan SMS transaksional dengan memanggil Amazon Pinpoint API secara langsung atau menggunakan konsol Amazon Pinpoint, objek ini kosong. | 

### Atribut
<a name="event-streams-data-sms-attributes-attrs"></a>

Termasuk informasi tentang atribut yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| sender\_request\_id | ID unik yang terkait dengan permintaan untuk mengirim pesan SMS. | 
| campaign\_activity\_id | ID unik dari aktivitas dalam kampanye. | 
| origination\_phone\_number | Nomor telepon tempat pesan itu dikirim. | 
| destination\_phone\_number | Nomor telepon yang Anda coba kirimi pesan. | 
| record\_status | Informasi tambahan tentang status pesan. Nilai yang mungkin termasuk:+  **SUKSES/DISAMPAIKAN — Pesan berhasil** disampaikan. <br />+  **PENDING** — Pesan belum dikirim ke perangkat penerima. <br />+  **TIDAK VALID** — Nomor telepon tujuan tidak valid. <br />+  **UNREACHABLE** — Perangkat penerima saat ini tidak dapat dijangkau atau tidak tersedia. Misalnya, perangkat mungkin dimatikan, atau mungkin terputus dari jaringan. Anda dapat mencoba mengirim pesan lagi nanti. <br />+  **UNKNOWN** — Terjadi kesalahan yang mencegah pengiriman pesan. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. <br />+  **BLOCKED** — Perangkat penerima memblokir pesan SMS dari nomor originasi. <br />+  **CARRIER\_UNREACHABLE** — Masalah dengan jaringan seluler penerima mencegah pesan dikirim. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. <br />+  **SPAM** — Operator seluler penerima mengidentifikasi konten pesan sebagai spam dan pengiriman pesan yang diblokir. <br />+  **INVALID\_MESSAGE - Isi pesan** SMS tidak valid dan tidak dapat dikirimkan. <br />+  **CARRIER\_BLOCKED** — Operator penerima telah memblokir pengiriman pesan ini. Ini sering terjadi ketika operator mengidentifikasi isi pesan sebagai tidak diminta atau berbahaya. <br />+  **TTL\_EXPIRED** — Pesan SMS tidak dapat dikirimkan dalam jangka waktu tertentu. Kesalahan ini biasanya bersifat sementara, dan Anda dapat mencoba mengirim pesan lagi nanti. <br />+  **MAX\_PRICE\_EXCEEDED** — Mengirim pesan akan mengakibatkan biaya yang melebihi kuota belanja SMS bulanan untuk akun Anda. Anda dapat meminta kenaikan kuota ini dengan menyelesaikan prosedur dalam [Meminta kenaikan kuota belanja SMS bulanan Anda](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html) di Panduan Pengguna *Amazon* Pinpoint. <br />+  **OPTED\_OUT** — Pesan SMS tidak dikirim karena penerima memilih untuk tidak menerima pesan dari Anda. <br />+ **NO\_QUOTA\_LEFT\_ON\_ACCOUNT — Tidak ada cukup kuota pengeluaran yang tersisa di akun** Anda untuk mengirim pesan. Anda dapat meminta kenaikan kuota ini dengan menyelesaikan prosedur dalam [Meminta kenaikan kuota belanja SMS bulanan Anda](https://docs.aws.amazon.com/sms-voice/latest/userguide/awssupport-spend-threshold.html) di Panduan Pengguna *SMS Pesan Pengguna AWS Akhir*.<br />+ **NO\_ORIGINATION\_IDENTITY\_AVAILABLE\_TO\_SEND — Akun Anda tidak berisi nomor telepon yang dapat digunakan untuk mengirim pesan ke** tujuan. <br />+ **DESTINATION\_COUNTRY\_NOT\_SUPPORTED — Negara tujuan diblokir**. Untuk semua negara yang didukung, lihat [Negara dan wilayah yang didukung (saluran SMS)](https://docs.aws.amazon.com/sms-voice/latest/userguide/channels-sms-countries.html) di *Panduan Pengguna SMS Pesan Pengguna AWS Akhir*.<br />+ **ACCOUNT\_IN\_SANDBOX** — Akun Anda berada di kotak pasir dan hanya dapat mengirim ke nomor tujuan yang diverifikasi. *Anda dapat memverifikasi nomor tujuan di konsol Amazon Pinpoint atau memulai proses untuk memindahkan akun dari kotak pasir, lihat [Tentang kotak pasir SMS/MMS dan Suara di Panduan Pengguna SMS Pesan Pengguna](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html#sandbox-sms-move-to-production) Akhir.AWS *<br />+  **RATE\_EXCEEDED** - Anda mencoba mengirim pesan terlalu cepat dan dibatasi. Anda perlu memperlambat tingkat panggilan Anda. Untuk detail tentang batasan kami, lihat batas [Message Parts per Second (MPS)](https://docs.aws.amazon.com/sms-voice/latest/userguide/sms-limitations-mps.html) di *Panduan Pengguna SMS Pesan Pengguna AWS Akhir*. <br />+ **INVALID\_ORIGINATION\_IDENTITY - Identitas originasi** yang disediakan tidak valid. <br />+ **ORIGINATION\_IDENTITY\_DOES\_NOT\_EXIST** — Identitas originasi yang disediakan tidak ada.<br />+ **INVALID\_DLT\_PARAMETERS — Parameter** DLT tidak valid (diperlukan untuk tujuan di India) disediakan.<br />+  **INVALID\_PARAMETERS — Parameter** tidak valid disediakan.  <br />+ **ACCESS\_DENIED** — Akun Anda diblokir dari mengirim pesan. Hubungi dukungan pelanggan untuk mengetahui penyebabnya dan menyelesaikan masalah.<br />+ **INVALID\_KEYWORD - Kata kunci** yang disediakan tidak valid. Kata kunci bisa dalam format yang salah atau tidak diatur di akun Anda. <br />+ **INVALID\_SENDER\_ID - ID Pengirim** yang disediakan tidak valid. ID Pengirim bisa dalam format atau panjang yang salah.<br />+ **INVALID\_POOL\_ID - ID** Pool yang disediakan tidak valid. ID Pool bisa dalam format yang salah atau bukan milik akun Anda. <br />+ **SENDER\_ID\_NOT\_SUPPORTED\_FOR\_DESTINATION — Negara tujuan tidak mendukung** ID Pengirim. Anda harus menggunakan nomor telepon atau identitas originasi lain untuk mengirim.<br />+  **INVALID\_PHONE\_NUMBER - Nomor** telepon originasi yang disediakan tidak valid. Nomor telepon bisa dalam format atau panjang yang salah.  | 
| iso\_country\_code | Negara yang terkait dengan nomor telepon penerima, ditampilkan dalam format ISO 3166-1 alpha-2. | 
| treatment\_id | ID dari perlakuan pesan, jika pesan dikirim dalam kampanye A/B. | 
| treatment\_id | Jika pesan dikirim menggunakan kampanye pengujian A/B, nilai ini mewakili nomor perlakuan pesan. Untuk pesan SMS transaksional, nilai ini adalah 0. | 
| number\_of\_message\_parts | Jumlah bagian pesan yang dibuat Amazon Pinpoint untuk mengirim pesan.<br /> Jika Anda mengirim pesan yang melebihi batas ini, Amazon Pinpoint secara otomatis membagi pesan menjadi bagian-bagian yang lebih kecil. Kami menagih Anda berdasarkan jumlah bagian pesan yang Anda kirim. | 
| message\_id | ID unik yang dihasilkan Amazon Pinpoint saat menerima pesan. | 
| message\_type | Jenis pesan. Nilai yang mungkin adalah **Promosi** dan **Transaksional**. Anda menentukan nilai ini saat membuat kampanye, atau saat Anda mengirim pesan transaksional menggunakan [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)operasi di Amazon Pinpoint API. | 
| campaign\_id | ID unik kampanye Amazon Pinpoint yang mengirim pesan. | 
| customer\_context | String JSON dari konten dari `Context` peta yang dikirim dalam operasi Amazon [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages)Pinpoint. | 

### Klien
<a name="event-streams-data-sms-attributes-client"></a>

Menyertakan informasi tentang klien aplikasi yang diinstal pada perangkat yang melaporkan peristiwa tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| client\_id | Untuk peristiwa yang dihasilkan oleh aplikasi, nilai ini adalah ID unik klien aplikasi yang diinstal pada perangkat. ID ini secara otomatis dihasilkan oleh AWS Mobile SDK for iOS dan AWS Mobile SDK for Android.<br />Untuk peristiwa yang dihasilkan saat Anda mengirim kampanye dan pesan transaksional, nilai ini sama dengan ID titik akhir yang Anda kirimi pesan tersebut. | 
| cognito\_id | ID unik yang ditetapkan ke klien aplikasi di kumpulan identitas Amazon Cognito yang digunakan oleh aplikasi Anda. | 

### Perangkat
<a name="event-streams-data-sms-attributes-device"></a>

Termasuk informasi tentang perangkat yang melaporkan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| locale | Perangkat lokal. | 
| make | Perangkat membuat, seperti Apple atauSamsung. | 
| model | Model perangkat, sepertiiPhone. | 
| platform | Platform perangkat, seperti ios atauandroid. | 

### Metrik
<a name="event-streams-data-sms-attributes-metrics"></a>

Menyertakan informasi tentang metrik yang terkait dengan acara tersebut.


| Atribut | Deskripsi | 
| --- | --- | 
| price\_in\_millicents\_usd | Jumlah yang kami bebankan kepada Anda untuk mengirim pesan. Harga ini ditunjukkan dalam seperseribu sen Amerika Serikat. Misalnya, jika nilai atribut ini adalah`645`, maka kami menagih Anda 0,645¢ untuk mengirim pesan (645/1000 = 0,645¢ = $0,00645). Properti ini tidak muncul untuk pesan dengan `event_type` **\_SMS.BUFFERED**.  |