获取客户事件列表
GET
/open-api/external_user_event/list通过客户 external_user_id列表,批量查询客户动态
调用此接口需购买基础席位。
请求参数
Query 参数
staff_id
string
企业微信员工id
last_id
string
可选
客户事件id。 如果传入,则返回id>last_id的数据
external_user_id
string
可选
客户id。external_user_id 和 external_user_unionid 必须选择一个填写
external_user_unionid
string
可选
客户unionid。external_user_id 和 external_user_unionid 必须选择一个填写
external_user_openid
string
可选
客户openid。密文企业选择 external_user_unionid 时需填写
limit
string
可选
列表返回长度。默认值为30,最大值为100
offset
string
可选
列表偏移。用于迭代获取所有数据,默认值为0
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
errcode
integer
状态码
0为正常,非0代表错误。业务错误码下述,全局错误码见 全局错误码
errmsg
string
错误信息
成功时为'ok',错误时会以中文方式显示错误原因
total
integer
客户事件总数
客户事件总数
event_list
array [object {8}]
员工列表
字段说明见 ExternalUserEvent数据模型
id
integer
可选
事件id(随事件创建事件递增)
created_at
integer
可选
数据创建时间(微伴系统内时间)
content
string
事件内容
event_title
string
事件标题
event_type
string
可选
事件类型 示例:自定义事件类型:{"custom":custom_event_type_id}或基础微伴事件类型
external_user_id
string
外部联系人id
staff_id
string
员工id
staff_name
string
员工名称
示例
{
"errcode": 0,
"errmsg": "string",
"total": 0,
"event_list": [
{
"id": 0,
"created_at": 0,
"content": "string",
"event_title": "string",
"event_type": "string",
"external_user_id": "string",
"staff_id": "string",
"staff_name": "string"
}
]
}
最后修改时间: 7 个月前