获取客户事件列表 - 微伴助手OpenAPI

请求参数

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

access_token

string

调用接口凭证

必需

默认值:

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://open.weibanzhushou.com/open-api/external_user_event/list?staff_id&last_id=&external_user_id&external_user_unionid&external_user_openid&limit&offset&access_token='

返回响应

🟢200成功

application/json

Body

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

🟢200正常返回