跟进商机

开发中

POST

/open-api/customer/biz-submit/add-follow

最后修改时间：2024-11-07 07:43:07

该接口用于通过应用获取企业的跟进商机/服务

注意

detailList 中每个 detail 必须与 moduleType 一致，否则会报错。

moduleType 指定为 Radio，则需要填写 optionId。

moduleType 指定为 Attachment，则需要填写 fileId。

moduleType 指定为 Location，则需要填写 lat 和 lng。

其他类型，填写 content。

请求参数

Query 参数

access_token

string

可选

应用调用 API 的凭证

示例值:

Header 参数

Authorization

string

可选

默认值:

Bearer {{auth_token}}

Body 参数application/json

businessId

integer

商机id

必需

stageId

integer

阶段id

必需

templateId

integer

模板id

必需

templateName

string

模板名称

必需

version

integer

版本

必需

userId

integer

员工id

必需

result

string

沟通结果

必需

nextTime

object (NextTime)

可选

scheduleName

string

日历名称

可选

nextContactTime

string

下次沟通时间

可选

nextTimeLength

integer

下次沟通时长

可选

单位（分钟）

nextRemindLength

integer

下次沟通提醒时间

可选

单位（分钟）

actualStartTime

string

实际开始时间

可选

yyyy-MM-dd

actualEndTime

string

实际结束时间

可选

yyyy-MM-dd

remark

string

备注

可选

detailList

array [object {3}]

提交详情列表

必需

moduleId

string

组件id

必需

moduleType

string

组件类型

必需

detail

array[string]

提交详情

必需

示例

{
  "businessId": 10,
  "stageId": 10,
  "templateId": 10,
  "templateName": "日常",
  "version": 1,
  "userId": 10,
  "result": "finish",
  "nextTime": {
    "scheduleName": "日常跟进",
    "nextContactTime": "2019-08-24T14:15:22Z",
    "nextTimeLength": 60,
    "nextRemindLength": 30
  },
  "actualStartTime": "2019-08-24T14:15:22Z",
  "actualEndTime": "2019-08-24T14:15:22Z",
  "remark": "备忘录",
  "detailList": [
    {
      "moduleId": 20,
      "moduleType": "Radio",
      "moduleName": "你的问题是",
      "moduleConfig": "{\"label\":\"单选\"}",
      "moduleCommunicateResult": "finish",
      "detail": [
        {
          "optionId": 20,
          "content": "这是答案",
          "nextTime": {
            "scheduleName": "日常跟进",
            "nextContactTime": "2019-08-24T14:15:22Z",
            "nextTimeLength": 60,
            "nextRemindLength": 30
          },
          "fileId": 10,
          "fileName": "file.png",
          "fileUrl": "https://file.png",
          "fileSize": 1024,
          "lat": 39.984154,
          "lng": 39.984154
        }
      ]
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST '/open-api/customer/biz-submit/add-follow?access_token={{access_token}}' \
--header 'Authorization: Bearer {{auth_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "businessId": 10,
  "stageId": 10,
  "templateId": 10,
  "templateName": "日常",
  "version": 1,
  "userId": 10,
  "result": "finish",
  "nextTime": {
    "scheduleName": "日常跟进",
    "nextContactTime": "2019-08-24T14:15:22Z",
    "nextTimeLength": 60,
    "nextRemindLength": 30
  },
  "actualStartTime": "2019-08-24T14:15:22Z",
  "actualEndTime": "2019-08-24T14:15:22Z",
  "remark": "备忘录",
  "detailList": [
    {
      "moduleId": 20,
      "moduleType": "Radio",
      "moduleName": "你的问题是",
      "moduleConfig": "{\"label\":\"单选\"}",
      "moduleCommunicateResult": "finish",
      "detail": [
        {
          "optionId": 20,
          "content": "这是答案",
          "nextTime": {
            "scheduleName": "日常跟进",
            "nextContactTime": "2019-08-24T14:15:22Z",
            "nextTimeLength": 60,
            "nextRemindLength": 30
          },
          "fileId": 10,
          "fileName": "file.png",
          "fileUrl": "https://file.png",
          "fileSize": 1024,
          "lat": 39.984154,
          "lng": 39.984154
        }
      ]
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

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

msg

string

状态码描述

必需

示例

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

创建商机

创建日程