استخدم HTTPS ومصادقة HTTP Basic مع بيانات اعتماد API المعتمدة. احتفظ ببيانات الاعتماد على خادم التطبيق لديك. تستخدم نقاط نهاية PBX المستضاف هذه /hpbx/ على api.multitel.net؛ لا تُدرج /v3. تحقق من نتيجة HTTP ومن حالة التطبيق في استجابة JSON معًا.
اختر الرقم و PBX
صيغة نقطة النهاية هي POST /hpbx/dids/{operation}/{billing_code}. تشمل العمليات المدعومة الإنشاء والتعديل والحذف. يجب أن يحدد رمز الفوترة مقسم PBX تابعًا للحساب الذي جرت المصادقة عليه. إنشاء سجل توجيه لا يشتري رقم هاتف عامًا جديدًا.
حقول التوجيه
| الحقل | الغرض |
|---|---|
| number / fullnumber | رقم DID الذي يمثله سجل توجيه PBX. |
| comment | وصف موجه للمسؤول. |
| maxchannels | الحد الأقصى للمكالمات المتزامنة لمسار PBX. |
| destination | قيم الوجهات المرتبة لـ PBX المحدد. |
| unconditional | وجهة تحويل غير مشروطة عند استخدامها. |
| cnam | إعداد البحث عن اسم المتصل؛ قد تنطبق رسوم الاستخدام. |
| recording | سياسة التسجيل: no أو yes أو yeschange أو nochange. |
| di_emailrecording / di_minemailrecording | عنوان البريد الإلكتروني لإرسال التسجيل والحد الأدنى لمدة التسجيل. |
| allowemergency / emergencynotes | إعدادات معرّف المتصل لمكالمات الطوارئ؛ وهي لا تسجّل عنوانًا لاستخدامه في مكالمات الطوارئ. |
| didprefix / didnameprefix | بادئات أرقام/أسماء المتصلين. |
| fax / faxprotocol / faxstore / faxemail | اكتشاف الفاكس وخيارات البروتوكول والتسليم/التخزين. |
| sms_destination / di_smstofield / di_sms_store | إعدادات تسليم الرسائل/تخزينها المفعّلة. |
جهّز وجهات صالحة
يجب أن تأتي قيم الوجهة من PBX المحدد؛ فالمثال السابق Array() لم يكن بيانات طلب بصيغة JSON أو بيانات نموذج. حدّد الأرقام الداخلية أو أنظمة IVR أو المجموعات قبل إنشاء الطلب. استخدم مخطط توجيه الأرقام الحالي لواجهة API التي تتكامل معها.
تحقق من النتيجة
تحقق من حالة التطبيق، وأعد فتح تكوين الرقم وأجرِ مكالمة واردة للاختبار في ظروف مضبوطة. تحقق من مسارات الانشغال وعدم الرد والمهلة والتسجيل/الفاكس/الرسائل بشكل منفصل. اتبع دليل التوجيه في البوابة للحصول على تكوين خطوة بخطوة.