**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.
# Hasilkan kata sandi satu kali (OTPs) dengan Amazon Pinpoint
Amazon Pinpoint menyertakan fitur manajemen kata sandi satu kali (OTP) yang dapat Anda gunakan untuk membuat kata sandi satu kali baru dan mengirimkannya ke penerima sebagai pesan SMS.
**penting**
Untuk menggunakan fitur ini, akun Anda harus memiliki akses produksi dan identitas originasi aktif. Untuk informasi selengkapnya, lihat [Tentang kotak pasir SMS/MMS dan Suara](https://docs.aws.amazon.com/sms-voice/latest/userguide/sandbox.html) dan [Minta nomor telepon](https://docs.aws.amazon.com/sms-voice/latest/userguide/phone-numbers-request.html) di *Panduan Pengguna SMS Pesan Pengguna AWS Akhir*.
Di beberapa negara dan Wilayah, Anda harus mendapatkan nomor telepon khusus atau ID originasi sebelum dapat mengirim pesan SMS. Misalnya, ketika Anda mengirim pesan ke penerima di Amerika Serikat, Anda harus memiliki nomor bebas pulsa khusus, nomor 10DLC, atau kode pendek. Ketika Anda mengirim pesan ke penerima di India, Anda harus memiliki ID pengirim terdaftar, yang mencakup ID Entitas Utama (PEID) dan ID Templat. Persyaratan ini masih berlaku saat Anda menggunakan fitur OTP.
Untuk menggunakan fitur ini, Anda memerlukan izin untuk mengirim dan memverifikasi pesan OTP, lihat. [Kata sandi satu kali](permissions-actions.md#permissions-actions-apiactions-otp) Jika Anda memerlukan bantuan untuk menentukan izin, lihat[Memecahkan masalah Amazon Pinpoint identitas dan manajemen akses](security_iam_troubleshoot.md).
Anda dapat menggunakan `SendOtpMessages` operasi di Amazon Pinpoint API untuk mengirim kode OTP ke pengguna aplikasi Anda. Saat Anda menggunakan API ini, Amazon Pinpoint menghasilkan kode acak dan mengirimkannya ke pengguna Anda sebagai pesan SMS. Permintaan Anda dapat mencakup parameter berikut:
+ `Channel`— Saluran komunikasi yang dikirim melalui kode OTP. Saat ini, hanya pesan SMS yang didukung, jadi satu-satunya nilai yang dapat diterima adalah SMS.
+ `BrandName`— Nama merek, perusahaan, atau produk yang terkait dengan kode OTP. Nama ini dapat berisi hingga 20 karakter.
**catatan**
Saat Amazon Pinpoint mengirim pesan OTP, nama merek secara otomatis dimasukkan ke dalam templat pesan berikut:
```
This is your One Time Password: {{otp}} from {{brand}}
```
Jadi, jika Anda menentukan ExampleCorp sebagai nama merek Anda, dan Amazon Pinpoint menghasilkan kata sandi satu kali 123456, itu mengirimkan pesan berikut ke pengguna Anda:
```
This is your One Time Password: 123456 from ExampleCorp
```
+ `CodeLength`— Jumlah digit yang akan ada dalam kode OTP yang dikirim ke penerima. Kode OTP dapat berisi antara 5 dan 8 digit, inklusif.
+ `ValidityPeriod`— Jumlah waktu, dalam hitungan menit, bahwa kode OTP akan valid. Masa berlaku bisa antara 5 dan 60 menit, inklusif.
+ `AllowedAttempts`— Berapa kali penerima tidak berhasil mencoba memverifikasi OTP. Jika jumlah upaya melebihi nilai ini, OTP secara otomatis menjadi tidak valid. Jumlah maksimum upaya yang diizinkan adalah 5.
+ `Language`— Bahasa, dalam format IETF BCP-47, untuk digunakan saat mengirim pesan. Nilai yang dapat diterima adalah:
+ `de-DE`— Jerman
+ `en-GB`— Inggris (UK)
+ `en-US`— Inggris (AS)
+ `es-419`— Spanyol (Amerika Latin)
+ `es-ES`— Spanyol
+ `fr-CA`— Prancis (Kanada)
+ `fr-FR`— Prancis
+ `it-IT`— Italia
+ `ja-JP`— Jepang
+ `ko-KR`— Korea
+ `pt-BR`— Portugis (Brasil)
+ `zh-CN`- Mandarin (Sederhana)
+ `zh-TW`— Tionghoa (Tradisional)
+ `OriginationIdentity`— Identitas asal (seperti kode panjang, kode pendek, atau ID pengirim) yang digunakan untuk mengirim kode OTP. Jika Anda menggunakan kode panjang atau nomor bebas pulsa untuk mengirim OTP, nomor telepon harus dalam format E.164.
+ `DestinationIdentity`— Nomor telepon, dalam format E.164, tempat kode OTP dikirim.
+ `ReferenceId`— ID referensi unik untuk permintaan tersebut. ID referensi sama persis dengan ID referensi yang Anda berikan saat Anda memverifikasi OTP. ID referensi dapat berisi antara 1 dan 48 karakter, inklusif.
+ `EntityId`— ID Entitas yang terdaftar di badan pengatur. Parameter ini saat ini hanya digunakan saat mengirim pesan ke penerima di India. Jika Anda tidak mengirim ke penerima di India, Anda dapat menghilangkan parameter ini.
+ `TemplateId`— ID Template yang terdaftar di badan pengatur. Parameter ini saat ini hanya digunakan saat mengirim pesan ke penerima di India. Jika Anda tidak mengirim ke penerima di India, Anda dapat menghilangkan parameter ini.
**catatan**
Untuk informasi selengkapnya tentang persyaratan pengiriman pesan ke penerima di India, lihat [proses pendaftaran ID pengirim India di Panduan](https://docs.aws.amazon.com/sms-voice/latest/userguide/registrations-sms-senderid-india.html) Pengguna *Amazon Pinpoint*.
Untuk memastikan bahwa akun Amazon Pinpoint Anda dikonfigurasi dengan benar untuk mengirim pesan OTP, Anda dapat menggunakan AWS CLI untuk mengirim pesan pengujian. Untuk informasi selengkapnya tentang AWS CLI, lihat [Panduan AWS Command Line Interface Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
Untuk mengirim pesan OTP pengujian menggunakan AWS CLI, jalankan [send-otp-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint/send-otp-message.html)perintah di terminal:
```
aws pinpoint send-otp-message --application-id 7353f53e6885409fa32d07cedexample --send-otp-message-request-parameters Channel=SMS,BrandName=ExampleCorp,CodeLength=5,ValidityPeriod=20,AllowedAttempts=5,OriginationIdentity=+18555550142,DestinationIdentity=+12065550007,ReferenceId=SampleReferenceId
```
Pada perintah sebelumnya, lakukan hal berikut:
+ Ganti *7353f53e6885409fa32d07cedexample* dengan id aplikasi Anda.
+ Ganti *ExampleCorp* dengan nama perusahaan Anda.
+ Ganti *5* `CodeLegth` dengan jumlah digit yang akan ada dalam kode OTP yang dikirim ke penerima.
+ Ganti *20* `ValidityPeriod` dengan jumlah waktu, dalam menit, bahwa kode OTP akan valid.
+ Ganti *5* `AllowedAttempts` dengan berapa kali penerima tidak berhasil mencoba memverifikasi OTP.
+ Ganti *\$118555550142* `OriginationIdentity` dengan identitas asal yang digunakan untuk mengirim kode OTP.
+ Ganti *\$112065550007* `DestinationIdentity` dengan nomor telepon untuk mengirim kode OTP ke.
+ Ganti *SampleReferenceId* `ReferenceId` dengan ID referensi unik untuk permintaan tersebut.
## `SendOtpMessage`respon
Ketika Anda berhasil mengirim pesan OTP, Anda menerima respons yang menyerupai contoh berikut:
```
{
"MessageResponse": {
"ApplicationId": "7353f53e6885409fa32d07cedexample",
"RequestId": "255d15ea-75fe-4040-b919-096f2example",
"Result": {
"+12065550007": {
"DeliveryStatus": "SUCCESSFUL",
"MessageId": "nvrmgq9kq4en96qgp0tlqli3og1at6aexample",
"StatusCode": 200,
"StatusMessage": "MessageId: nvrmgq9kq4en96qgp0tlqli3og1at6aexample"
}
}
}
}
```