查询特定消息渠道

查询特定消息渠道。

请求 URL

GET {base_url}/{api_path}/message_channel/search?access_token={access_token}

请求参数

参数 是否必填 类型 说明
page 是 Integer 定义显示第几个页面。
page_size 是 Integer 定义每页显示几项查询结果。
time_range 是 String 指定时间范围，用于统计或筛选消息渠道的消息。

取值范围：

  • today：今天。
  • yesterday：昨天。
  • last_7_days：最近 7 天。
  • last_30_days：最近 30 天。
  • this_month：本月。
  • all：所有。
search_value 否 String 搜索关键字。

响应参数

参数 类型 说明
errcode Integer 返回错误码。
  • 0：请求成功。
  • 非零值：请求失败。
注： 更多错误码和错误信息说明，请参见 错误码 & 错误信息。
errmsg String 返回信息。
  • SUCCESS：请求成功。
  • FAILURE：请求失败。
total_number Integer 搜索到的消息渠道总数。
list Array<Msg_Channel> 消息渠道信息。
Msg_Channel
参数 类型 说明
id Integer 消息渠道的唯一 ID。
status String 消息渠道的连接状态。
  • status_connect_succ：连接成功。
  • status_connect_fail：连接失败。
  • status_sub_invalid：PBX 服务订阅无效。
reason String 消息渠道连接失败的原因。
name String 消息渠道名称。
channel String 消息渠道的运营商。
  • general
  • apidaze
  • athena
  • bandwidth
  • flowroute
  • ixica
  • siptrunk
  • skyetel
  • telnyx
  • twilio
  • vetta
  • voicemeup
  • whatsapp
  • facebook
  • livechat
type String 消息渠道类型。
  • sms
  • whatsapp
  • facebook
  • livechat
number Array<String> 消息渠道绑定的 DID 号码。
sent Integer 已发送消息的总数。
delivered Integer 发送成功的消息数量。
failed Integer 发送失败的消息数量。
received Integer 接收的消息数量。

示例

请求示例

GET /openapi/v1.0/message_channel/search?access_token=znoITCklDMRbzBxLGUwIUJOmmVaRx6zy&page=1&page_size=2&time_range=last_7_days&search_value=Sales HTTP/1.1
Host: 192.168.5.150:8088

响应示例

HTTP/1.1 200 OK
{
    "errcode": 0,
    "errmsg": "SUCCESS",
    "total_number": 6,
    "list": [
        {
            "id": 3,
            "status": "status_connect_succ",
            "reason": "",
            "name": "Sales Hotline",
            "channel": "whatsapp",
            "type": "whatsapp",
            "number": [
                "+12025550123"
            ],
            "sent": 0,
            "delivered": 0,
            "failed": 0,
            "received": 0
        }
    ]
}