10.3 商机创建（即将废弃）

POST

https://openapi.weiling.cn/openapi/business/add

请求参数

Query 参数

access_token

string

接口调用凭证

必需

Body 参数application/json

business_name

string

商机名称

可选

stage

integer

必需

商机阶段值(默认是1，赢单是100，丢单是99，其他请查询10.2或者10.9接口)

company_id

string

可选

企业ID（company_id和related_customers不能同时为空）

related_customers

array [object {2}]

可选

对接人列表(所有对接人<=20)(company_id和related_customers不能同时为空)

type

integer

可选

对接人类型 0 手机号线索 1 企微好友

ids

array[string]

对接人ID列表

可选

user_ids

array[string]

可选

内部协作人id列表（长度<=20）

except_amount

number

预计赢单金额

可选

except_date

string

可选

预计赢单日期(yyyy-MM-dd)，不可传空字符串

winning_amount

number

可选

赢单金额（赢单：stage=100 时必填）

winning_date

string

可选

赢单日期(yyyy-MM-dd)，不可传空字符串（赢单：stage=100 时必填）

create_user_id

string

创建人id

必需

create_time

number

必需

创建时间(13位时间戳，精确到秒)

update_time

number

可选

更新时间(13位时间戳，精确到秒)

process_id

string

可选

商机流程id(请参考10.9接口)

business_custom

object

可选

商机自定义字段（⚠️如果系统中有字段设置了必填，则需要传此参数）
(key为apiName , value为传参 ;
是日期类型: 13位时间戳 ;
是单选类型: 选项的label值（number） ;
是多选类型: 选项的label值的集合（Array of number） )；
apiName通过https://www.apifox.cn/apidoc/shared/19699d3b-8e70-434a-b516-ce35107d2094/api-249167310 接口获取；
如没有，请联系小微配置。

from_channel_id

number

可选

渠道id（通过https://www.apifox.cn/apidoc/shared/19699d3b-8e70-434a-b516-ce35107d2094/api-249167310 接口获取）

示例

{
    "business_name": "string",
    "stage": 0,
    "company_id": "string",
    "related_customers": [
        {
            "type": 0,
            "ids": [
                "string"
            ]
        }
    ],
    "user_ids": [
        "string"
    ],
    "except_amount": 0,
    "except_date": "string",
    "winning_amount": 0,
    "winning_date": "string",
    "create_user_id": "string",
    "create_time": 0,
    "update_time": 0,
    "process_id": "string",
    "business_custom": {},
    "from_channel_id": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.weiling.cn/openapi/business/add?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "business_name": "string",
    "stage": 0,
    "company_id": "string",
    "related_customers": [
        {
            "type": 0,
            "ids": [
                "string"
            ]
        }
    ],
    "user_ids": [
        "string"
    ],
    "except_amount": 0,
    "except_date": "string",
    "winning_amount": 0,
    "winning_date": "string",
    "create_user_id": "string",
    "create_time": 0,
    "update_time": 0,
    "process_id": "string",
    "business_custom": {},
    "from_channel_id": 0
}'

返回响应

🟢200成功

application/json

Body

code

string

必需

返回结果码值-0:请求成功 500 系统错误

msg

string

返回结果信息

必需

示例

{
    "code": "string",
    "msg": "string"
}

修改于 2025-06-30 02:37:44

10.2 商机阶段查询

10.3 商机新增-新版