微伴助手OpenAPI

获取客户事件列表

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数据模型

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"
    }
  ]
}

最后修改时间： 9 个月前