Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat registrasi menggunakan SMS AWS CLI di AWS End User Messaging
Bagian berikut memberikan contoh cara membuat, mengisi, dan mengirimkan pendaftaran menggunakan. AWS CLI Untuk contoh cara membuat dan mengirimkan pendaftaran nomor telepon bebas pulsa menggunakan skrip python atau shell, lihat [Mengotomatiskan AWS End User Messaging US](https://aws.amazon.com/blogs/messaging-and-targeting/automate-us-tfn-registrations/) Pendaftaran Nomor bebas pulsa. Pendaftaran bervariasi dari satu negara ke negara lain, beberapa formulir halaman tunggal sementara yang lain, seperti 10DLC, mungkin memerlukan beberapa formulir untuk dikirimkan dalam urutan tertentu. Periksa [pendaftaran individu](registrations.md) untuk detail pesanan dan jika Anda perlu mengunggah dokumentasi pendukung seperti Surat Otorisasi (LOA).
## Latar Belakang
Beberapa negara mengharuskan Anda untuk mendaftarkan identitas perusahaan Anda untuk dapat membeli identitas originasi dan meninjau pesan yang Anda kirim ke penerima di negara mereka.
+ Informasi pendaftaran yang Anda berikan dapat ditinjau oleh pihak ketiga. Pihak ketiga bervariasi dari satu negara ke negara lain tetapi bisa menjadi badan pengatur pemerintah atau operator seluler yang melakukan peninjauan.
+ Jumlah waktu yang dibutuhkan perusahaan pihak ketiga untuk meninjau pendaftaran Anda bervariasi menurut jenis pendaftaran.
## Prasyarat
Sebelum Anda mulai, Anda harus:
+ Instal dan konfigurasikan AWS CLI, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) di [AWS Command Line Interface Panduan Pengguna](https://docs.aws.amazon.com/cli/latest/userguide/).
+ Sebuah Akun AWS dengan [izin](security-iam.md) untuk menggunakan SMS Pesan Pengguna AWS Akhir di wilayah target.
+ Pendaftaran **AssociationBehavior**menentukan urutan kapan pendaftaran dapat dikaitkan dengan identitas originasi dan terlepas dari identitas originasi, lihat. [SupportedAssociation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SupportedAssociation.html)
+ `ASSOCIATE_BEFORE_SUBMIT`Identitas originasi harus diberikan saat mengirimkan pendaftaran.
+ `ASSOCIATE_ON_APPROVAL`Ini berlaku untuk semua pendaftaran ID pengirim. ID pengirim akan secara otomatis disediakan setelah pendaftaran disetujui.
+ `ASSOCIATE_AFTER_COMPLETE`Ini berlaku untuk pendaftaran nomor telepon ketika Anda harus menyelesaikan pendaftaran terlebih dahulu, kemudian mengaitkan satu atau beberapa nomor telepon nanti.
**penting**
Setelah Anda membeli identitas originasi, Anda diubah untuk itu terlepas dari status pendaftarannya, lihat Harga [Pesan Pengguna AWS Akhir](https://aws.amazon.com/end-user-messaging/pricing/).
Setelah Anda mengirimkan pendaftaran Anda, Anda tidak dapat membuat perubahan apa pun pada pendaftaran atau memisahkan sumber daya apa pun dengan pendaftaran sampai setelah ditinjau oleh pihak ketiga dan dikembalikan kepada Anda.
Berikut ini adalah sumber daya tambahan untuk pendaftaran.
+ [Cara Membangun Proses Keikutsertaan SMS yang Sesuai](https://aws.amazon.com/blogs/messaging-and-targeting/how-to-build-a-compliant-sms-opt-in-process-with-amazon-pinpoint/)
+ [Praktik Terbaik Pendaftaran 10DLC untuk Mengirim SMS dengan Pesan Pengguna Akhir AWS](https://aws.amazon.com/blogs/messaging-and-targeting/10dlc-registration-best-practices-to-send-sms-with-amazon-pinpoint/)
# Buat registrasi (perintah AWS CLI buat-registrasi)
Gunakan perintah [create-registration](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration.html) untuk membuat registrasi kosong baru. **RegistrationType**Parameter menentukan jenis pendaftaran yang akan dibuat. Jika Anda tidak tahu nilai untuk jenis pendaftaran yang ingin Anda buat, gunakan [describe-registration-type-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-type-definitions.html)perintah untuk mengambil daftar semua jenis pendaftaran.
Contoh berikut menunjukkan cara membuat formulir pendaftaran nomor bebas pulsa.
```
$ aws pinpoint-sms-voice-v2 create-registration --registration-type US_TOLL_FREE_REGISTRATION --tags "Key=Name,Value=MyTFNRegistration"
```
Pada penyelesaian berhasil menyimpan nilai **RegistrationId**karena akan diperlukan untuk perintah lain.
**catatan**
Untuk menambahkan nama ramah ke pendaftaran Anda, Anda harus menambahkan tag dengan **Kunci** disetel ke **Name** dan **Nilai** disetel ke nama ramah yang akan digunakan.
Anda juga dapat menambahkan tag ke sumber daya untuk tujuan penagihan, lihat [Sumber daya tag untuk penagihan](sms-billing-tag.md).
Contoh berikut adalah output sebagian dari `describe-registration-type-definitions` perintah. Karena **AssociationBehavior**diatur ke `ASSOCIATE_BEFORE_SUBMIT` nomor bebas pulsa harus dibeli dan terkait dengan pendaftaran sebelum pendaftaran dapat diajukan untuk persetujuan. Untuk informasi lebih lanjut tentang **AssociationBehavior**dan **DisassociationBehavior**, lihat [SupportedAssociation](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SupportedAssociation.html).
```
{
"RegistrationTypeDefinitions": [
{
"RegistrationType": "US_TOLL_FREE_REGISTRATION",
"SupportedAssociations": [
{
"ResourceType": "TOLL_FREE",
"IsoCountryCode": "US",
"AssociationBehavior": "ASSOCIATE_BEFORE_SUBMIT",
"DisassociationBehavior": "DISASSOCIATE_ALL_CLOSES_REGISTRATION"
}
],
"DisplayHints": {
"Title": "US toll-free number registration"
}
},
...
```
# Dapatkan definisi bidang (describe-registration-field-definitions AWS CLI perintah)
Selanjutnya Anda perlu mendapatkan definisi untuk setiap bidang untuk mengetahui apa persyaratannya, seperti jumlah karakter maksimum untuk bidang tersebut.
Setiap pendaftaran dibagi menjadi beberapa bagian dan setiap bagian memiliki satu atau lebih bidang. Gunakan [describe-registration-field-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-field-definitions.html)perintah untuk mengambil semua definisi bagian dan bidang untuk pendaftaran. Anda akan membutuhkan **FieldPath**untuk setiap bidang nanti untuk dapat menetapkan nilainya. Juga **FieldRequirement**digunakan untuk menentukan apakah bidang akan diperlukan atau opsional.
Contoh berikut menunjukkan cara mengambil definisi bidang untuk formulir pendaftaran bebas pulsa.
```
$ aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION
```
Berikut ini adalah sebagian output dari perintah:
```
{
"RegistrationFieldDefinitions": [
{
"SectionPath": "companyInfo",
"FieldPath": "companyInfo.companyName",
"FieldType": "TEXT",
"FieldRequirement": "REQUIRED",
"TextValidation": {
"MinLength": 1,
"MaxLength": 100,
"Pattern": "^(?=\\s*\\S)[\\s\\S]+$"
},
"DisplayHints": {
"Title": "Company name",
"ShortDescription": "Legal name which your company is registered under.",
"ExampleTextValue": "Example Corp"
}
},
...
```
# Buat lampiran (create-registration-attachment AWS CLI perintah)
Bergantung pada pendaftaran, Anda mungkin diminta untuk melengkapi dan melampirkan Surat Otorisasi (LOA), alur kerja opt-in, atau jenis dokumen lain yang diperlukan. Periksa [pendaftaran individu](registrations.md) untuk detail dan untuk mengunduh formulir apa pun.
Gunakan [create-registration-attachment](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-attachment.html)perintah untuk membuat lampiran pendaftaran. Anda dapat mengunggah file ke bucket Amazon S3 dan menggunakan url atau melampirkan dokumen sebagai bagian dari perintah. Gunakan salah satu **AttachmentUrl**atau **AttachmentBody**, jika keduanya ditentukan maka pengecualian dikembalikan. Ukuran file maksimum adalah 500KB dan ekstensi file yang valid adalah PDF, JPEG, dan PNG.
Contoh berikut menunjukkan cara membuat lampiran pendaftaran dan menggunakan **AttachmentUrl**parameter.
```
$ aws pinpoint-sms-voice-v2 create-registration-attachment --attachment-url s3://BucketName/FileName
```
Setelah berhasil menyelesaikan perintah mengembalikan **RegistrationAttachmentID** yang diperlukan untuk perintah lain.
Untuk informasi selengkapnya tentang perintah Amazon S3 seperti membuat bucket atau mengunggah file, lihat [Menggunakan perintah tingkat tinggi (s3) dengan AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html) CLI.
# Mengatur nilai definisi bidang (put-registration-field-value AWS CLI perintah)
Selanjutnya Anda perlu menambahkan nilai untuk semua bidang wajib yang dikembalikan dari langkah *Dapatkan definisi bidang*, ini termasuk lampiran apa pun yang Anda buat. Kami menyarankan Anda juga melengkapi bidang opsional apa pun yang berlaku untuk kasus penggunaan Anda. Bidang diperlukan atau opsional tergantung pada **FieldRequirement**nilainya. Gunakan [put-registration-field-value](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/put-registration-field-value.html)perintah untuk mengatur nilai bidang.
+ Contoh berikut menunjukkan untuk menambahkan nilai untuk nama perusahaan atau nilai teks.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path companyInfo.companyName --text-value AnyCompany
```
Pada perintah sebelumnya ganti yang berikut ini:
+ Ganti *RegID* dengan id pendaftaran yang dikembalikan dari langkah *Buat pendaftaran*.
+ Ganti *AnyCompany* dengan nama perusahaan Anda.
+ Contoh berikut menunjukkan untuk menambahkan nilai untuk bidang pilih.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path messagingUseCase.monthlyMessageVolume --text-choices SelectValue
```
Pada perintah sebelumnya ganti yang berikut ini:
+ Ganti *RegID* dengan id pendaftaran yang dikembalikan dari langkah *Buat pendaftaran*.
+ Ganti *SelectValue* dengan salah satu nilai opsi untuk bidang tersebut.
Gunakan [describe-registration-field-definitions](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registration-field-definitions.html)perintah untuk mendapatkan opsi hanya untuk satu bidang:
```
aws pinpoint-sms-voice-v2 describe-registration-field-definitions --registration-type US_TOLL_FREE_REGISTRATION --field-paths messagingUseCase.monthlyMessageVolume
```
```
{
"RegistrationFieldDefinitions": [
{
"SectionPath": "messagingUseCase",
"FieldPath": "messagingUseCase.monthlyMessageVolume",
"FieldType": "SELECT",
"FieldRequirement": "REQUIRED",
"SelectValidation": {
"MinChoices": 1,
"MaxChoices": 1,
"Options": [
"10",
"100",
"1,000",
"10,000",
"100,000",
"250,000",
"500,000",
"750,000",
"1,000,000",
"5,000,000",
"10,000,000+"
]
},
"DisplayHints": {
"Title": "Monthly SMS volume",
"ShortDescription": "Estimated number of SMS messages which will be sent from this toll-free number each month."
}
}
],
"RegistrationType": "US_TOLL_FREE_REGISTRATION"
}
```
+ Contoh berikut menunjukkan cara menambahkan lampiran.
```
$ aws pinpoint-sms-voice-v2 put-registration-field-value --registration-id RegID --field-path messagingUseCase.optInImage --registration-attachment-id RegistrationAttachmentID
```
Pada perintah sebelumnya ganti yang berikut ini:
+ Ganti *RegID* dengan id pendaftaran yang dikembalikan dari langkah *Buat pendaftaran*.
+ Ganti *RegistrationAttachmentID* dengan id lampiran pendaftaran yang dikembalikan dari langkah *Buat lampiran.*
# Meminta identitas originasi (request-phone-number AWS CLI perintah)
**catatan**
Setelah Anda membeli identitas originasi, Anda dikenakan biaya untuk itu terlepas dari status pendaftaran, lihat [Harga Pesan Pengguna AWS Akhir](https://aws.amazon.com/end-user-messaging/pricing/).
Jika pendaftaran **AssociationBehavior**adalah `ASSOCIATE_AFTER_COMPLETE` maka Anda tidak perlu membeli atau mengaitkan identitas originasi sampai setelah pendaftaran telah diserahkan dan disetujui.
Sekarang Anda perlu meminta identitas originasi yang nantinya akan dikaitkan dengan pendaftaran. Contoh ini menunjukkan cara menggunakan [request-phone-number](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-phone-number.html)perintah untuk meminta nomor telepon bebas pulsa melalui file. AWS CLI Gunakan [request-sender-id](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/request-sender-id.html)untuk meminta ID pengirim.
```
$ aws pinpoint-sms-voice-v2 request-phone-number --iso-country-code US --message-type TRANSACTIONAL --number-capabilities SMS --number-type TOLL_FREE
```
Setelah berhasil menyelesaikan perintah mengembalikan nomor telepon pengidentifikasi unik yang diperlukan untuk mengaitkan nomor telepon dengan pendaftaran.
# Kaitkan sumber daya dengan registrasi (create-registration-association AWS CLI perintah)
**catatan**
Jika pendaftaran **AssociationBehavior**adalah `ASSOCIATE_AFTER_COMPLETE` maka Anda tidak perlu membeli atau mengaitkan identitas originasi sampai setelah pendaftaran telah diserahkan dan disetujui.
Untuk mengaitkan identitas originasi ke pendaftaran, gunakan [create-registration-association](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-association.html) AWS CLI perintah.
```
$ aws pinpoint-sms-voice-v2 create-registration-association --registration-id RegID --resource-id PhoneNumberID
```
Pada perintah sebelumnya ganti yang berikut ini:
+ Ganti *RegID* dengan id pendaftaran yang dikembalikan dari langkah *Buat pendaftaran*.
+ Ganti *PhoneNumberID* dengan id nomor telepon yang dikembalikan dari langkah *Minta identitas originasi*.
**catatan**
Perintah ini digunakan untuk mengaitkan sumber daya yang berlaku dengan pendaftaran. Misalnya, dapat digunakan untuk mengaitkan pendaftaran kampanye 10DLC dengan pendaftaran merek 10DLC.
# Kirimkan pendaftaran Anda (submit-registration-version AWS CLI perintah)
Setelah Anda mengirimkan pendaftaran Anda, Anda tidak akan dapat membuat perubahan apa pun padanya. Tinjau pendaftaran Anda untuk memastikan bahwa semua data Anda benar sebelum mengirimkannya.
**penting**
Setelah Anda mengirimkan pendaftaran Anda, Anda tidak dapat membuat perubahan apa pun pada pendaftaran atau memisahkan sumber daya apa pun dari pendaftaran sampai setelah ditinjau oleh pihak ketiga dan dikembalikan kepada Anda.
Untuk mengirimkan pendaftaran dengan AWS CLI menggunakan [submit-registration-version](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/create-registration-association.html)perintah.
```
$ aws pinpoint-sms-voice-v2 submit-registration-version --registration-id RegID
```
Pada perintah sebelumnya ganti yang berikut ini:
+ Ganti *RegID* dengan id pendaftaran yang dikembalikan dari langkah *Buat pendaftaran*.
## Periksa status pendaftaran Anda (deskripsikan perintah AWS CLI registrasi)
[Setelah pendaftaran Anda dikirimkan, Anda dapat memeriksa statusnya menggunakan [perintah deskripsi-registrasi](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/describe-registrations.html) atau konsol.](registrations-status.md)
Jika pendaftaran **AssociationBehavior**adalah `ASSOCIATE_AFTER_COMPLETE` Anda dapat membeli identitas originasi dan mengaitkannya dengan pendaftaran, setelah status pendaftaran diatur ke **LENGKAP**.
Jika status pendaftaran Anda diubah menjadi **REQUIRES\$1UPDATES** maka Anda dapat menemukan dan [mengedit bidang yang ditandai](registrations-edit.md) dan mengirim ulang pendaftaran. Untuk daftar alasan penolakan pendaftaran, lihat[Umpan Balik Gen-AI tentang Pendaftaran](registrations-genai-feedback.md). Jika Anda memerlukan bantuan Dukungan dengan penolakan pendaftaran Anda, Anda dapat [membuka tiket](registrations-request-support.md).