微伴助手OpenAPI
  1. 人群包
微伴助手OpenAPI
  • OpenAPI基本介绍
  • 错误码参考表
  • 访问频率和并发限制
  • 消息订阅
    • 订阅消息加解密指南
    • 回调应用配置指南
    • 工单变更消息
      • 工单变更消息回调
      • 创建工单回调
      • 流转工单回调
      • 关闭工单回调
      • 重新打开工单回调
      • 评论工单回调
  • 获取访问凭据
    • 获取访问凭据
      POST
  • 员工管理
    • 获取员工列表
      GET
    • 获取员工详情
      GET
    • 发送员工通知
      POST
  • 自定义订单管理
    • 订单信息删除
      GET
    • 获取订单信息列表
      GET
    • 批量同步店铺信息
      POST
    • 批量同步商品信息
      POST
    • 批量同步订单信息v2
      POST
    • 批量删除商品信息
      POST
    • 删除店铺信息
      GET
    • 批量删除订单信息
      POST
    • 获取店铺信息详情
      POST
    • 获取店铺信息列表
      GET
    • 获取商品信息详情
      POST
    • 获取商品信息列表
      GET
  • 客户管理
    • 获取客户列表
    • 根据更新时间获取客户列表
    • 获取客户详情
    • 获取流失提醒客户列表
    • 导入客户信息
    • 添加客户评分
    • 添加自定义字段
    • 批量预设客户属性
    • 批量修改自定义字段的值
    • 创建批量加好友任务(批量创建添加客户任务)
    • 批量unionid&openid换external_user_id
    • external_user_id换unionid
    • unionid&openid换客户id
    • 获取客户自定义字段值列表
    • 批量获取客户详情
    • 获取批量加好友待添加列表
  • 客户积分管理
    • 批量增减客户积分
    • 批量获取客户积分
    • 获取单个客户积分明细记录
    • 获取全部客户积分明细记录
  • 客户标签管理
    • 获取标签列表
    • 批量更新客户企业标签
    • 给客户添加企业标签
    • 删除客户的企业标签
    • 给客户添加微伴个人标签
    • 删除客户的微伴个人标签
    • 获取预打标签信息
    • 批量预打企业标签
    • 根据手机号删除预打标签任务
    • 根据unionid删除预打标签任务
    • 获取指定用户预打标签任务详情
    • 获取预打标签任务列表
    • 添加预打标签任务
  • 客户画像管理
    • 获取客户事件列表
    • 创建自定义客户事件
    • 获取自定义客户事件类型列表
    • 获取自定义客户事件类型详情
    • 添加自定义客户事件类型
    • 删除自定义客户事件类型
    • 更新自定义客户事件类型
    • 获取客户阶段状态
  • 标签库管理
    • 获取标签列表V2
    • 获取指定标签信息
    • 新增企业标签组
    • 新增企业标签
    • 删除企业标签
    • 更新企业标签
    • 同步企业微信标签
  • 群聊管理
    • 获取群聊列表
    • 获取群聊成员列表
    • 获取客户所在群聊
    • 查看客户是否在群聊中
    • 获取群聊详情
  • 工单管理
    • 工单模块OpenAPI开发必读
    • 获取工单列表
    • 获取工单详情
    • 获取工单流内处理人
    • 获取工单模板列表
    • 获取工单模板详情
    • 新建工单
    • 修改工单
    • 流转工单
    • 评论工单
    • 关闭工单
  • 销售过程管理
    • 获取商机列表
    • 获取商机详情
    • 修改商机阶段
    • 获取线索公海列表
    • 批量导入线索
    • 修改线索
    • 获取线索列表
    • 员工单条/批量领取线索
    • 获取线索客户列表
  • 聊天记录管理
    • 获取会话消息
    • 获取会话消息2(按照消息时间逆序)
    • 获取员工会话
  • 拉新排行榜
    • 获取拉新排行榜列表
  • 群裂变
    • 获取群裂变活动列表
    • 获取群裂变任务详情
    • 获取群裂变客户详情列表
  • 群打卡
    • 获取群打卡活动列表
    • 获取群打卡任务详情
  • 企微任务宝
    • 获取企微任务宝活动列表
    • 获取企微任务宝任务详情
    • 获取企微任务宝对应的客户数据列表
    • 获取客户对应的企微任务宝数据列表
  • 拉新排行榜
    • 获取拉新排行榜活动列表
  • 自定义表单
    • 获取自定义表单列表
    • 自定义表单用户与表单关系列表
    • 自定义表单提交数据详情列表
    • 获取自定义表单分组列表
  • 客户转化
    • 批量新增手机线索转化
  • 员工个人群发记录管理
    • 获取员工个人群发记录列表
    • 获取员工个人群发记录结果列表
  • 渠道码管理
    • 获取渠道码列表
    • 获取渠道码加人数据
  • 素材库管理
    • 获取素材库列表
    • 获取素材库标签列表
    • 新增素材
    • 更新素材
    • 删除素材
    • 新建素材分组
    • 修改素材分组
    • 添加素材库标签
    • 删除素材库标签
    • 删除素材分组
    • 素材分组列表
  • 互动雷达管理
    • 获取雷达列表
    • 获取雷达详情
    • 添加雷达
    • 修改雷达
    • 删除雷达
    • 上传file
    • 获取雷达分组列表
    • 获取雷达客户访问记录
  • 自定义侧边栏身份校验
    • 侧边栏模块化-自定义卡片功能说明
    • 自定义侧边栏Code校验
  • 有赞订单管理
    • 获取有赞订单
    • 获取有赞订单列表
  • 小鹅通订单管理
    • 获取小鹅通TOKEN
  • 项目管理
    • 项目列表
  • 门店信息
    • 批量导入门店
    • 批量更新门店
    • 门店列表
  • 人群包
    • 人群包列表获取
      POST
    • 创建人群包
      POST
    • 更新人群包
      POST
    • 创建的人群包中添加数据
      POST
    • 获取人群包数据详情
      GET
  • 客户群发
    • 客户群发创建
    • 群发任务列表
    • 群群发详情获取
    • 员工群发结果
    • 客户群群发创建
    • 员工-群群发结果
    • 获取群发错误unionid/extid
  • 企微朋友圈
    • 企微朋友圈创建
    • 企微朋友圈任务列表
    • 企微朋友圈任务发表详情
  • 个人SOP
    • 个人SOP列表
    • 个人SOP详情-规则列表
    • 个人SOP详情-执行记录
  • 部门管理
    • 获取部门列表
  • 群标签管理
    • 获取群聊标签分组及其子列表
    • 群聊批量打标签
  • 话术库
    • 企业话术分组列表
    • 企业话术列表
  • 企微数据专区
    • 获取会话消息(企微数据专区)
  1. 人群包

获取人群包数据详情

GET
/open-api/external_user_package/data_list
调用此接口需购买基础席位。

请求参数

Query 参数
page_no
integer 
每页的数量
必需
示例值:
1
page_size
integer 
页数
必需
示例值:
20
package_id
integer 
人群包的id
必需
access_token
string 
调用接口凭证
必需
默认值:
{{access_token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://open.weibanzhushou.com/open-api/external_user_package/data_list?page_no=1&page_size=20&package_id=&access_token='

返回响应

🟢200成功
application/json
Body
has_next
boolean 
必需
objects
array [object {11}] 
必需
avatar
string 
头像
必需
belong_staff_list
array [object {40}] 
所属客服列表
必需
corp_id
string 
公司id
必需
eu_dep_path_v2_list
array [object {2}] 
客服所属部门路径
必需
eu_tag_list
array [object {3}] 
标签列表
必需
ext_id
string 
客户extid
必需
first_join_package_time
string 
首次加入包的时间
必需
gender
integer 
性别 0-未知 1-男性 2-女性
必需
name
string 
名称
必需
phone_list
array[string]
手机号列表
必需
unionid
string 
wx_unionid
必需
package_data
object 
人群包数据
必需
corp_id
string 
公司id
必需
created_at
integer 
创建时间
必需
creator_id
integer 
创建人id
必需
data_update_time
integer 
最近更新时间
必需
department_ext_id_list
array[string]
所属部门列表
必需
description
string 
描述
必需
filter_type
string 
触发类型: all全部客户 filter筛选客户,import导入客户,openApi接口导入
必需
id
integer 
人群包id
必需
name
string 
名称
必需
staff_ext_id_list
array[string]
所属成员列表
必需
update_type
string 
更新类型, auto自动更新, manual手动
必需
page_no
integer 
页码数
必需
page_size
integer 
每页数量
必需
status_code
integer 
必需
status_message
string 
必需
success
boolean 
必需
total_count
integer 
总数
必需
示例
{
    "has_next": false,
    "objects": [
        {
            "avatar": "http://wx.qlogo.cn/mmhead/SYeWkon6C6JJribicsOwZKAKa52WjRcfkOOnicTicpwPWibctT99JFqc1Hw/0",
            "belong_staff_list": [
                {
                    "address": "",
                    "alias": "",
                    "avatar": "https://wework.qpic.cn/wwpic/627597_LS7mN2N5SZ-tIgF_1666315478/0",
                    "corp_id": "1703429757388935169",
                    "created_at": 1625124049,
                    "email": "",
                    "enable": true,
                    "english_name": "",
                    "ext_id": "YanWenGang",
                    "extattr": "{\"attrs\": []}",
                    "external_contact_able": true,
                    "external_position": null,
                    "external_profile":"{\"external_attr\": [{\"type\": 1, \"name\": \"\朋 \友 \圈\", \"web\": {\"url\": \"https://bpwwerkpol.af.wb.miemie.la/api/moment/trace/entry?encrypt_content=11824016ACDFD0F879FB16D18F88FF7AEA27D540DA3E00BCD7BAA52D8C446B27\", \"title\": \"\朋 \友 \圈\"}}, {\"type\": 1, \"name\": \"\个\人\名\片\", \"web\": {\"url\": \"https://dev.weibanzhushou.com/api/bizcard/entry?_c=X1BvUFtASWgHBwEJVl5sVl5ESQ&query_token=4i2Nnf7N0b6poMnskMnI7QHQ4Qno7RXg3SHk9Q3Y1RnomPGEmg7VldqdjeaUmSmEmQXc8SXgmjUDD\", \"title\": \"\个\人\名\片\"}}, {\"type\": 1, \"name\": \"\智\能\名\片\", \"web\": {\"url\": \"https://dev.weibanzhushou.com/api/bizcard/entry?_c=X1BvUFtASWgHBwEJVl5sVl5ESQ&query_token=4i2Nnf7N0b6poMnskMnI7QHQ4Qno7RXg3SHk9Q3Y1RnomPGEmg7VldqdjeaUmSmEmQXc8SXgmjUDD\", \"title\": \"\智\能\名\片\"}}]}",
                    "external_user_count": 4,
                    "gender": 1,
                    "ia_authorized": true,
                    "ia_authorized_at": 1669893646,
                    "ia_ext_id": "YanWenGang",
                    "id": 16897,
                    "is_root": false,
                    "ma_authorized": true,
                    "ma_authorized_at": 1684410105,
                    "mobile": "13997574969",
                    "moment_address": null,
                    "moment_cover": null,
                    "name": "颜文港",
                    "new_ext_id": null,
                    "oa_authorized": true,
                    "oa_authorized_at": 1669893679,
                    "oa_ext_id": "wogizUDQAAq5s37qwNIFIIxTItuRlgbQ",
                    "openid": null,
                    "position": "",
                    "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vc557480efbeba208b",
                    "signature": "",
                    "status": 1,
                    "telephone": "",
                    "unionid": null,
                    "updated_at": 1687833144,
                    "user_id": null,
                    "usertype": 5
                }
            ],
            "corp_full_name": null,
            "corp_id": "1703429757388935169",
            "corp_name": null,
            "created_at": 1625139028,
            "eu_dep_path_v2_list": [
                {
                    "dept_full_name": "点石互动",
                    "dept_name": "点石互动"
                }
            ],
            "eu_tag_list": [],
            "ext_id": "wmeo9iCwAAVGRgIEP6GVGFCB4K8El4ew",
            "external_profile": "null",
            "first_join_package_time": "2023-05-19 14:22:31",
            "gender": 1,
            "id": 7041,
            "name": "X.L",
            "oa_ext_id": "wmgizUDQAA8IVgaxpuW_ThxTVVgCXbcg",
            "oa_unionid": null,
            "organization_correlation_time": null,
            "organization_id": null,
            "phone_list": [
                "17512121212"
            ],
            "position": null,
            "score": 2390,
            "tags": [],
            "type": 1,
            "unionid": "otrNdt5lHi0NlO-SCKwOHh4loHL0",
            "updated_at": 1682477872
        },
        {
            "avatar": "http://wx.qlogo.cn/mmhead/Q3auHgzwzM6Z0ic0uV9YmQroKL3sDn8mjT97gn3bSDBWHHExsXct2ow/0",
            "belong_staff_list": [
                {
                    "address": "",
                    "alias": "",
                    "avatar": "https://wework.qpic.cn/wwpic/627597_LS7mN2N5SZ-tIgF_1666315478/0",
                    "corp_id": "1703429757388935169",
                    "created_at": 1625124049,
                    "email": "",
                    "enable": true,
                    "english_name": "",
                    "ext_id": "YanWenGang",
                    "extattr": "{\"attrs\": []}",
                    "external_contact_able": true,
                    "external_position": null,
                    "external_profile":"{\"external_attr\": [{\"type\": 1, \"name\": \"\朋 \友 \圈\", \"web\": {\"url\": \"https://bpwwerkpol.af.wb.miemie.la/api/moment/trace/entry?encrypt_content=11824016ACDFD0F879FB16D18F88FF7AEA27D540DA3E00BCD7BAA52D8C446B27\", \"title\": \"\朋 \友 \圈\"}}, {\"type\": 1, \"name\": \"\个\人\名\片\", \"web\": {\"url\": \"https://dev.weibanzhushou.com/api/bizcard/entry?_c=X1BvUFtASWgHBwEJVl5sVl5ESQ&query_token=4i2Nnf7N0b6poMnskMnI7QHQ4Qno7RXg3SHk9Q3Y1RnomPGEmg7VldqdjeaUmSmEmQXc8SXgmjUDD\", \"title\": \"\个\人\名\片\"}}, {\"type\": 1, \"name\": \"\智\能\名\片\", \"web\": {\"url\": \"https://dev.weibanzhushou.com/api/bizcard/entry?_c=X1BvUFtASWgHBwEJVl5sVl5ESQ&query_token=4i2Nnf7N0b6poMnskMnI7QHQ4Qno7RXg3SHk9Q3Y1RnomPGEmg7VldqdjeaUmSmEmQXc8SXgmjUDD\", \"title\": \"\智\能\名\片\"}}]}",
                    "external_user_count": 4,
                    "gender": 1,
                    "ia_authorized": true,
                    "ia_authorized_at": 1669893646,
                    "ia_ext_id": "YanWenGang",
                    "id": 16897,
                    "is_root": false,
                    "ma_authorized": true,
                    "ma_authorized_at": 1684410105,
                    "mobile": "13997574969",
                    "moment_address": null,
                    "moment_cover": null,
                    "name": "颜文港",
                    "new_ext_id": null,
                    "oa_authorized": true,
                    "oa_authorized_at": 1669893679,
                    "oa_ext_id": "wogizUDQAAq5s37qwNIFIIxTItuRlgbQ",
                    "openid": null,
                    "position": "",
                    "qr_code": "https://open.work.weixin.qq.com/wwopen/userQRCode?vcode=vc557480efbeba208b",
                    "signature": "",
                    "status": 1,
                    "telephone": "",
                    "unionid": null,
                    "updated_at": 1687833144,
                    "user_id": null,
                    "usertype": 5
                }
            ],
            "corp_full_name": null,
            "corp_id": "1703429757388935169",
            "corp_name": null,
            "created_at": 1635818918,
            "eu_dep_path_v2_list": [
                {
                    "dept_full_name": "点石互动",
                    "dept_name": "点石互动"
                }
            ],
            "eu_tag_list": [
                {
                    "id": 1001672750,
                    "name": "dd",
                    "tag_type": 1
                },
                {
                    "id": 1002714738,
                    "name": "老客户标签1",
                    "tag_type": 1
                },
                {
                    "id": 1001972742,
                    "name": "测试标签84i",
                    "tag_type": 1
                },
                {
                    "id": 3000356415,
                    "name": "预打标签",
                    "tag_type": 1
                },
                {
                    "id": 3000356405,
                    "name": "热",
                    "tag_type": 1
                },
                {
                    "id": 1001492740,
                    "name": "饭团",
                    "tag_type": 1
                },
                {
                    "id": 1002152901,
                    "name": "1",
                    "tag_type": 1
                },
                {
                    "id": 3000356417,
                    "name": "修改后2",
                    "tag_type": 1
                },
                {
                    "id": 3000356416,
                    "name": "与打标签123",
                    "tag_type": 1
                }
            ],
            "ext_id": "wmeo9iCwAA8gUSj64o7yqDJ2aFJuoVeg",
            "external_profile": "null",
            "first_join_package_time": "2023-05-19 14:22:31",
            "gender": 1,
            "id": 1000785202,
            "name": "🍁",
            "oa_ext_id": "wmgizUDQAAdlFGc09DwY6I_sJszDj24A",
            "oa_unionid": null,
            "organization_correlation_time": 1658469964,
            "organization_id": 1050025,
            "phone_list": [
                "13669342496"
            ],
            "position": null,
            "score": 2284,
            "tags": [
                {
                    "id": 1001672750,
                    "name": "dd",
                    "tag_type": 1
                },
                {
                    "id": 1002714738,
                    "name": "老客户标签1",
                    "tag_type": 1
                },
                {
                    "id": 1001972742,
                    "name": "测试标签84i",
                    "tag_type": 1
                },
                {
                    "id": 3000356415,
                    "name": "预打标签",
                    "tag_type": 1
                },
                {
                    "id": 3000356405,
                    "name": "热",
                    "tag_type": 1
                },
                {
                    "id": 1001492740,
                    "name": "饭团",
                    "tag_type": 1
                },
                {
                    "id": 1002152901,
                    "name": "1",
                    "tag_type": 1
                },
                {
                    "id": 3000356417,
                    "name": "修改后2",
                    "tag_type": 1
                },
                {
                    "id": 3000356416,
                    "name": "与打标签123",
                    "tag_type": 1
                }
            ],
            "type": 1,
            "unionid": "otrNdt9wZGwuF3qss3zJKb3tHVsU",
            "updated_at": 1685609107
        }
    ],
    "package_data": {
        "corp_id": "1703429757388935169",
        "created_at": 1684477340,
        "creator_id": 16897,
        "data_update_time": 1684477341,
        "deleted": false,
        "department_ext_id_list": [],
        "description": "11111",
        "filter_type": "filter",
        "id": 277,
        "name": "sop群发测试",
        "staff_ext_id_list": [
            "YanWenGang"
        ],
        "update_type": "auto",
        "updated_at": 1684477351
    },
    "page_no": 1,
    "page_size": 20,
    "status_code": 200,
    "status_message": "ok",
    "success": true,
    "total_count": 7
}
🟢200正常返回
上一页
创建的人群包中添加数据
下一页
客户群发创建
Built with