新增跟进提醒 - 尘锋SCRM开放平台

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

Content-Type: application/json

接口限制：单次上限1000条,每分钟调用600次；

Params:

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

请求参数

请求参数名	类型	说明	是否必须
remind_list	`Object[]`	更新提醒列表	true
remind_list.cid	`String`	尘锋客户id（和external_id，external_userid三选一必填）	true
remind_list.external_id	`String`	三方客户id （和cid，external_userid三选一必填）	true
remind_list.external_userid	`String`	外部客户id （和cid，external_id三选一必填）	true
remind_list.at_users	`Object[]`	@人列表（关联的提醒人列表）	false
remind_list.at_users._id	`String`	@人id	false
remind_list.at_users.name	`String`	@人名称	false
remind_list.content	`String`	跟进内容（文本上限1000字）	false
remind_list.schedule_time	`Int`	日程时间	true
remind_list.remind_time_type	`Int`	提醒时间类型（1-准时提醒；2-提前15分钟提醒；3-提前30分钟提醒；4-提前一小时提醒；5-提前一天提醒；6-自定义提醒）	true
remind_list.remind_time	`Int`	提醒时间（6-自定义提醒）（选择自定义提醒时，需设置提醒时间，字段为必填）	false
remind_list.files	`Object[]`	附件列表	false
remind_list.files.file_type	`String`	附件类型	false
remind_list.files.url	`String`	附件地址	false
remind_list.files.name	`String`	附件名称	false
remind_list.files.size	`Int`	附件大小	false
remind_list.corp_id	`String`	企业id	false
remind_list.external_corp_id	`String`	企业外部(暂时没有启用)id	false
remind_list.create_uid	`String`	创建人id（需要提醒的人）	true
operator_id	`String`	操作人id	true

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

{
    "operator_id": "2760",
    "remind_list": [
        {
            "cid": "5c4ec911-acb5-11ec-a3ac-c2553eae1880",
            "external_id": "",
            "external_userid": "",
            "corp_id": "",
            "content": "openapi 调用批量新增跟进提醒，${{3245}}&nbsp；批量新增，准时提醒${{2760}}&nbsp；",
            "schedule_time": 1649821469,
            "remind_time_type": 1,
            "create_uid": "3245",
            "at_users": [
                {
                    "_id": "2760",
                    "name": "xx"
                },
                {
                    "_id": "3245",
                    "name": "xx"
                }
            ],
            "files": [
                {
                    "file_type": "image",
                    "name": "1.jpg",
                    "size": 2089,
                    "url": "http://xxxx/static/1.jpg"
                }
            ]
        }
    ]
}

成功响应

响应参数名	类型	说明
code	`Int`	响应码
success	`Bool`	成功标识
msg	`String`	消息提示
data	`Object`	创建结果
data.success	`Object[]`	创建成功列表
data.success.id	`String`	跟进提醒外部id
data.success.index	`Int`	成功的索引位置
data.fail	`Object[]`	创建失败列表
data.fail.code	`Int`	创建错误码
data.fail.index	`Int`	错误索引位置
trace_id	`String`	跟踪id

成功响应示例

{
    "success": true,
    "msg": "操作成功",
    "data": {
        "fail": [],
        "success": [
            {
                "id": "36379f67-ba2c-11ec-b604-36f8d71eaa98",
                "index": 0
            }
        ]
    },
    "trace_id": "36ac74cb8b21bace"
}

错误响应示例

{
    "success": false,
    "code": 13028,
    "msg": "批次内有失败数据",
    "data": {
        "fail": [
            {
                "code": 13500,
                "index": 0
            }
        ],
        "success": []
    },
    "trace_id": "011ae081bfbc6127"
}