View a markdown version of this page

Gunakan layanan pencarian operator - AWS SMS Pesan Pengguna Akhir
Kasus penggunaan pencarian operatorFormat nomor telepon yang didukungMenggunakan layanan pencarian operator di AWS CLI

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

Gunakan layanan pencarian operator

AWS End User Messaging SMS mencakup layanan pencarian operator yang dapat Anda gunakan untuk memperoleh informasi tentang nomor telepon, termasuk jika nomor telepon tersebut valid. Layanan pencarian operator mengembalikan informasi berikut untuk nomor telepon:

  • Nomor telepon dalam format E164 (disanitasi dari input asli).

  • Jenis nomor telepon (seperti tidak valid, telepon rumah, ponsel, lainnya).

  • Nama negara atau wilayah untuk nomor telepon.

  • Kode panggilan numerik negara atau wilayah untuk nomor telepon.

  • Kode negara atau wilayah dua karakter, dalam format ISO 3166-1 alpha-2, untuk nomor telepon.

  • Untuk nomor ponsel, kode negara seluler (MCC).

  • Untuk nomor ponsel, kode jaringan seluler (MNC).

  • Operator atau penyedia layanan tempat nomor telepon saat ini terdaftar. Di beberapa negara dan wilayah, nilai ini mungkin operator atau penyedia layanan tempat nomor telepon awalnya terdaftar.

Ada biaya tambahan untuk menggunakan layanan pencarian operator. Untuk informasi selengkapnya, lihat Harga SMS Pesan Pengguna AWS Akhir.

Kasus penggunaan pencarian operator

Anda dapat menggunakan layanan pencarian operator untuk mengaktifkan beberapa kasus penggunaan, termasuk yang berikut:

  • Cari nomor telepon yang disediakan pada formulir web — Jika Anda menggunakan formulir berbasis web untuk mengumpulkan informasi kontak bagi pelanggan Anda, Anda dapat mencari nomor telepon yang diberikan pelanggan sebelum mengirimkan formulir. Gunakan backend situs web Anda untuk mencari dan memvalidasi nomor dengan menggunakan AWS End User Messaging SMS API. Respons API menyatakan apakah nomor tersebut valid—misalnya, jika nomor telepon diformat dengan benar. Jika Anda menentukan bahwa nomor telepon yang diberikan pelanggan tidak valid, formulir web Anda dapat meminta pelanggan untuk memberikan nomor yang valid.

  • Membersihkan basis data kontak yang ada — Jika Anda memiliki database nomor telepon pelanggan, Anda dapat mencari setiap nomor telepon, dan memperbarui database Anda menggunakan hasil pencarian operator. Misalnya, jika Anda menemukan titik akhir dengan nomor telepon yang tidak mampu menerima pesan SMS, Anda dapat mengubah ChannelType properti untuk titik akhir dari SMS ke. VOICE

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

Format nomor telepon yang didukung

Nomor telepon harus dalam format E164, dimulai dengan tanda plus (+) diikuti dengan kode panggilan negara dan nomor telepon (misalnya, +12065551234). Layanan pencarian operator menerima berbagai karakter pemformatan dan secara otomatis menghapusnya selama pemrosesan. Anda dapat menyertakan karakter pemformatan berikut dalam input nomor telepon Anda:

  • Tanda kurung: +1 (555) 123-4567

  • Kurung: +1 [555] 123-4567

  • Ruang: +1 555 123 4567

  • Tanda hubung: +1-555-123-4567

  • Periode: +1.555.123.4567

  • Koma: +1,555,123,4567

  • Pemformatan campuran: +1 (555)-123.4567

Semua karakter pemformatan secara otomatis dihapus selama pemrosesan, dan layanan mengembalikan nomor telepon dalam format E164 standar (misalnya,+15551234567) di E164PhoneNumber bidang respons.

Menggunakan layanan pencarian operator di AWS CLI

Contoh berikut menunjukkan cara menggunakan layanan pencarian operator di. AWS CLI Layanan ini menerima nomor telepon dengan berbagai karakter pemformatan (tanda kurung, tanda kurung, spasi, tanda hubung, titik, koma) dan secara otomatis mengubahnya menjadi format E164 untuk diproses. Untuk informasi selengkapnya, lihat CarrierLookupreferensi API SMS Pesan Pengguna AWS Akhir atau pencarian operator di Referensi Perintah. AWS CLI

Untuk menggunakan layanan pencarian operator (CLI)

  • Di baris perintah, masukkan perintah berikut. Anda dapat menggunakan berbagai format nomor telepon - layanan menerima karakter khusus seperti tanda kurung, tanda kurung, spasi, tanda hubung, titik, dan koma:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    Atau dengan format E164:

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Tanggapan pencarian operator

Informasi yang disediakan oleh layanan pencarian operator sedikit berbeda berdasarkan data yang tersedia untuk nomor telepon yang Anda berikan. Bagian ini berisi contoh tanggapan yang dikembalikan oleh layanan pencarian operator.

catatan

Data yang disediakan oleh layanan pencarian operator 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 lainnya, tanggapan dari layanan pencarian operator mungkin menyertakan nama operator asli, sebagai lawan dari yang sekarang.

Nomor ponsel yang valid

Tanggapan berikut adalah contoh CarrierLookup pengembalian informasi untuk nomor ponsel yang valid:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Nomor telepon rumah yang valid

Tanggapan berikut adalah contoh CarrierLookup pengembalian informasi untuk nomor telepon rumah yang valid:

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Nomor telepon tidak valid

Jika permintaan Anda berisi nomor telepon yang tidak valid, layanan pencarian operator mengembalikan informasi yang menyerupai contoh berikut:

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Perhatikan bahwa PhoneNumberType 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 PhoneNumberType beradaINVALID, karena angka-angka ini tidak mungkin milik penerima yang sebenarnya.

Nomor telepon lainnya

Nomor telepon yang tidak diklasifikasikan sebagai ponsel, telepon rumah, atau tidak valid dikembalikan dengan PhoneNumberType nilai. OTHER