Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Amazon Pinpoint menyertakan layanan validasi nomor telepon yang dapat Anda gunakan untuk menentukan apakah nomor telepon valid, dan untuk mendapatkan informasi tambahan tentang nomor telepon itu sendiri. Misalnya, ketika Anda menggunakan layanan validasi nomor telepon, ia mengembalikan informasi berikut:
-
Nomor telepon dalam format E.164.
-
Jenis nomor telepon (seperti ponsel, telepon rumah, atau VoIP).
-
Kota dan negara tempat nomor telepon berada.
-
Penyedia layanan yang terkait dengan nomor telepon.
Ada biaya tambahan untuk menggunakan layanan validasi nomor telepon. Untuk informasi selengkapnya, lihat harga Amazon Pinpoint
penting
Untuk originasi nomor telepon di Amerika Serikat dan Kanada, API validasi nomor telepon tidak akan lagi mengembalikan data untukCity,, dan. County Timezone ZipCode
Amazon Pinpoint kasus penggunaan validasi nomor telepon
Anda dapat menggunakan layanan validasi nomor telepon untuk mengaktifkan beberapa kasus penggunaan, termasuk yang berikut:
-
Memverifikasi nomor telepon yang disediakan pada formulir web — Jika Anda menggunakan formulir berbasis web untuk mengumpulkan informasi kontak bagi pelanggan Anda, Anda memvalidasi nomor telepon yang diberikan pelanggan sebelum mengirimkan formulir. Gunakan backend situs web Anda untuk memvalidasi nomor dengan menggunakan Amazon Pinpoint API. Respons API menyatakan apakah nomor tersebut tidak valid—misalnya, jika nomor telepon salah diformat. Jika Anda menentukan bahwa nomor telepon yang diberikan pelanggan tidak valid, formulir web Anda dapat meminta pelanggan untuk memberikan nomor yang berbeda.
-
Membersihkan basis data kontak yang ada — Jika Anda memiliki database nomor telepon pelanggan, Anda dapat memvalidasi setiap nomor telepon, dan kemudian memperbarui database Anda berdasarkan temuan Anda. Misalnya, jika Anda menemukan titik akhir dengan nomor telepon yang tidak mampu menerima pesan SMS, Anda dapat mengubah
ChannelTypeproperti untuk titik akhir dariSMSke.VOICEAnda dapat memvalidasi nomor telepon terlebih dahulu dan kemudian memperbaruiChannelTypeproperti untuk titik akhir baru atau yang sudah ada dengan mengikuti petunjuk Tambahkan titik akhir ke Amazon Pinpoint untuk satu titik akhir atau Tambahkan sekumpulan titik akhir ke Amazon Pinpoint beberapa titik akhir. -
Memilih saluran yang tepat sebelum mengirim pesan — Jika Anda berniat mengirim pesan SMS tetapi Anda menentukan bahwa nomor tujuan tidak valid, Anda dapat mengirim pesan ke penerima melalui saluran yang berbeda. Misalnya, jika titik akhir tidak dapat menerima pesan SMS, Anda dapat mengirim pesan suara sebagai gantinya.
Validasi nomor telepon menggunakan AWS CLI
Contoh berikut menunjukkan cara memvalidasi nomor telepon menggunakan. AWS CLI Untuk informasi selengkapnya, lihat phone-number-validate dalam AWS CLI Referensi Perintah. Misalnya tanggapan validasi, lihatRespon validasi nomor telepon. Untuk informasi selengkapnya tentang mengonfigurasi AWS CLI, lihat Mengkonfigurasi AWS CLI di Panduan AWS Command Line Interface Pengguna.
Untuk menggunakan layanan validasi nomor telepon dengan menggunakan AWS CLI
-
Di baris perintah, masukkan perintah berikut:
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GBPada perintah sebelumnya, ganti
+442079460881dengan nomor telepon yang ingin Anda validasi danGBdengan dua digit kode negara atau wilayah ISO.catatan
Saat Anda memberikan nomor telepon ke layanan validasi nomor telepon, Anda harus selalu menyertakan kode negara. Jika Anda tidak menyertakan kode negara, layanan mungkin mengembalikan informasi untuk nomor telepon di negara lain. Anda dapat memiliki tanda hubung di nomor telepon, misalnya
+44-207-946-0881.
Respon validasi nomor telepon
Informasi yang disediakan oleh layanan validasi nomor telepon sedikit berbeda berdasarkan data yang tersedia untuk nomor telepon yang Anda berikan. Bagian ini berisi contoh tanggapan yang dikembalikan oleh layanan validasi nomor telepon.
catatan
Data yang disediakan oleh layanan validasi nomor telepon didasarkan pada informasi yang diberikan oleh penyedia telekomunikasi dan entitas lain di seluruh dunia. Penyedia di beberapa negara mungkin memperbarui informasi ini lebih jarang daripada penyedia di negara lain. Misalnya, jika Anda mengeluarkan permintaan untuk memvalidasi nomor ponsel, dan nomor yang Anda berikan telah di-porting dari satu operator seluler ke operator seluler lainnya, respons dari layanan validasi nomor telepon mungkin menyertakan nama operator asli, sebagai lawan dari yang sekarang.
Nomor ponsel yang valid
Ketika Anda mengirim permintaan ke layanan validasi nomor telepon, dan nomor telepon adalah nomor ponsel yang valid, ia mengembalikan informasi yang menyerupai contoh berikut:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp Mobile",
"City": "Seattle",
"CleansedPhoneNumberE164": "+12065550142",
"CleansedPhoneNumberNational": "2065550142",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+12065550142",
"PhoneType": "MOBILE",
"PhoneTypeCode": 0,
"Timezone": "America/Los_Angeles",
"ZipCode": "98101"
}
}Nomor telepon rumah yang valid
Jika permintaan Anda berisi nomor telepon darat yang valid, layanan validasi nomor telepon mengembalikan informasi yang menyerupai contoh berikut:
{
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"Country": "United States",
"City": "Santa Clara",
"ZipCode": "95037",
"Timezone": "America/Los_Angeles",
"CleansedPhoneNumberNational": "4085550101",
"CleansedPhoneNumberE164": "14085550101",
"Carrier": "AnyCompany",
"PhoneTypeCode": 1,
"PhoneType": "LANDLINE",
"OriginalPhoneNumber": "+14085550101"
}Nomor telepon VoIP yang valid
Jika permintaan Anda berisi nomor telepon Voice over Internet Protocol (VoIP) yang valid, layanan validasi nomor telepon akan menampilkan informasi yang menyerupai contoh berikut:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}Nomor telepon tidak valid
Jika permintaan Anda berisi nomor telepon yang tidak valid, layanan validasi nomor telepon akan menampilkan informasi yang menyerupai contoh berikut:
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}Perhatikan bahwa PhoneType properti dalam respons ini menunjukkan bahwa nomor telepon iniINVALID, dan tidak menyertakan informasi tentang operator atau lokasi yang terkait dengan nomor telepon. Anda harus menghindari mengirim SMS atau pesan suara ke nomor telepon di mana PhoneType beradaINVALID, karena angka-angka ini tidak mungkin milik penerima yang sebenarnya.
Nomor telepon lainnya
Kadang-kadang, respons dari layanan validasi nomor telepon mencakup PhoneType nilai. OTHER Layanan mungkin mengembalikan respons semacam ini dalam situasi berikut:
-
Nomor telepon adalah nomor bebas pulsa (freephone).
-
Nomor telepon dicadangkan untuk digunakan dalam acara TV dan film, seperti nomor telepon Amerika Utara yang dimulai dengan 555.
-
Nomor telepon termasuk kode area yang saat ini tidak digunakan, seperti kode area 999 di Amerika Utara.
-
Nomor telepon dicadangkan untuk beberapa tujuan lain.
Contoh berikut menunjukkan respons yang diberikan oleh layanan validasi nomor telepon ketika permintaan Anda menyertakan nomor telepon fiktif Amerika Utara:
{
"NumberValidateResponse": {
"Carrier": "Multiple OCN Listing",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "OTHER",
"PhoneTypeCode": 4,
"Timezone": "America/Los_Angeles"
}
}Nomor telepon prabayar
Jika permintaan Anda berisi nomor telepon prabayar yang valid, layanan validasi nomor telepon mengembalikan informasi yang menyerupai contoh berikut:
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}Untuk informasi selengkapnya tentang informasi yang terkandung dalam tanggapan ini, lihat Nomor telepon memvalidasi di Referensi API Amazon Pinpoint.
