创建商机

开发中

POST

/open-api/customer/biz-submit/create-business

最后修改时间：2024-11-07 10:14:09

该接口用于通过应用创建商机/服务对象

注意

customerId 和 prospectId 不能同时为空，只需要填写一个，当两者都存在时，根据 source 获取：

当 source 为 1 时，customerId 必填；

当 source 为 2 时，prospectId 必填；

当 source 为 3 时，prospectId 和prospectFollowLineId 必填；

nextContactTime 为空时，不会创建日程

请求参数

Query 参数

access_token

string

可选

应用调用 API 的凭证

示例值:

Header 参数

Authorization

string

可选

默认值:

Bearer {{auth_token}}

Body 参数application/json

lineId

integer

业务线id

必需

processId

integer

商机流程id

必需

nextTime

object (NextTime)

可选

scheduleName

string

日历名称

可选

nextContactTime

string

下次沟通时间

可选

nextTimeLength

integer

下次沟通时长

可选

单位（分钟）

nextRemindLength

integer

下次沟通提醒时间

可选

单位（分钟）

customerId

integer

客户id

可选

prospectId

integer

线索id

可选

prospectFollowLineId

integer

线索跟进id

可选

userId

integer

跟进人id

必需

source

enum<integer>

来源

必需

枚举值:

123

示例

{
  "lineId": 10,
  "processId": 10,
  "nextTime": {
    "scheduleName": "xx日程",
    "nextContactTime": "2024-08-08T14:00:00Z",
    "nextTimeLength": 60,
    "nextRemindLength": 30
  },
  "customerId": 100,
  "prospectId": 200,
  "prospectFollowLineId": 300,
  "userId": 500,
  "source": 1
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/open-api/customer/biz-submit/create-business?access_token={{access_token}}' \
--header 'Authorization: Bearer {{auth_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "lineId": 10,
  "processId": 10,
  "nextTime": {
    "scheduleName": "xx日程",
    "nextContactTime": "2024-08-08T14:00:00Z",
    "nextTimeLength": 60,
    "nextRemindLength": 30
  },
  "customerId": 100,
  "prospectId": 200,
  "prospectFollowLineId": 300,
  "userId": 500,
  "source": 1
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

0 表示成功，非 0 表示失败

msg

string

状态码描述

必需

示例

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

创建线索

跟进商机