השתמשו ב-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 שאליו אתם מתחברים.
אימות התוצאה
בדקו את סטטוס היישום, פתחו מחדש את תצורת המספר ובצעו שיחה נכנסת מבוקרת. בדקו בנפרד נתיבי עסוק, אי-מענה, פסק זמן והקלטה/פקס/הודעות. עיינו במדריך הניתוב של הפורטל לתצורה שלב אחר שלב.