接口要点
外部联系人相关能力依赖实例 uuid(每个 iPad 企微实例唯一标识)。分页拉取常用参数:
uuid:必选,操作目标实例limit:每页返回数量seq:查询下标,首次填 0,之后填返回的 seq 继续翻页
请求示例
{
"uuid": "3240fde0-45e2-48c0-90e8-cb098d0ebe43",
"limit": 100,
"seq": 0
}
返回字段解读(节选)
user_id/nickname/avatar:客户基础信息sex:性别;mobile/remark_phone:手机相关labelid:标签 ID 列表source/source_info:添加来源与来源详情(如 source_roomid)add_customer_time:添加时间戳status:0 互相删除;8 主动删除拉黑;2049 被删除;其他多为好友状态seq:下一页游标
成功时 errcode=0,errmsg=ok。
好友 / 联系人相关能力清单
协议侧已覆盖企微常用联系人能力,开发时可按场景组合:
- 查询:外部/内部联系人列表、指定好友详情、公司信息、个人二维码、部门列表等
- 添加:手机号查询微信信息、查询添加个微/企微联系人、名片好友、接受好友申请
- 维护:修改内外部备注/描述/手机号列表/公司名称、删除客户联系人
与周边模块协作
- 登录成功后再拉联系人;掉线可用自动登录恢复
- 群发/私聊前用列表拿到
user_id作为send_userid - 标签接口可批量打标,配合外部联系人列表做分层运营
更完整的添加外部联系人、同意好友等接口路径与字段,请以 正式 API 文档 为准。技术支持微信:Mrzhu0107 · 联系报备。