Test message



**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:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging.

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

# Kirim permintaan ke Amazon Pinpoint API
<a name="tutorials-using-postman-sample-requests"></a>

Setelah selesai mengonfigurasi dan menguji Postman, Anda dapat mulai mengirim permintaan tambahan ke Amazon Pinpoint API. Bagian ini mencakup informasi yang harus Anda ketahui sebelum mulai mengirim permintaan. Ini juga mencakup dua permintaan sampel yang menjelaskan cara menggunakan koleksi Amazon Pinpoint.

**penting**  
Saat Anda menyelesaikan prosedur di bagian ini, Anda mengirimkan permintaan ke Amazon Pinpoint API. Permintaan ini membuat sumber daya baru di akun Amazon Pinpoint Anda, mengubah sumber daya yang ada, mengirim pesan, mengubah konfigurasi proyek Amazon Pinpoint Anda, dan menggunakan fitur Amazon Pinpoint lainnya. Berhati-hatilah saat Anda melaksanakan permintaan ini.

## Contoh dalam koleksi Amazon Pinpoint Postman
<a name="tutorials-using-postman-sample-requests-about"></a>

Anda harus mengonfigurasi sebagian besar operasi dalam koleksi Amazon Pinpoint Postman sebelum Anda dapat menggunakannya. Untuk `GET` dan `DELETE` operasi, Anda biasanya hanya perlu memodifikasi variabel yang diatur pada tab **Pra-permintaan Script**.

**catatan**  
Bila Anda menggunakan kebijakan IAM yang ditampilkan di [Buat kebijakan IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), Anda tidak dapat menjalankan `DELETE` permintaan apa pun yang disertakan dalam koleksi ini.

Misalnya, `GetCampaign` operasi mengharuskan Anda untuk menentukan a `projectId` dan a`campaignId`. Pada tab **Pra-permintaan Script**, kedua variabel ini hadir, dan diisi dengan nilai contoh. Hapus nilai contoh dan ganti dengan nilai yang berlaku untuk proyek dan kampanye Amazon Pinpoint Anda.

Dari variabel-variabel ini, yang paling umum digunakan adalah `projectId` variabel. Nilai untuk variabel ini harus menjadi pengidentifikasi unik untuk proyek yang permintaan Anda terapkan. Untuk mendapatkan daftar pengidentifikasi ini untuk proyek Anda, lihat respons terhadap `GetApps` permintaan yang Anda kirim pada langkah sebelumnya dari tutorial ini. Dalam tanggapan itu, `Id` bidang menyediakan pengenal unik untuk sebuah proyek. Untuk mempelajari lebih lanjut tentang `GetApps` operasi dan arti dari setiap bidang dalam respons, lihat [Aplikasi di Referensi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) *API Amazon Pinpoint*.

**catatan**  
Di Amazon Pinpoint, “proyek” sama dengan “aplikasi” atau “aplikasi”.

Untuk `POST` dan `PUT` operasi, Anda juga harus memodifikasi badan permintaan untuk menyertakan nilai yang ingin Anda kirim ke API. Misalnya, ketika Anda mengirimkan `CreateApp` permintaan, yang merupakan `POST` permintaan, Anda harus menentukan nama untuk proyek yang Anda buat. Anda dapat memodifikasi permintaan pada tab **Tubuh**. Dalam contoh ini, ganti nilai di sebelahnya `"Name"` dengan nama proyek. Jika Anda ingin menambahkan tag ke proyek, Anda dapat menentukannya di `tags` objek. Atau, jika Anda tidak ingin menambahkan tag, Anda dapat menghapus seluruh `tags` objek.

**catatan**  
`UntagResource`Operasi ini juga mengharuskan Anda untuk menentukan parameter URL. Anda dapat menentukan parameter ini pada tab **Params**. Ganti **nilai di kolom VALUE** dengan tag yang ingin Anda hapus untuk sumber daya yang ditentukan.

## Contoh permintaan: Buat proyek dengan menggunakan `CreateApp` operasi
<a name="tutorials-using-postman-sample-requests-createapp"></a>

Sebelum Anda membuat segmen dan kampanye di Amazon Pinpoint, Anda harus terlebih dahulu membuat proyek. Di Amazon Pinpoint, sebuah *proyek* terdiri dari segmen, kampanye, konfigurasi, dan data yang disatukan oleh tujuan bersama. Misalnya, Anda dapat menggunakan proyek untuk memuat semua konten yang terkait dengan aplikasi tertentu, atau dengan merek atau inisiatif pemasaran tertentu. Saat Anda menambahkan informasi pelanggan ke Amazon Pinpoint, informasi tersebut terkait dengan proyek.

**Untuk membuat proyek dengan mengirimkan permintaan CreateApp API**

1. Pada menu **Lingkungan**, pilih tempat Wilayah AWS Anda ingin membuat proyek.  
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png)

    Dalam contoh ini, Postman telah dikonfigurasi sehingga menu **Lingkungan** menunjukkan empat opsi berikut:
   + AS Timur (Virginia Utara)
   + AS Barat (Oregon)
   + Eropa (Frankfurt)
   + Eropa (Irlandia)

1. Di folder **Aplikasi**, pilih **CreateApp**operasi>.  
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png)

   Folder **Apps** dalam koleksi Amazon Pinpoint Postman diperluas dan menampilkan permintaan berikut:
   + `GetApp`
   + `GetApps`
   + `CreateApp`
   + `DeleteApp`

1. Pada tab **Body**, di samping`"Name"`, ganti nilai placeholder (`"string"`) dengan nama untuk kampanye, seperti. **"MySampleProject"**

1. Hapus koma setelah nama kampanye, lalu hapus seluruh `tags` objek pada baris 3 hingga 5. Ketika Anda selesai, permintaan Anda harus menyerupai contoh yang ditampilkan dalam cuplikan kode berikut.

   ```
   {
       "Name": "MySampleProject"
   }
   ```

   Postman dikonfigurasi untuk mengirim permintaan sebagai payload JSON mentah.

1. Pilih **Kirim**. Jika kampanye berhasil dibuat, panel respons akan menampilkan status. `201 Created`

   ```
   {
       "Name": "MySampleProject"
       "Id": "12345678901234567890123456789012",
       "Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012",
       "tags": {}
   }
   ```

## Contoh: Kirim email dengan menggunakan `SendMessages` operasi
<a name="tutorials-using-postman-sample-requests-sendmessages"></a>

Sangat umum untuk menggunakan Amazon Pinpoint `SendMessages` API untuk mengirim pesan transaksional. Salah satu keuntungan mengirim pesan dengan menggunakan `SendMessages` API sebagai lawan membuat kampanye, adalah Anda dapat mengirim pesan ke alamat apa pun, seperti alamat email, nomor telepon, atau token perangkat. Alamat yang Anda kirimi pesan tidak harus ada di akun Amazon Pinpoint Anda. Mari kita bandingkan metode ini dengan mengirim pesan dengan membuat kampanye. Sebelum mengirim kampanye di Amazon Pinpoint, Anda harus menambahkan titik akhir ke akun Amazon Pinpoint, membuat segmen, membuat kampanye, dan menjalankan kampanye.

Contoh di bagian ini menunjukkan cara mengirim pesan email transaksional langsung ke alamat email tertentu. Anda dapat mengubah permintaan ini untuk mengirim pesan melalui saluran lain, seperti SMS, push seluler, atau suara.

**Untuk mengirim pesan email dengan mengirimkan permintaan SendMessages**

1. Verifikasi bahwa saluran email diaktifkan untuk proyek dan alamat email atau domain yang ingin Anda gunakan untuk mengirim dan menerima pesan dikonfigurasi. *Untuk informasi selengkapnya, lihat [Mengaktifkan dan menonaktifkan saluran email](pinpoint/latest/userguide/channels-email-setup.html) dan [Memverifikasi identitas email di Panduan Pengguna](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) Amazon Pinpoint.*
**catatan**  
Untuk menyelesaikan prosedur di bagian ini, Anda harus memverifikasi dan alamat email

1. Pada menu **Lingkungan**, pilih Wilayah AWS yang ingin Anda kirimi pesan.

   Dalam contoh ini, Postman telah dikonfigurasi sehingga menu **Lingkungan** menunjukkan empat opsi berikut:
   + AS Timur (Virginia Utara)
   + AS Barat (Oregon)
   + Eropa (Frankfurt)
   + Eropa (Irlandia)

1. Di folder **Pesan**, pilih **SendMessages**operasi.  
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png)

1. Pada tab **Pra-permintaan Script**, ganti nilai `projectId` variabel dengan ID proyek yang sudah ada di Wilayah yang Anda pilih di langkah 2 bagian ini.

1. Pada tab **Body**, hapus permintaan contoh yang ditampilkan di editor permintaan. Tempel kode berikut:

   ```
   {
       "MessageConfiguration":{
           "EmailMessage":{
               "FromAddress":"sender@example.com",
               "SimpleEmail":{
                   "Subject":{
                       "Data":"Sample Amazon Pinpoint message"
                   },
                   "HtmlPart":{
                       "Data":"<h1>Test message</h1><p>This is a sample message sent from <a href=\"https://aws.amazon.com/pinpoint\">Amazon Pinpoint</a> using the SendMessages API.</p>"
                   },
                   "TextPart":{
                       "Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API."
                   }
               }
           }
       },
       "Addresses":{
           "recipient@example.com": {
               "ChannelType": "EMAIL"
           }
       }
   }
   ```

1. Pada kode sebelumnya, ganti *sender@example.com* dengan alamat email terverifikasi Anda. Ganti *recipient@example.com* dengan alamat email terverifikasi yang ingin Anda kirimi pesan.
**catatan**  
Jika akun Anda masih dalam kotak pasir email Amazon Pinpoint, Anda hanya dapat mengirim email ke alamat atau domain yang diverifikasi di akun Amazon Pinpoint Anda. Untuk informasi selengkapnya tentang menghapus akun Anda dari kotak pasir, lihat [Meminta akses produksi untuk email di Panduan](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) Pengguna *Amazon Pinpoint*.

1. Pilih **Kirim**. Jika pesan berhasil dikirim, panel respons menampilkan status. `200 OK`

   ```
   {
       "ApplicationId": "12345678901234567890123456789012",
       "RequestId": "<sampleValue>",
       "Result": {
           "recipient@example.com": {
               "DeliveryStatus": "SUCCESSFUL",
               "StatusCode": 200,
               "StatusMessage": "<sampleValue>",
               "MessageId": "<sampleValue>"
           }
       }
   }
   ```