- OpenAPI基本介绍
- 错误码参考表
- 访问频率和并发限制
- 消息订阅
- 获取访问凭据
- 员工管理
- 自定义订单管理
- 客户管理
- 客户积分管理
- 客户标签管理
- 客户画像管理
- 标签库管理
- 群聊管理
- 工单管理
- 销售过程管理
- 聊天记录管理
- 拉新排行榜
- 群裂变
- 群打卡
- 企微任务宝
- 拉新排行榜
- 自定义表单
- 客户转化
- 员工个人群发记录管理
- 渠道码管理
- 素材库管理
- 互动雷达管理
- 自定义侧边栏身份校验
- 有赞订单管理
- 小鹅通订单管理
- 项目管理
- 门店信息
- 人群包
- 客户群发
- 企微朋友圈
- 个人SOP
- 部门管理
- 群标签管理
- 话术库
- 企微数据专区
导入客户信息
POST
/open-api/external_user/import_info
openapi
错误码 | 说明 |
---|---|
20210 | 客户external_user_id错误 |
20211 | 客户unionid错误 |
20212 | 请提供客户external_user_id或客户external_user_unionid |
20213 | 员工与客户无关联 |
20214 | external_user_fields格式有误 |
20215 | 自定义字段不存在 |
20216 | 该值内容长度超过500, 请重新修改 |
20217 | 下拉框的选项值不存在 |
21801 | 最多允许批量修改10个自定义字段 |
21802 | 参数option_id,field_value,field_datetime不能同时为空 |
21803 | 存在无效的员工或外部联系人 |
21804 | 存在无效的field_id |
21805 | 存在无效的option_id |
21806 | 存在外部联系人和员工没有好友关系 |
21807 | 存在字段类型和传入的参数不正确 |
21808 | 时间格式不正确 |
21809 | 缺少参数 |
21810 | 自定义信息更新失败,请重试 |
21811 | field_id为${field_id}的自定义字段不存在 |
请求参数
Query 参数
access_token
string
调用接口凭证
默认值:
{{access_token}}
Body 参数application/json
staff_id
string
客服员工id
external_user_id
string
可选
external_user_unionid
string
可选
external_user_openid
string
可选
phone_number
string
客户手机号
age
string
客户年龄
email
string
客户邮箱
birthday
string
客户生日
weibo
string
客户微博
qq
string
客户qq
address
string
客户地址
description
string
客户描述
state
string
来源渠道
external_user_fields
array [object {6}]
可选
field_name
string
自定义字段名称
field_type
string
可选
field_datetime
string
可选
option_name
string
可选
value
string
可选
number_value
number
可选
示例
{
"staff_id": "zhangsan",
"external_user_id": "wo8xjUCAAAGfqRyM0CGqryOsaKOYgEZE",
"external_user_unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
"phone_number": "17718167093",
"age": "18",
"email": "123@qq.com",
"birthday": "2000-01-01",
"weibo": "harchy",
"qq": "12345",
"address": "上海浦东区陆家嘴xx大厦11层",
"description": "活动添加客户,意向很高",
"state": "测试渠道",
"external_user_fields": [
{
"field_name": "测试时间2",
"field_type": "datetime",
"field_datetime": "2021-09-08 20:12:27"
},
{
"field_name": "样例文本7",
"field_type": "option_text",
"option_name": "选项文本1"
},
{
"field_name": "测试文本3",
"field_type": "text",
"value": "180cm"
},
{
"field_name": "测试数值4",
"field_type": "number",
"value": 180.22
}
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.weibanzhushou.com/open-api/external_user/import_info?access_token=' \
--header 'Content-Type: application/json' \
--data-raw '{
"staff_id":"zhangsan",
"external_user_id": "wo8xjUCAAAGfqRyM0CGqryOsaKOYgEZE",
"external_user_unionid": "oz9xvw_jfkmHMGWVSn5CatKSTOMU",
"phone_number":"17718167093",
"age":"18",
"email":"123@qq.com",
"birthday":"2000-01-01",
"weibo":"harchy",
"qq":"12345",
"address":"上海浦东区陆家嘴xx大厦11层",
"description":"活动添加客户,意向很高",
"state":"测试渠道",
"external_user_fields":[{
"field_name":"测试时间2",
"field_type": "datetime",
"field_datetime": "2021-09-08 20:12:27"
},
{
"field_name":"样例文本7",
"field_type": "option_text",
"option_name": "选项文本1"
},
{
"field_name": "测试文本3",
"field_type": "text",
"value": "180cm"
},
{
"field_name": "测试数值4",
"field_type": "number",
"value": 180.22
}
]
}'
返回响应
🟢200成功
application/json
Body
object {0}
示例
{
"errcode": 0,
"errmsg": "ok"
}
🟢200正常返回
修改于 2024-03-05 06:39:59