HTTPSと、承認済みのAPI認証情報を用いたHTTP Basic認証を使用してください。認証情報はアプリケーションサーバー上で保管してください。これらのホステッドPBXエンドポイントでは、/hpbx/ を api.multitel.net で使用します。/v3 は挿入しないでください。HTTPの結果と、JSONレスポンス内のアプリケーションレベルの処理結果ステータスの両方を確認してください。
番号とPBXを選択
エンドポイントの形式は POST /hpbx/dids/{operation}/{billing_code} です。サポートされる操作には、作成、編集、削除が含まれます。課金コードは、認証済みアカウントに属する PBX を指定する必要があります。ルーティングレコードを作成しても、新しい公衆電話網の電話番号が購入されるわけではありません。
ルーティングフィールド
| フィールド | 目的 |
|---|---|
| number / fullnumber | PBX のルーティングレコードで表される DID。 |
| comment | 管理者向けの説明です。 |
| maxchannels | PBXルートの最大同時通話数。 |
| destination | 選択したPBXの順序付けされた着信先の値。 |
| unconditional | 使用時の無条件転送先。 |
| cnam | 発信者名検索設定。利用料金が適用される場合があります。 |
| recording | 録音ポリシー：no、yes、yeschange、またはnochange。 |
| di_emailrecording / di_minemailrecording | 録音のメール送信先と最短録音時間。 |
| allowemergency / emergencynotes | 緊急通報用の発信者ID設定です。これらは緊急通報用住所を登録するものではありません。 |
| didprefix / didnameprefix | 発信者番号／名前のプレフィックス。 |
| fax / faxprotocol / faxstore / faxemail | FAX検出、プロトコル、および配信/保存の選択肢。 |
| sms_destination / di_smstofield / di_sms_store | 有効になっているメッセージ配信・保存設定。 |
有効な宛先を準備する
宛先の値は選択したPBXから取得する必要があります。以前の Array() のサンプルは、JSONまたはフォームのペイロードではありませんでした。リクエストを構築する前に、内線、IVR、またはグループの識別情報を確認してください。連携するAPIインターフェースには、最新の番号ルーティングスキーマを使用してください。
結果を確認する
JSONレスポンス内のアプリケーションレベルの処理結果ステータスを確認し、番号の設定を再度開いて、条件を管理した着信テストを行ってください。話中、不応答、タイムアウト、および録音／FAX／メッセージの各経路を個別に確認してください。段階的な設定については、ポータルのルーティングガイドに従ってください。