商机列表

最后更新:2025/02/07

企业可通过此接口查询商机

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/crm/saleOpportunity/page

Query参数:

参数 类型 必填 说明
access_token string 调用接口凭证

Body参数:

{
  "user_ids": null,
  "target_type": "",
  "target_ids": [],
  "phase_ids": [],
  "created_time_start": null,
  "created_time_end": null,
  "field_map": {},
  "current_index": 1,
  "page_size": 10
}
参数 类型 必填 说明
current_index int 当前页,默认值为1
page_size int 每页大小,默认值为20
user_ids string[] 创建人ID列表
target_type string 对象类型
target_ids string[] 目标对象ID列表
phase_ids string[] 商机阶段ID列表
created_time_start string 创建时间-开始,格式为yyyy-MM-dd HH:mm:ss
created_time_end string 创建时间-结束,格式为yyyy-MM-dd HH:mm:ss
field_map map 自定义字段筛选

返回值:


{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 1,
    "records": [
      {
        "id": "1887707880627376897",
        "name": "商机名称",
        "remark": "商机备注",
        "amount": 3998,
        "discount": null,
        "priority": "高",
        "intention": "高",
        "competitor": "竞争对手名称",
        "endTime": "1970-01-01 08:00:00",
        "reason": null,
        "user_id": "woDkH9EAAALaUpfS5UqkDUOvLLkBu1Dg",
        "contact_id": "1887687526362172930",
        "company_id": "1887687525284236801",
        "discount_amount": 1999,
        "phase_id": "1866308619805444291",
        "phase_name": "需求确定",
        "phase_time": "2025-02-07 11:40:05",
        "expected_time": "2025-02-19 00:00:00",
        "reason_id": null,
        "field_map": {
          "mf_opportunity_2": "55555555",
          "mf_opportunity_54": [
            {
              "name": "分类2",
              "id": "1866383356501969923"
            }
          ],
          "mf_opportunity_53": [
            {
              "name": "选项1",
              "id": "1866383356128676865"
            },
            {
              "name": "选项2",
              "id": "1866383356128676866"
            }
          ],
          "mf_opportunity_1": "22222222222",
          "mf_opportunity_101": "2025-02-13",
          "mf_opportunity_102": "2025-02-28 00:00:00",
          "mf_opportunity_52": [
            {
              "name": "选项2",
              "id": "1866383355507919874"
            }
          ],
          "mf_opportunity_51": "231"
        },
        "create_time": "2025-02-07 11:40:06",
        "follow_time": "2025-02-07 11:39:58"
      }
    ]
  },
  "sub_code": "00000"
}

参数说明:

参数 类型 说明
code int 返回码
msg string 对返回码的文本描述内容
data object 结果
 total long 总条数
 records object[] 商机信息
  id string 商机ID
  user_id string 员工ID
  contact_id string 联系人ID
  company_id string 企业ID
  name string 商机名称
  remark string 商机备注
  amount long 商机金额
  discount_amount long 折后价
  discount string 折扣
  phase_id string 商机阶段ID
  phase_name string 商机阶段名称
  phase_time string 阶段变更时间
  priority string 优先级
  intention string 意向度
  expected_time string 预计成交日期
  competitor string 竞争对手
  end_time string 结束时间
  reason_id string 原因ID
  reason string 输单原因
  field_map map 自定义字段
  create_time string 创建时间
  follow_time string 商机变更时间

results matching ""

    No results matching ""