Utilisez HTTPS et l'authentification HTTP Basic avec des identifiants API approuvés. Conservez les identifiants sur votre serveur d'application. Ces points de terminaison Hosted PBX utilisent /hpbx/ sur api.multitel.net ; n'insérez pas /v3. Vérifiez à la fois le résultat HTTP et le statut applicatif dans la réponse JSON.
Choisir le numéro et le PBX
Le format du point d’accès est POST /hpbx/dids/{operation}/{billing_code}. Les opérations prises en charge sont la création, la modification et la suppression. Le code de facturation doit désigner un PBX appartenant au compte authentifié. La création d’un enregistrement de routage n’achète pas de nouveau numéro de téléphone public.
Champs de routage
| Champ | Objet |
|---|---|
| number / fullnumber | Le DID représenté par l'enregistrement de routage PBX. |
| comment | Une description destinée aux administrateurs. |
| maxchannels | Le nombre maximal d’appels simultanés de la route PBX. |
| destination | Valeurs de destination ordonnées pour le PBX sélectionné. |
| unconditional | Une destination de renvoi inconditionnel, lorsqu’elle est utilisée. |
| cnam | Paramètre de recherche du nom de l'appelant ; des frais d'utilisation peuvent s'appliquer. |
| recording | Politique d’enregistrement : no, yes, yeschange ou nochange. |
| di_emailrecording / di_minemailrecording | Destination e-mail de l'enregistrement et durée minimale. |
| allowemergency / emergencynotes | Paramètres d'identifiant d'appelant d'urgence ; ceux-ci n'enregistrent pas d'adresse d'urgence. |
| didprefix / didnameprefix | Préfixes de numéro/nom d'appelant. |
| fax / faxprotocol / faxstore / faxemail | Détection de fax, protocole et choix de remise/stockage. |
| sms_destination / di_smstofield / di_sms_store | Paramètres de distribution et de stockage des messages activés. |
Préparer des destinations valides
Les valeurs de destination doivent provenir du PBX sélectionné ; l'ancien exemple Array() n'était pas une charge utile JSON ou de formulaire. Résolvez les postes, les IVR ou les groupes avant de construire la requête. Utilisez le schéma actuel de routage des numéros pour l'interface API à laquelle vous intégrez votre application.
Vérifier le résultat
Vérifiez l'état renvoyé par l'application, rouvrez la configuration du numéro et effectuez un appel entrant contrôlé. Testez séparément les chemins occupé, sans réponse, expiration, ainsi qu'enregistrement/fax/message. Suivez le guide d'acheminement du portail pour une configuration pas à pas.