【企业微信】基于iPad协议的联系人管理接口：支持内外部联系人操作与多渠道添加功能

一、简要总结本文档是企业微信 iPad 协议接口的联系人模块功能说明共包含20 个细分操作接口所有接口统一采用POST请求、ContentType:application/json格式uuid 为唯一必传核心参数服务域名以[172.0.0.18083](172.0.0.18083)为主、少量为[127.0.0.1:8083](127.0.0.1:8083)接口覆盖内部 / 外部联系人管理、好友申请处理、备注 / 会话设置、多渠道添加好友、联系人共享、互联企业 / 企业互联数据拉取全场景支持seq/strSeq 分页、批量查询、拉黑 / 取消拉黑等核心能力。思维导图官网地址极客互动企业微信聚合聊天企业微信API接口API调用企业微信API接入文档四、详细总结一通用核心规范核心项关键信息请求方式POST数据格式application/json必传参数uuid实例唯一标识分页参数seq/strSeq分页下标、limit单次返回数量服务域名主域名[172.0.0.18083](172.0.0.18083)本地域名[127.0.0.1:8083](127.0.0.1:8083)成功返回errcode0、errmsgok二基础联系人操作1.8.1-1.8.16联系人列表获取1.8.1获取内部联系人列表支持分页拉取企业内部员工 部门数据1.8.2获取外部联系人列表分页拉取外部客户返回status标识好友状态1.8.6获取好友申请列表分页查询待处理好友申请item_flag3为删除申请1.8.11获取内部联系人备注列表分页拉取内部同事备注信息1.8.7/1.8.8获取会话 / 标记列表查询置顶、免打扰、折叠、星星标记会话联系人信息操作1.8.3根据 vid 批量获取详情支持多用户 id 一次性查询信息1.8.4同意好友通过回调 vid 处理好友申请1.8.5删除联系人传入 vid 直接删除联系人1.8.9/1.8.10修改备注分别支持外部 / 内部联系人备注、手机、企业、简介修改会话与权限设置1.8.12置顶设置state0 取消 / 1 设置区分好友 / 群聊1.8.13免打扰设置state0 取消 / 1 设置1.8.14免打扰 折叠state0 取消 / 1 设置1.8.15星星标记state0 取消 / 1 设置1.8.16拉黑 / 移除拉黑type1 拉黑 / 2 移除拉黑后外部联系人status8三联系人添加方式1.8.17共5 种添加渠道覆盖全场景加好友[1.8.17.1](1.8.17.1)手机号搜索输入手机号检索企微 / 个微用户[1.8.17.2](1.8.17.2)搜索添加外部联系人基于搜索结果添加外部客户[1.8.17.3](1.8.17.3)搜索添加企微用户定向添加企业微信内部员工[1.8.17.4](1.8.17.4)名片添加通过推荐人 id 名片添加好友[1.8.17.5](1.8.17.5)直接添加好友仅适用于被删除过的联系人四联系人共享操作1.8.18[1.8.18.1](1.8.18.1)共享联系人将外部客户共享给指定同事账号[1.8.18.2](1.8.18.2)添加共享联系人接收同事共享的客户并发送申请五互联企业 / 企业互联1.8.19-1.8.20互联网企业1.8.19先调用getCircleIds获取互联企业 ID再通过GetHuLianInnerContacts拉取互联企业部门 成员企业互联1.8.20先调用getGroupIds获取互联组 ID再通过getGroupChangeData拉取组内企业、部门、成员node_type1 用户 / 2 部门 / 3 企业六关键状态标识外部联系人status0 互相删除、8 主动拉黑、2049 被删除、其余为正常好友消息类型messagetype0 好友、1 群聊、3 应用、6 开放平台好友申请item_flag3 为已删除申请四、技术特点特性说明通信协议HTTP JSON请求方式POSTContent-Typeapplication/json认证机制使用uuid唯一标识实例绑定特定企业微信账户分页机制多数接口使用limitseq序列号实现增量加载返回格式统一结构{ errcode: 0, errmsg: ok, data: ... }五、应用场景建议场景可用接口客户管理系统集成获取外部联系人、修改备注、标签、拉黑自动化营销工具搜索添加客户、发送验证消息、共享客户团队协作平台共享联系人、获取内部联系人、互联企业同步IM 功能增强置顶、免打扰、折叠、星标等会话管理数据分析后台批量拉取用户信息、统计部门结构六、关键问题与答案问题 1该模块接口的核心必传参数是什么作用是什么答案核心必传参数是uuid它是每个企业微信实例的唯一标识接口通过 uuid 定位到具体的企业微信账号完成对应账号的联系人操作。问题 2外部联系人的status 状态码分别代表什么好友关系答案0互相删除好友8主动删除 / 拉黑对方2049被对方删除其他数值正常好友关系问题 3接口支持的联系人添加方式有哪几种各有什么适用场景答案共 5 种添加方式适用场景如下手机号搜索添加已知对方手机号检索并添加企微 / 个微用户搜索添加外部 / 企微用户定向添加外部客户或企业内部员工名片添加通过他人分享的名片添加好友直接添加仅适用于曾被删除过的联系人无需重新申请