تكامل CNAM
CNAM عبر SIP
امنح الإذن لمصدر SIP لديك، وأرسل معاملة بحث، واقرأ هوية المتصل المُعادة.
اختر سلوك البحث
| المستوى | السعر العام لكل استعلام | ما يفعله |
|---|---|---|
| Starter | 0.0026 US$ | يستخدم معلومات أسماء المتصلين الخاصة والمخزنة مؤقتاً. |
| Standard | 0.0037 US$ | يجري بحثاً فورياً في الشبكة لكل استعلام. |
| Mixed | 0.004 US$ | يحاول البحث الفوري أولاً، ثم يعود إلى بيانات Starter عند عدم العثور على اسم. |
تحدد الخدمة المختارة سلوك البحث؛ فـ Mixed ليس بحثاً يعتمد على الذاكرة المؤقتة أولاً. راجع السعر المخصص لحسابك قبل الاستخدام في الإنتاج. اسم المتصل ليس دليلاً على الهوية أو الملكية.
امنح الإذن للمصدر الذي تستخدمه
- أضف عنوان IP العام الذي يستخدمه SBC أو تطبيقك في إعدادات IP الخاصة بـ CNAM واربطه بالخدمة المقصودة.
- أرسل SIP INVITE إلى
cnam.multitel.net، مستخدماً رقم الهاتف الكامل كمستخدم في request-URI. وسيلة النقل المنشورة هي UDP على منفذ الوجهة 5060. - استخدم حزمة SIP لديك لإنشاء Via وFrom وTo وContact وCall-ID وCSeq وسائر ترويسات المعاملة المطلوبة. لا ترسل سطر الطلب الوارد أدناه وحده.
- أكمل معاملة SIP بشكل صحيح، ولا تستخدم الاسم المُعاد إلا إذا كانت هناك نتيجة قابلة للاستخدام.
INVITE sip:12025550123@cnam.multitel.net SIP/2.0لا تقبل خدمة البحث هذه تسجيل SIP. يعتمد التصريح على عنوان المصدر المُكوَّن، وقد يكون العنوان العام لبوابة NAT لديك.
اقرأ نتيجة البحث عبر SIP
تعيد الخدمة النتيجة في استجابة SIP برمز 380 مع ترويسة P-Asserted-Identity. هذه هي معاملة نتيجة البحث، وليست مكالمة هاتفية تم الرد عليها. قد تحتوي عبارة السبب على الاسم المُعاد؛ حلّل ترويسة الهوية بدلاً من الاعتماد على عبارة ثابتة واحدة.
SIP/2.0 380 EXAMPLE CALLER
P-Asserted-Identity: "EXAMPLE CALLER" <sip:12025550123@192.0.2.10>
Content-Length: 0يحذف هذا المقتطف ترويسات المعاملة. يمثل 192.0.2.10 النظام الطالب في المثال. يجب مطابقة الرد الفعلي مع Call-ID وCSeq الخاصين بحزمة SIP لديك.
- 380 مع اسم قابل للاستخدام
- اقرأ اسم العرض من P-Asserted-Identity، وأقرّ استلام الاستجابة النهائية لـ INVITE عبر حزمة SIP لديك، ثم تابع سير عمل الاتصال.
- لا يوجد اسم قابل للاستخدام
- لا تستخدم رسالة خطأ أو قيمة فارغة أو الرقم المُستعلَم عنه على أنه اسم متصل موثّق. أبقِ المكالمة تعمل وفق سلوكك المعتاد للاسم غير المعروف.
- 403 أو رفض آخر
- تحقق من طريقة الطلب ونطاق الوجهة وتصريح عنوان IP المصدر وحالة الحساب/الخدمة. لا تعد محاولة طلب فشل بسبب التصريح في حلقة متواصلة سريعة.
- انتهاء المهلة
- ميّز بين إعادات إرسال معاملة SIP وبين بحث جديد. قلّل المحاولات الجديدة لأنها قد تنشئ رسم استعلام آخر.
الفوترة وإعادة المحاولة والفرق عن تحديث معرّف المتصل
قد يترتب على كل بحث جديد رسم استعلام. لا توثّق واجهات البحث هذه مفتاح عدم التكرار (idempotency key)، لذا قد تكون إعادة المحاولة الجديدة استعلامًا ثانيًا مُحتسَبًا. استخدم عددًا محدودًا من المحاولات مع زيادة مهلة الانتظار عند أعطال النقل أو الخدمة، وعالج أخطاء الحساب أولًا، وطابِق رسوم الاستعلام المُبلَّغ عنها. خزّن مؤقتًا لمدة مناسبة لتطبيقك فقط؛ فبيانات أسماء المتصلين قد تتغير.
بحث CNAM يقرأ اسماً. ولا يغيّر الاسم المعروض في مكالماتك الصادرة. أما تحديث اسم المتصل في LIDB فهو عملية منفصلة لها حقولها وتصريحها وسعرها ومعالجتها الخاصة.