获取商机列表
最后更新:2023/06/25企业可通过此接口获取商机列表
请求方式: POST(HTTPS)
请求地址: https://open.wshoto.com/openapi/crm/work/opportunity/page?access_token=x
Query参数:
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 调用接口凭证 |
Body参数:
{
"user_id": "fake_data",
"owner": "fake_data",
"follow_user_id": "fake_data",
"customer_id": "fake_data",
"company_id": "fake_data",
"phase": [
11111,
2222
],
"start_time": 1638785104000,
"end_time": 1638785104000,
"field_map": {
"customField": "自定义字段"
},
"current_index": 1,
"page_size": 10
}
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
user_id | string | 否 | 当前用户 |
owner | string | 否 | 负责人 |
follow_user_id | string | 否 | 创建人 |
customer_id | string | 否 | 客户id |
company_id | string | 否 | 企业id |
phase | long[] | 否 | 阶段id集 |
start_time | long | 否 | 创建开始时间 |
end_time | long | 否 | 创建结束时间 |
field_map | map | 否 | 自定义字段 |
current_index | int | 否 | 页码。默认值为1 |
page_size | int | 否 | 列表返回长度。默认值为20,最大值为100 |
返回值:
{
"code": 0,
"msg": "请求成功",
"data": {
"total": 1,
"records": [
{
"id": "1420769618355580929",
"customer_id": "fake_data",
"customer_name": "fake_data",
"company_id": "1420769618355580929",
"company_name": "广州华晨口腔门诊部有限公司",
"opportunity_name": "fake_data",
"phase": "fake_data",
"phase_id": 1520769618355580929,
"follow": "fake_data",
"owner": "fake_data",
"discount_amount": 123,
"expected_time": 1653343431,
"competitor": "fake_data",
"priority": "fake_data",
"intention": "fake_data",
"remark": "fake_data",
"field_map": {
"mf_clue_101": "2022-06-21"
},
"create_time": 1653343431,
"phase_time": 1653343431,
"end_time": 1653343431,
"contact_time": 1653343431,
"win_reason": "fake_data",
"loss_reason": "fake_data"
}
]
},
"sub_code": "00000"
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
code | int | 返回码 |
msg | string | 对返回码的文本描述内容 |
data | obj | |
total | int | 商机数量 |
record | obj[] | 结果集 |
id | string | 商机id |
customer_id | string | 客户id |
customer_name | string | 客户名称 |
company_id | string | 企业ID |
company_name | string | 企业名称 |
opportunity_name | string | 商机名称 |
phase | string | 商机阶段名称 |
phase_id | long | 商机阶段id |
follow | string | 创建人 |
owner | string | 负责人 |
discount_amount | long | 折后总价 |
expected_time | long | 预计成交时间 |
competitor | string | 竞争对手 |
priority | string | 优先级 高 中 低 |
intention | string | 意向度 高 中 低 |
remark | string | 备注 |
field_map | map | 自定义字段 |
create_time | long | 创建时间 |
phase_time | long | 阶段变更时间 |
end_time | long | 商机结束时间 |
contact_time | long | 最后跟进时间 |
win_reason | string | 赢单原因 |
loss_reason | string | 输单原因 |
sub_code | string | 业务异常码 |