查询跟进提醒 - 尘锋SCRM开放平台

POST https://qw-openapi-tx.dustess.com/customer/v1/remindFindManyList?accessToken=

Content-Type: application/json

接口限制：每分钟调用600次；

使用说明：

创建时间段参数、更新时间段参数，这4个参数不能同时为空；

如果传了更新时间，则不会对创建时间指定默认最近七天；

Params:

字段	类型	描述	是否必须
accessToken	`String`	accessToken	true

请求参数

请求参数名	类型	说明	是否必须
cid	`String`	尘锋客户id	false
external_id	`String`	三方客户id	false
external_userid	`String`	外部客户id	false
remind_id	`String`	跟进提醒id	false
corp_id	`String`	企业编号	false
status	`Int`	状态，未传默认是：未完成=待完成+逾期（1：待完成，2：已完成 3：逾期 4:未开始(已不使用)）	false
creator_id	`String`	创建人id (查出的跟进记录当前员⼯为创建人)	false
create_start	`Int`	创建开始时间（时间戳，单位秒，未传时间默认最近七天，时间区间最⻓31天）	false
create_end	`Int`	创建结束时间（时间戳，单位秒，未传时间默认最近七天，时间区间最长31天）	false
update_start	`Int`	更新开始时间（时间戳，单位秒，未传不查询，时间区间最⻓31天）	false
update_end	`Int`	更新结束时间（时间戳，单位秒，未传不查询，时间区间最⻓31天）	false
page_size	`Int`	分页尺码(最大值500)	false
cfTs	`Int`	分页查询标识（上次查询结果的最后一条记录的id）	false

请求参数示例
json - Request-Example:

{
    "cid": "5c4ec911-acb5-11ec-a3ac-c2553eae1880",
    "external_id": "",
    "external_userid": "",
    "corp_id": "",
    "remind_id": "f6d317dd-b713-11ec-9904-d2d50ae0af71",
    "status": 0,
    "creator_id": "3245",
    "create_start": 1649403691,
    "create_end": 1649821469,
    "update_start": 1649648669,
    "update_end": 1649821469,
    "page_size": 200,
    "cfTs": 1226243666922717200
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码
msg	`String`	消息提示
success	`Bool`	成功标识
data	`Object`	数据信息
data.count	`Int`	数据量
data.list	`Object[]`	数据列表
data.list.atUsers	`Object[]`	提醒人列表
data.list.atUsers._id	`String`	提醒人id
data.list.atUsers.name	`String`	提醒人名称
data.list.cfTs	`Int`	分页查询标识（字段长使用uint64获取）
data.list.cid	`String`	联系人id
data.list.external_id	`String`	三方客户id
data.list.external_userid	`String`	外部客户id
data.list.cname	`String`	联系人名
data.list.completeTime	`Int`	完成时间
data.list.content	`String`	跟进内容
data.list.corpFullName	`String`	企业全称
data.list.corpID	`String`	企业id
data.list.corpName	`String`	企业简称
data.list.corpOwner	`String`	企业跟进人
data.list.corpStatus	`Int`	企业状态 0正常,1公海 2被删除
data.list.createTime	`Int`	创建时间
data.list.createUID	`String`	创建人
data.list.createUser	`String`	创建人名称
data.list.cusAvatar	`String`	联系人头像
data.list.cusCorpFullName	`String`	联系人关联企业全称
data.list.cusCorpName	`String`	联系人关联企业简称
data.list.cusOwner	`String`	联系人跟进人
data.list.cusPrivateRemark	`String`	联系人私有备注
data.list.cusStatus	`Int`	联系人状态 0正常,1公海 2被删除
data.list.cusType	`Int`	联系人类型 1->微信用户，2->企业微信用户，3->普通客户
data.list.id	`String`	跟进提醒id
data.list.isFinished	`Bool`	是否完成
data.list.ownType	`Int`	所属业务类型,1->个人,2-企业
data.list.relationID	`String`	关联对象id
data.list.remindTime	`Int`	提醒时间
data.list.remindTimeType	`Int`	提醒时间类型
data.list.scheduleTime	`Int`	日程时间
data.list.status	`Int`	状态
data.list.updateTime	`Int`	更新事件
data.list.userQuit	`Bool`	创建人是否离职
data.list.files	`Object[]`	附件列表获取附件URL访问签名
data.list.files.file_type	`String`	文件类型
data.list.files.name	`String`	文件名
data.list.files.size	`int`	文件大小
data.list.files.url	`String`	文件地址
trace_id	`String`	跟踪id

成功响应示例

{
    "success": true,
    "msg": "",
    "data": {
        "count": 1,
        "list": [
            {
                "atUsers": [],
                "cfTs": 1226565868293472300,
                "cid": "5c4ec911-acb5-11ec-a3ac-c2553eae1880",
                "cname": "xhaoge6",
                "completeTime": 0,
                "content": "openapi 调用批量新增跟进提醒，自定义时间立即提醒",
                "corpFullName": "",
                "corpID": "",
                "corpName": "",
                "corpOwner": "",
                "corpStatus": 0,
                "createTime": 1649405691,
                "createUID": "3245",
                "createUser": "xx",
                "cusAvatar": "",
                "cusCorpFullName": "xx企业",
                "cusCorpName": "xx企业",
                "cusOwner": "3245",
                "cusPrivateRemark": "",
                "cusStatus": 0,
                "cusType": 3,
                "files": [],
                "id": "f6d317dd-b713-11ec-9904-d2d50ae0af71",
                "isFinished": false,
                "ownType": 1,
                "relationID": "5c4ec911-acb5-11ec-a3ac-c2553eae1880",
                "remindTime": 1649405709,
                "remindTimeType": 6,
                "scheduleTime": 1649489214,
                "status": 3,
                "userQuit": false
            }
        ]
    },
    "trace_id": "1ebf2fd225a041db"
}

错误响应示例

 {
    "success": false,
    "code": 4005,
    "msg": "参数解析错误：一般是参数校验失败或者序列化失败",
    "data": {},
    "trace_id": ""
}