Hosted PBX API: δρομολόγηση αριθμών τηλεφώνου

Χρησιμοποιήστε HTTPS και έλεγχο ταυτότητας HTTP Basic με εγκεκριμένα διαπιστευτήρια API. Φυλάσσετε τα διαπιστευτήρια στον διακομιστή της εφαρμογής σας. Αυτά τα τελικά σημεία του Hosted 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Διεύθυνση email παραλήπτη ηχογραφήσεων και ελάχιστη διάρκεια.
allowemergency / emergencynotesΡυθμίσεις caller-ID έκτακτης ανάγκης· αυτές δεν καταχωρίζουν διεύθυνση έκτακτης ανάγκης.
didprefix / didnameprefixΠροθέματα αριθμού/ονόματος καλούντος.
fax / faxprotocol / faxstore / faxemailΑνίχνευση φαξ, πρωτόκολλο και επιλογές παράδοσης/αποθήκευσης.
sms_destination / di_smstofield / di_sms_storeΕνεργοποιημένες ρυθμίσεις παράδοσης/αποθήκευσης μηνυμάτων.

Προετοιμάστε έγκυρους προορισμούς

Οι τιμές προορισμού πρέπει να προέρχονται από το επιλεγμένο PBX· το προηγούμενο δείγμα Array() δεν ήταν ωφέλιμο φορτίο JSON ή φόρμας. Επιλύστε τους εσωτερικούς αριθμούς, τα IVR ή τις ομάδες πριν δημιουργήσετε το αίτημα. Χρησιμοποιήστε το τρέχον σχήμα δρομολόγησης αριθμών για τη διεπαφή API με την οποία πραγματοποιείτε την ενσωμάτωση.

Επαληθεύστε το αποτέλεσμα

Ελέγξτε την κατάσταση της ενέργειας που επιστρέφεται στην απόκριση του API, ανοίξτε ξανά τη διαμόρφωση του αριθμού και πραγματοποιήστε μια ελεγχόμενη εισερχόμενη κλήση. Ελέγξτε ξεχωριστά τις διαδρομές κατειλημμένου, μη απάντησης, λήξης χρονικού ορίου και ηχογράφησης/φαξ/μηνύματος. Ακολουθήστε τον οδηγό δρομολόγησης της πύλης για διαμόρφωση βήμα προς βήμα.

Αναζήτηση τεκμηρίωσης