10.3 商机创建（即将废弃）

请求参数

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为传参 ;
若apiName是文本类型: 长度<50 ;
是长文本类型: 长度<200 ;
是日期类型: 13位时间戳 ;
是单选类型: 选项的label值（number） ;
是多选类型: 选项的label值的集合（Array of number） )

示例

{
  "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": {}
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi.weiling.cn/openapi/business/add?access_token' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

Body

code

string

必需

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

msg

string

返回结果信息

必需

示例

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