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

Memulai dengan Notify

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

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 (sepertiDescribeNotifyTemplates,,, ListNotifyCountriesSetNotifyMessageSpendLimitOverride, DeleteNotifyMessageSpendLimitOverride dan) memerlukan. PutMessageFeedback "Resource": "*"

Langkah 1: Buat konfigurasi Notify

Console

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

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

3. Pilih Buat konfigurasi Pemberitahuan.

4. Untuk Nama tampilan, masukkan nama merek Anda (misalnya,AcmeCorp).

5. Untuk kasus Penggunaan, verifikasi kode dipilih secara otomatis.

6. Untuk Saluran, pilih SMS, VOICE, atau keduanya.

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

8. 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:

Langkah 2: Jelajahi templat yang tersedia

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

Console

1. Dalam daftar Beritahu konfigurasi, pilih konfigurasi Anda.

2. Pilih tab Uji.

3. Pilih template dari tabel template.

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

5. Isi variabel template (misalnya, masukkan 123456 untuk variabel kode).

6. 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

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