跳至正文
Wener Notes

企业微信

约 2 分钟阅读
  • 应用类型
    • 基础应用 - 内置
    • 第三方应用
    • 自建应用
    • 硬件开发
    • 服务商
  • 参考
  • 企业微信会话存档保存最长为 90 天
  • 成员
    • ID - 1-64 [[email protected]]{1,64}
      • 唯一检查忽略大小写
    • 名称/别名 1-64 utf8 字符
    • 职位、地址 0-128
    • 性别 1表示男性，2表示女性
    • 所属部门最多 100 个
  • 部门
    • 跟部门 1
    • ID int32
    • 名称 - 1-64 utf8 字符, 不包含 \:*?"<>｜
    • 最大层级 15 层
    • 总数最多 3 万个
    • 部门下下节点最多 3 万个
  • 标签
    • 关联应用，是应用维度维护
    • 成员修改需要使用对应应用来进行操作
  • access_token 是全局的，不能返回到前端
  • 授权认证时的 code 只是使用 access_token 去 校验 而不是为用户换取属于用户的 access_token
  • 默认 scope 为 snsapi_base

获取企业信息

  • 创建 成员/部门
    • 使用 通讯录同步, 第三方通讯录应用 操作
  • 获取 成员/部门 ID
    • 使用 企业管理后台 - 管理工具 - 通讯录同步 应用进行获取, 能批量获取
    • /cgi-bin/user/list_id
    • /cgi-bin/department/simplelist
  • 成员详情 - 用户名
    • 不能 使用 通讯录同步 应用获取
    • 使用 自建应用, 服务商代开发应用, 第三方应用, 第三方通讯录应用
    • 读取成员 /cgi-bin/user/get
    • 获取部门成员 /cgi-bin/user/simplelist
    • 获取部门成员详情 /cgi-bin/user/list
    • 获取部门列表 /cgi-bin/department/list
  • 成员详情 - 头像、性别、手机、邮箱、企业邮箱、员工个人二维码、地址
    • oauth2 手工授权
  • 客户
    • 配置 客户联系 可调用应用

授权

  • 非标准 OAuth2
  • access_token 是全局
    • 默认 7200s
  • 换 token 需要 appid 和 agentid
  • code 只能用一次

网页授权

text
https://open.weixin.qq.com/connect/oauth2/authorize?
  appid=wx10101&
  response_type=code&
  scope=snsapi_base&
  redirect_uri=https%3A%2F%2Ftest.example.com%3A3000%2Fapi%2Fmyredirect
  #wechat_redirect
text
https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?
  access_token=ACCESS_TOKEN&
  code=CODE

Web 扫码授权登录

text
https://open.work.weixin.qq.com/wwopen/sso/qrConnect?
  appid=wx10101&
  agentid=1000000&
  redirect_uri=https%3A%2F%2Ftest.example.com%3A3000%2Fapi%2Fmyredirect
text
https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?
  access_token=ACCESS_TOKEN&
  code=CODE

FAQ

redirect_uri 与配置的授权完成回调域名不一致

配置 Web 授权回调域名

关联信息

反向链接、本文链接的其他页面和外部资料。

站内链接

  • 会话内容存档
    笔记 · 会话存档

    会话存档保存 5 天 · 从 Sequence+1 拉取，不包含 Sequence · GetChat limit 最大 1000 · 图片 jpg, 音频 amr, 视频 mp4 · 可能存在 MD5 为空字符串 · MediaData 的 MD5 可能匹配不上，可以多次重试

  • 企业微信 Inside
    笔记 · 内部结构分析

    安全边界：只整理目录、文件类型、DB 名称、存储分层与文件头特征；不要写入聊天内容、联系人明文、密钥、token、真实用户目录、企业名、账号 ID、profile hash。示例统一使用 、、 脱敏。 · 企业微信桌面端与微信 4.x 的 统一账号结构不同：企业微信仍保留更明显的 WXWork / Profiles / Data / CEF / WeD...

参考资料

其他外链4 条
最近更新commit be2511e编辑

Wechaty

上一页

会话内容存档

下一页