- 开发指南
- 基础接口
- 客户设置
- 消息推送
- 客户&线索&待分配
- 客户查询
- 客户导入
- 客户
- 线索&待分配
- 商机
- 个人客户转企业客户
- 企业客户联系人
- 客户旅程
- 客户操作
- 按企微员工id列出企微好友客户详情POST
- 公海
- 企微组织架构
- 企微标签库
- 企业
- 合同
- 电商平台
- 营销
- 数据统计
- 内容访客
- 电销手机
- SOP任务
- 群发消息
- 管控
- 工单
- 素材
- 应用通知
- 附录
- 群数据
- 店主活码
创建联系人
POST
/api/v3/contacts/create
请求参数
Header 参数
appId
string
应用 appId
默认值:
{{appId}}
timestamp
string
请求时间戳
默认值:
{{timestamp}}
sign
string
请求消息签名值
默认值:
{{sign}}
appKey
string
应用 appKey
默认值:
{{appKey}}
Body 参数application/json
customerId
number
企业客户id
salesId
number
员工id
contacts
array [object {1}]
联系人
fields
array [object {2}]
联系人字段信息
示例
{
"customerId": 478452324988992,
"salesId": 463352988837952,
"contacts": [
{
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-01"
]
},
{
"id": 916,
"value": [
"0719联系人01"
]
},
{
"id": 913,
"value": [
"207191159001"
]
},
{
"id": 3996,
"value": [
"207191159001"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-02"
]
},
{
"id": 916,
"value": [
"0719联系人02"
]
},
{
"id": 913,
"value": [
"207191159002"
]
},
{
"id": 3996,
"value": [
"207191159002"
]
},
{
"id": 915,
"value": [
"220002000测试描述瞎填915测试描述瞎填9152"
]
}
]
}
]
}示例代码
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/contacts/create' \
--header 'appId;' \
--header 'timestamp;' \
--header 'sign;' \
--header 'appKey: {{appKey}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"customerId": 478452324988992,
"salesId": 463352988837952,
"contacts": [
{
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-01"
]
},
{
"id": 916,
"value": [
"0719联系人01"
]
},
{
"id": 913,
"value": [
"207191159001"
]
},
{
"id": 3996,
"value": [
"207191159001"
]
},
{
"id": 915,
"value": [
"120002000测试描述瞎填915测试描述瞎填9152"
]
}
]
},
{
"fields": [
{
"id": 2743,
"value": [
"北京市/北京市/海淀区"
]
},
{
"id": 920,
"value": [
"2022-06-02"
]
},
{
"id": 916,
"value": [
"0719联系人02"
]
},
{
"id": 913,
"value": [
"207191159002"
]
},
{
"id": 3996,
"value": [
"207191159002"
]
},
{
"id": 915,
"value": [
"220002000测试描述瞎填915测试描述瞎填9152"
]
}
]
}
]
}'返回响应
🟢200成功
application/json
Body
code
integer
必需
message
string
必需
data
object
必需
errId
integer
可选
contacts
object
可选
示例
{
"code": 0,
"message": "success",
"data": {
"contacts": {
"487931210678272": [
"207191159010"
],
"487931207669760": [
"207191159004"
],
"487931209789440": [
"207191159008"
],
"487931199510528": [
"207191159001"
],
"487931206617088": [
"207191159002"
],
"487931210237952": [
"207191159009"
],
"487931207219200": [
"207191159003"
],
"487931209170944": [
"207191159007"
],
"487931208071168": [
"207191159005"
],
"487931208454144": [
"207191159006"
]
}
}
}