MultiTEL

Integrasi CNAM

CNAM melalui SIP

Otorisasi sumber SIP Anda, kirim transaksi pencarian, dan baca identitas penelepon yang dikembalikan.

Opsi dan harga CNAMReferensi REST

Pilih perilaku pencarian

TingkatanHarga publik per kueriFungsinya
StarterUS$0,0026Menggunakan informasi nama penelepon milik sendiri dan yang di-cache.
StandardUS$0,0037Melakukan pencarian jaringan secara real-time untuk setiap kueri.
MixedUS$0,004Mencoba pencarian real-time terlebih dahulu, lalu beralih ke data Starter jika tidak ada nama yang ditemukan.

Layanan yang dipilih menentukan perilaku pencarian; Mixed bukan pencarian yang mengutamakan cache. Tinjau tarif yang ditetapkan untuk akun Anda sebelum digunakan di produksi. Nama penelepon bukan bukti identitas atau kepemilikan.

Otorisasi sumber Anda

  1. Tambahkan IP sumber publik yang digunakan oleh SBC atau aplikasi Anda di pengaturan IP CNAM dan kaitkan dengan layanan yang dimaksud.
  2. Kirim SIP INVITE ke cnam.multitel.net, dengan menggunakan nomor telepon lengkap sebagai pengguna request-URI. Transport yang dipublikasikan adalah UDP pada port tujuan 5060.
  3. Gunakan stack SIP Anda untuk membuat Via, From, To, Contact, Call-ID, CSeq, dan header transaksi lain yang diperlukan. Jangan hanya mengirim baris permintaan di bawah ini.
  4. Selesaikan transaksi SIP dengan benar dan gunakan nama yang dikembalikan hanya jika terdapat hasil yang dapat digunakan.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0

Layanan pencarian ini tidak menerima registrasi SIP. Otorisasi didasarkan pada alamat sumber yang dikonfigurasi, yang mungkin berupa alamat publik gateway NAT Anda.

Baca hasil pencarian SIP

Layanan mengembalikan hasil dalam respons SIP 380 dengan header P-Asserted-Identity. Ini adalah transaksi hasil pencarian, bukan panggilan telepon yang dijawab. Frasa alasan dapat memuat nama yang dikembalikan; parsing header identity, jangan mengandalkan satu frasa tetap.

SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0

Kutipan ini tidak menyertakan header transaksi. 192.0.2.10 mewakili sistem peminta dalam contoh. Balasan sebenarnya harus dicocokkan dengan Call-ID dan CSeq dari stack SIP Anda.

380 dengan nama yang dapat digunakan
Baca nama tampilan dari P-Asserted-Identity, konfirmasikan respons akhir INVITE melalui stack SIP Anda, lalu lanjutkan alur panggilan Anda.
Tidak ada nama yang dapat digunakan
Jangan menggantikannya dengan pesan kesalahan, nilai kosong, atau nomor yang dikueri sebagai nama penelepon yang terverifikasi. Biarkan panggilan tetap berjalan dengan perilaku nama-tidak-diketahui yang biasa Anda gunakan.
403 atau penolakan lainnya
Periksa metode permintaan, domain tujuan, otorisasi IP sumber, serta status akun/layanan. Jangan mengulang kesalahan otorisasi dalam putaran cepat.
Waktu habis
Bedakan retransmisi transaksi SIP dari pencarian baru. Batasi percobaan baru karena dapat menimbulkan biaya kueri tambahan.

Penagihan, percobaan ulang, dan perbedaannya dengan memperbarui ID penelepon

Pencarian baru dapat menimbulkan biaya kueri. Antarmuka pencarian ini tidak mendokumentasikan kunci idempotensi, sehingga percobaan ulang yang baru dapat menjadi kueri berbayar kedua. Gunakan backoff terbatas untuk kegagalan transport/layanan, selesaikan kesalahan akun terlebih dahulu, dan rekonsiliasi biaya kueri yang dilaporkan. Lakukan cache hanya selama periode yang sesuai untuk aplikasi Anda; data nama penelepon dapat berubah.

Pencarian CNAM membaca sebuah nama. Pencarian ini tidak mengubah nama yang ditampilkan pada panggilan keluar Anda. Pembaruan nama penelepon LIDB adalah operasi terpisah dengan kolom, otorisasi, harga, dan pemrosesannya sendiri.

Panduan integrasi CNAM akunDapatkan bantuan integrasi