请使用 HTTPS 和 HTTP Basic 身份验证,并使用经批准的 API 凭据。请将凭据保存在您的应用服务器上。这些托管 PBX 端点在 api.multitel.net 上使用 /hpbx/;请勿插入 /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 | 紧急呼叫的主叫号码（Caller ID）设置；这些设置不会登记用于紧急呼叫的服务地址。 |
| didprefix / didnameprefix | 主叫号码/名称前缀。 |
| fax / faxprotocol / faxstore / faxemail | 传真检测、协议及递送/存储选项。 |
| sms_destination / di_smstofield / di_sms_store | 已启用的消息投递/存储设置。 |
准备有效的呼叫目标
目的地的值必须来自所选的 PBX;以前的 Array() 示例不是 JSON 或表单负载。请在构造请求之前先确定分机、IVR 或组。针对您要集成的 API 接口,请使用当前的号码路由数据结构规范。
验证结果
检查 API JSON 响应中的应用层操作结果状态，重新打开该号码的配置并进行一次受控的呼入测试。请分别检查忙线、无应答、超时以及录音/传真/消息路径。遵循门户路由指南进行分步配置。