- 开发指南
- 基础接口
- 客户设置
- 消息推送
- 客户&线索&待分配
- 客户查询
- 客户导入
- 客户
- 线索&待 分配
- 商机
- 个人客户转企业客户
- 企业客户联系人
- 客户旅程
- 客户操作
- 按企微员工id列出企微好友客户详情POST
- 公海
- 企微组织架构
- 企微标签库
- 企业
- 合同
- 电商平台
- 营销
- 数据统计
- 内容访客
- 电销手机
- SOP任务
- 群发消息
- 管控
- 工单
- 素材
- 应用通知
- 附录
- 群数据
- 店主活码
创建客户商机
POST
/api/v3/opportunity/add
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
salesId
integer
销售id
customerId
integer
客户id
name
string
商机名称
oppTypeId
number
商机类型id
stage
integer
销售阶段id
expectedDealTime
string
预计成交时间
expectedDealAmount
integer
预计成交金额
fields
array [object {2}]
客户商机字段
fieldId
integer
商机字段id
value
string
商机字段值
commodities
array [object {10}]
客户商机关联商品
banner
string
封面
spuId
integer
商品id
spuTitle
string
商品名称
skuId
integer
商品规格id
skuDetail
string
规格明细
unitPriceOrigin
number
商品划线单价
unitPriceSale
number
商品销售单价
count
integer
数量
totalAmount
integer
商品总售价
totalAmountFinal
integer
最终总售价
示例
{
"salesId": 444256224170048,
"customerId": 473309460299840,
"name": "1111111111111111111111111111111123而是哈哈哈哈哈哈哈哈哈哈哈",
"stage": 447253093488704,
"expectedDealTime": "2022-04-30 00:00:00",
"expectedDealAmount": 5,
"fields": [
{
"fieldId": "464217610952640",
"value": "[]"
},
{
"fieldId": "463149358395456",
"value": ""
},
{
"fieldId": "471679616186305",
"value": ""
},
{
"fieldId": "471863808317376",
"value": ""
}
],
"commodities": [
{
"banner": "https://dev.tanmarket.cn/fdfsServer/group1/M00/2B/37/rBHTdWHig7mAVIVdAAJw3D-ggjY183.jpg",
"spuId": 460710335281216,
"spuTitle": "分销分销分销",
"skuId": 460710335313984,
"skuDetail": "{\"id\": null, \"detail\": \"统一规格\"}",
"unitPriceOrigin": 5,
"unitPriceSale": 5,
"count": 1,
"totalAmount": 5,
"totalAmountFinal": 5
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v3/opportunity/add' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"salesId": 444256224170048,
"customerId": 473309460299840,
"name": "1111111111111111111111111111111123而是哈哈哈哈哈哈哈哈哈哈哈",
"stage": 447253093488704,
"expectedDealTime": "2022-04-30 00:00:00",
"expectedDealAmount": 5,
"fields": [
{
"fieldId": "464217610952640",
"value": "[]"
},
{
"fieldId": "463149358395456",
"value": ""
},
{
"fieldId": "471679616186305",
"value": ""
},
{
"fieldId": "471863808317376",
"value": ""
}
],
"commodities": [
{
"banner": "https://dev.tanmarket.cn/fdfsServer/group1/M00/2B/37/rBHTdWHig7mAVIVdAAJw3D-ggjY183.jpg",
"spuId": 460710335281216,
"spuTitle": "分销分销分销",
"skuId": 460710335313984,
"skuDetail": "{\"id\": null, \"detail\": \"统一规格\"}",
"unitPriceOrigin": 5,
"unitPriceSale": 5,
"count": 1,
"totalAmount": 5,
"totalAmountFinal": 5
}
]
}'
返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
必需
data
integer
客户商机id
示例
{
"code": 0,
"message": "success",
"data": 473242247674304
}
修改于 2023-05-22 08:32:58