返回上一级 最佳实践

企业微信 iPad 协议接口开发:企微添加外部联系人

外部联系人 好友操作 · 列表分页 技术支持:Mrzhu0107
外部联系人接口请求与返回示例示意

接口要点

外部联系人相关能力依赖实例 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=0errmsg=ok

好友 / 联系人相关能力清单

协议侧已覆盖企微常用联系人能力,开发时可按场景组合:

  • 查询:外部/内部联系人列表、指定好友详情、公司信息、个人二维码、部门列表等
  • 添加:手机号查询微信信息、查询添加个微/企微联系人、名片好友、接受好友申请
  • 维护:修改内外部备注/描述/手机号列表/公司名称、删除客户联系人

与周边模块协作

  • 登录成功后再拉联系人;掉线可用自动登录恢复
  • 群发/私聊前用列表拿到 user_id 作为 send_userid
  • 标签接口可批量打标,配合外部联系人列表做分层运营

更完整的添加外部联系人、同意好友等接口路径与字段,请以 正式 API 文档 为准。技术支持微信:Mrzhu0107 · 联系报备