Name

QQ::weixin::work::dial

DESCRIPTION

公费电话

FUNCTION

get_dial_record(access_token, hash);

获取公费电话拨打记录 最后更新：2023/11/30

SYNOPSIS

https://developer.work.weixin.qq.com/document/path/93662

请求说明：

企业可通过此接口，按时间范围拉取成功接通的公费电话拨打记录。

请求包结构体为：

{
   "start_time": 1536508800,
   "end_time": 1536940800,
   "offset": 0,
   "limit": 100
}

参数说明：

	参数	            必须	说明
    access_token	是	调用接口凭证
    start_time	否	查询的起始时间戳
    end_time	否	查询的结束时间戳
    offset	否	分页查询的偏移量
    limit	否	分页查询的每页大小,默认为100条，如该参数大于100则按100处理

请注意，查询的时间范围为[start_time,end_time]，即前后均为闭区间。在两个参数都指定了的情况下，结束时间不得小于开始时间，开始时间也不得早于当前时间，否则会返回600018错误码(无效的起止时间)。 受限于网络传输，起止时间的最大跨度为30天，如超过30天，则以结束时间为基准向前取30天进行查询。 如果未指定起止时间，则默认查询最近30天范围内数据。

权限说明：

应用类型	权限要求
自建应用	配置到「公费电话 - 可调用接口的应用」中
代开发应用	暂不支持
第三方应用	暂不支持

注： 从2023年12月1日0点起，不再支持通过系统应用secret调用接口，存量企业暂不受影响 查看详情

RETURN 返回结果：

    {
	   "errcode": 0,
	   "errmsg": "ok",
	   "record":[
			{
				"call_time":1536508800,
				"total_duration":10,
				"call_type":1,
				"caller":
				{
					"userid":"tony",
					"duration":10
				},
				"callee":[
				{
					"phone":138000800,
					"duration":10
				}
				]
			},
			{
				"call_time":1536940800,
				"total_duration":20,
				"call_type":2,
				"caller":
				{
					"userid":"tony",
					"duration":10
				},
				"callee":[
					{
						"phone":138000800,
						"duration":5
					},
					{
						"userid":"tom",
						"duration":5
					}
				]
			}
	   ]
	}

RETURN 参数说明：

	参数	        说明
    errcode	返回码
	errmsg	对返回码的文本描述内容
	record.call_time	拨出时间
	record.total_duration	总通话时长，单位为分钟
	record.call_type	通话类型，1-单人通话 2-多人通话
	record.caller.userid	主叫用户的userid
	record.caller.duration	主叫用户的通话时长
	record.callee.userid	被叫用户的userid，当被叫用户为企业内用户时返回
	record.callee.phone	被叫用户的号码，当被叫用户为外部用户时返回
	record.callee.duration	被叫用户的通话时长

应用可见范围外用户相关的record会被过滤掉，不会返回 通话类型为单人通话时，总通话时长等于单人通话时长，通话类型为多人通话时，总通话时长等于包括主叫用户在内的每个接入用户的通话时长之和。