添加语音留言

添加语音留言到指定分机。

使用场景

PBX 用于酒店系统中的房间分机管理，而酒店系统使用第三方语音留言系统存储语音留言。当房间分机有语音留言时，第三方语音留言系统可以调用 API 添加一个语音留言到注册了对应房间话机的 PBX 分机，从而触发话机上的消息指示灯亮起，提示客人有新的语音留言。

请求 URL

POST {base_url}/{api_path}/vm/create?access_token={access_token}

请求参数

参数 是否必填 类型 说明
vm_from_number 是 String 留言方的号码。
注：
  • 支持输入数字 0-9，以及字符 *、#、+、[、]、(、)、-、.。
  • 最大字符长度限制为 31。
vm_to_number 是 String 被留言方的分机号码。

响应参数

表 1.
参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
id String 语音留言的唯一 ID。

示例

请求示例

POST /openapi/v1.0/vm/create?access_token=LOTrEg962uKH7lQAYGDtGDf3CT48RwmE HTTP/1.1
Host: 192.168.5.150:8088
Content-Type: application/json
User-Agent: OpenAPI

{
  "vm_from_number": "5503301",
  "vm_to_number": "1005"
}

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "id": "1718170428-00000009"
}