

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

# Memulai dengan Notify
<a name="notify-getting-started"></a>

Tutorial ini memandu Anda melalui pembuatan konfigurasi Notify dan mengirim pesan OTP pertama Anda. Anda dapat menyelesaikan tutorial ini dalam waktu sekitar 5 menit.

## Prasyarat
<a name="notify-getting-started-prereqs"></a>
+ Sebuah Akun AWS.
+ Izin IAM untuk operasi SMS Pesan Pengguna AWS Akhir. Untuk informasi selengkapnya, lihat [Identitas dan manajemen akses untuk AWS End User Messaging SMS](security-iam.md).

Kebijakan IAM berikut memberikan izin untuk mengirim pesan dan menelusuri templat:

```
{
    "Version": "2012-10-17", 		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:ListNotifyCountries",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}
```

Kebijakan berikut memberikan izin manajemen Pemberitahuan lengkap:

```
{
    "Version": "2012-10-17", 		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sms-voice:CreateNotifyConfiguration",
                "sms-voice:UpdateNotifyConfiguration",
                "sms-voice:DeleteNotifyConfiguration",
                "sms-voice:DescribeNotifyConfigurations",
                "sms-voice:DescribeNotifyTemplates",
                "sms-voice:ListNotifyCountries",
                "sms-voice:SendNotifyTextMessage",
                "sms-voice:SendNotifyVoiceMessage",
                "sms-voice:SetNotifyMessageSpendLimitOverride",
                "sms-voice:DeleteNotifyMessageSpendLimitOverride",
                "sms-voice:PutMessageFeedback"
            ],
            "Resource": "*"
        }
    ]
}
```

Untuk membatasi izin ke konfigurasi Notify tertentu, gunakan ARN konfigurasi untuk tindakan tingkat sumber daya (seperti,,,,, dan). `SendNotifyTextMessage` `SendNotifyVoiceMessage` `DescribeNotifyConfigurations` `CreateNotifyConfiguration` `UpdateNotifyConfiguration` `DeleteNotifyConfiguration` Tindakan yang tidak mendukung izin tingkat sumber daya (seperti`DescribeNotifyTemplates`,,, `ListNotifyCountries``SetNotifyMessageSpendLimitOverride`, `DeleteNotifyMessageSpendLimitOverride` dan) memerlukan. `PutMessageFeedback` `"Resource": "*"`

## Langkah 1: Buat konfigurasi Notify
<a name="notify-getting-started-create"></a>

------
#### [ Console ]

1. Buka konsol SMS AWS End User Messaging di [https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).

1. Di panel navigasi, di bawah **Beri tahu**, pilih **Beritahu** konfigurasi.

1. Pilih **Buat konfigurasi Pemberitahuan**.

1. Untuk **Nama tampilan**, masukkan nama merek Anda (misalnya,`AcmeCorp`).

1. Untuk **kasus Penggunaan**, **verifikasi kode** dipilih secara otomatis.

1. Untuk **Saluran**, pilih **SMS**, **VOICE**, atau keduanya.

1. (Opsional) Perluas **pengaturan lanjutan** untuk memilih negara, templat default, kumpulan terkait, atau aktifkan perlindungan penghapusan.

1. Pilih **Buat konfigurasi Pemberitahuan**.

Konfigurasi Anda dibuat dalam status **Tertunda** sementara sistem memvalidasi akun Anda. Setelah divalidasi, status berubah menjadi **Aktif** dan Anda dapat mulai mengirim pesan.

**catatan**  
Pembuatan konfigurasi mencakup validasi akun otomatis dan pemeriksaan nama merek. Sebagian besar konfigurasi diaktifkan dalam hitungan detik. Jika nama merek Anda memerlukan verifikasi, statusnya akan **Memerlukan verifikasi**.

------
#### [ AWS CLI ]

```
aws pinpoint-sms-voice-v2 create-notify-configuration \
    --display-name "AcmeCorp" \
    --use-case CODE_VERIFICATION \
    --enabled-channels SMS
```

------

Status konfigurasi:

PENDING  
Konfigurasi sedang divalidasi.

AKTIF  
Siap mengirim pesan.

REQUIRES\_VERIFICATION  
Nama merek memerlukan verifikasi sebelum aktivasi.

MENOLAK  
Konfigurasi ditolak. Periksa `RejectionReason` detailnya.

## Langkah 2: Jelajahi templat yang tersedia
<a name="notify-getting-started-templates"></a>

Sebelum mengirim, periksa templat mana yang tersedia untuk tingkat dan saluran Anda:

```
aws pinpoint-sms-voice-v2 describe-notify-templates \
    --filters '[{"Name":"channels","Values":["SMS"]},{"Name":"tier-access","Values":["BASIC"]}]'
```

## Langkah 3: Kirim pesan tes
<a name="notify-getting-started-send"></a>

------
#### [ Console ]

1. Dalam daftar Beritahu konfigurasi, pilih konfigurasi Anda.

1. Pilih tab **Uji**.

1. Pilih template dari tabel template.

1. Untuk **nomor telepon Tujuan**, masukkan nomor telepon dalam format E.164 (misalnya,`+12065550100`).

1. Isi variabel template (misalnya, masukkan `123456` untuk variabel **kode**).

1. Pilih **Kirim**.

------
#### [ AWS CLI ]

```
aws pinpoint-sms-voice-v2 send-notify-text-message \
    --notify-configuration-id "{{nc-1234567890abcdef0}}" \
    --destination-phone-number "{{+12065550100}}" \
    --template-id "{{notify-code-verification-english-001}}" \
    --template-variables '{"code":"123456"}'
```

------
#### [ Python (boto3) ]

```
import boto3

client = boto3.client('pinpoint-sms-voice-v2')

response = client.send_notify_text_message(
    NotifyConfigurationId='nc-1234567890abcdef0',
    DestinationPhoneNumber='+12065550100',
    TemplateId='notify-code-verification-english-001',
    TemplateVariables={
        'code': '123456'
    }
)

print(f"Message ID: {response['MessageId']}")
print(f"Resolved body: {response['ResolvedMessageBody']}")
```

------

## Langkah 4: Periksa negara yang tersedia
<a name="notify-getting-started-countries"></a>

Gunakan `ListNotifyCountries` untuk melihat negara mana yang tersedia untuk tingkat dan saluran Anda:

```
aws pinpoint-sms-voice-v2 list-notify-countries \
    --channels SMS \
    --tier BASIC
```

## Langkah selanjutnya
<a name="notify-getting-started-next"></a>
+ [Mengelola konfigurasi Notify](notify-configurations.md)— Pelajari tentang semua opsi konfigurasi.
+ [Bekerja dengan template Notify](notify-templates.md)— Jelajahi dan pahami templat yang tersedia.
+ [Beri tahu tingkatan](notify-tiers.md)— Pelajari tentang tingkatan dan cara meng-upgrade ke Advanced.
+ [Beri tahu batas pengeluaran](notify-spend-limits.md)— Kelola batas pengeluaran Notify Anda.