{"id":13600318,"url":"https://github.com/go-laoji/wecom-go-sdk","last_synced_at":"2026-01-17T22:33:57.664Z","repository":{"id":47797759,"uuid":"438639275","full_name":"go-laoji/wecom-go-sdk","owner":"go-laoji","description":"企业微信第三方应用|自建代开发|自建应用 三合一 sdk golang版;支持服务商应用运营体系","archived":false,"fork":false,"pushed_at":"2024-09-24T01:59:48.000Z","size":354,"stargazers_count":79,"open_issues_count":3,"forks_count":15,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2025-08-09T21:38:25.973Z","etag":null,"topics":["golang","qywork","qywx","sdk","sdk-go","wecom","wework","workweixin","workwx","wxwork"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/go-laoji.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-12-15T13:26:21.000Z","updated_at":"2025-06-02T05:25:35.000Z","dependencies_parsed_at":"2024-08-26T11:44:15.107Z","dependency_job_id":"a3df8968-4416-4b54-91c8-1f1c291593e1","html_url":"https://github.com/go-laoji/wecom-go-sdk","commit_stats":null,"previous_names":["go-laoji/wework"],"tags_count":39,"template":false,"template_full_name":null,"purl":"pkg:github/go-laoji/wecom-go-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-laoji%2Fwecom-go-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-laoji%2Fwecom-go-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-laoji%2Fwecom-go-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-laoji%2Fwecom-go-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/go-laoji","download_url":"https://codeload.github.com/go-laoji/wecom-go-sdk/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/go-laoji%2Fwecom-go-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28521044,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T22:11:28.393Z","status":"ssl_error","status_checked_at":"2026-01-17T22:11:27.841Z","response_time":85,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["golang","qywork","qywx","sdk","sdk-go","wecom","wework","workweixin","workwx","wxwork"],"created_at":"2024-08-01T18:00:35.964Z","updated_at":"2026-01-17T22:33:52.656Z","avatar_url":"https://github.com/go-laoji.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\n版本变更日志参见 [`CHANGELOG.md`](CHANGELOG.md)\n\n[![JetBrains Logo (Main) logo](https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.svg \"logo\")](https://jb.gg/OpenSourceSupport)\n\n`更多相关文章将会在公众号分享，欢迎关注！`\n\n![Geek进阶](./qrcode.png)\n\n# 文档\n\n[使用wecom-go-sdk快速开发企业微信自建应用](https://mp.weixin.qq.com/s?__biz=Mzg5NTcyOTk1OA==\u0026mid=2247483782\u0026idx=1\u0026sn=84345385511ca981c47b55f7ae24b81c)\n\n# V2版本升级\n\nhttp请求改用`go-resty`可方便指定重试、错误处理hooks(当前未处理)\n\n## 使用\n\n    go get github.com/go-laoji/wecom-go-sdk/v2\n\n* 增加SetProxy(proxyUrl string) 对绕过IP限制有用,可参考[OpenResty(nginx)配置正向代理绕过企微自建IP限制](https://mp.weixin.qq.com/s/ZDUZyIaz3HOsrqRUQx8w-w)\n* 增加SetDebug(debug bool) 可以监控http请求,看如下的输出\n\n\n    ~~~ REQUEST ~~~\n    GET  /cgi-bin/gettoken?corpid=wp0k1qEQAAiwQMWYzF8JOr99RJRX1_1A\u0026corpsecret=Y2YbFpt95RcGTs9CvriQ2uj23Wl8B3IxtbRM9nKfjVU  HTTP/1.1\n    HOST   : qyapi.weixin.qq.com\n    HEADERS:\n        Accept: application/json;charset=UTF-8\n        Content-Type: application/json;charset=UTF-8\n        User-Agent: wecom-go-sdk-v2\n    BODY   :\n    ***** NO CONTENT *****\n    ------------------------------------------------------------------------------\n    ~~~ RESPONSE ~~~\n    STATUS       : 200 OK\n    PROTO        : HTTP/2.0\n    RECEIVED AT  : 2023-06-10T21:03:57.834584+08:00\n    TIME DURATION: 181.642531ms\n    HEADERS      :\n        Content-Length: 176\n        Content-Type: application/json; charset=UTF-8\n        Date: Sat, 10 Jun 2023 13:03:58 GMT\n        Error-Code: 40001\n        Error-Msg: invalid credential, hint: [1686402237354962763423746], from ip: 123.116.182.237, more info at https://open.work.weixin.qq.com/devtool/query?e=40001\n        Server: nginx\n    BODY         :\n    {\n       \"errcode\": 40001,\n       \"errmsg\": \"invalid credential, hint: [1686402237354962763423746], from ip: 123.116.182.237, more info at https://open.work.weixin.qq.com/devtool/query?e=40001\"\n    }\n    ==============================================================================\n\n\n## 配置文件格式\n\n    CorpId: wwxxx\n    ProviderSecret: xxxxxxx\n    SuiteId: xxxxx\n    SuiteSecret: xxxxx-Gl8VA\n    SuiteToken: xxxxx\n    SuiteEncodingAesKey: xxxx\n    Dsn: user:pass@tcp(127.0.0.1:3306)/suite?charset=utf8mb4\u0026parseTime=True\u0026loc=Local\n    Port: 8080\n\n## 　目录结构\n    \n    ├── config  解析yaml配置文件\n    ├── example　样例程序\n    ├── internal　内部函数，包含error和http请求\n    └── pkg 附加包\n        └── svr 服务端接口部分\n            ├── callback　指令及数据回调\n            ├── install 应用安装连接生成、应用安装后的跳转\n            ├── logic　各事件通知处理逻辑\n            ├── middleware　gin的中间件方便handler里引入sdk\n            └── models  应用安装时常用到的表定义,基于gorm\n\n## 第三方包\n\n- [github.com/dgraph-io/badger/v3 v3.2103.5](https://github.com/dgraph-io/badger) 一个KeyValue数据库,类redis\n- [github.com/gin-gonic/gin  v1.9.1](https://github.com/gin-gonic/gin) web框架\n- [github.com/go-laoji/wxbizmsgcrypt v1.0.0](https://github.com/go-laoji/wxbizmsgcrypt) 微信数据加解密\n- [github.com/jinzhu/copier v0.3.5](https://github.com/jinzhu/copier) jinzhu大神的数据拷贝库\n- [go.uber.org/zap v1.24.0](https://go.uber.org/zap) 日志库\n- [gopkg.in/natefinch/lumberjack.v2 v2.2.1](https://gopkg.in/natefinch/lumberjack.v2) 日志切割\n- [gopkg.in/yaml.v2 v2.4.0](https://gopkg.in/yaml.v2) yaml解析\n- [gorm.io/driver/mysql v1.5.1](https://gorm.io/driver/mysql) 同属jinzhu大神的mysql驱动\n- [gorm.io/gorm v1.25.1](https://gorm.io/gorm) 同属jinzhu大神的orm库\n\n## API列表\n\n- ID转换接口\n  - [x] corpid的转换\n  - [x] userid的转换\n  - [x] external_userid的转换\n  - [x] 客户标签ID的转换\n  - [x] 微信客服ID的转换\n- 身份验证\n  - 网页授权登录\n    - [x] 获取访问用户身份\n    - [x] 获取访问用户敏感信息\n  - 扫码授权登录\n    - [x] 获取登录用户信息\n- 应用授权\n  - [x] 调用第三方应用凭证\n  - [x] 获取预授权码\n  - [ ] 设置授权配置\n  - [x] 获取企业永久授权码\n  - [x] 获取企业授权信息\n  - [x] 获取企业凭证　~~getCorpToken~~(存入数据库以主键代替)\n  - [x] 获取应用的管理员列表\n  - [x] 获取应用二维码\n  - [x] 回调接口~~pkg下svr使用gin框架的web接口~~\n    - [x] 推送suite_ticket\n    - [x] 授权通知事件 *此部分与业务逻辑相关，仅做样例*\n      - [x] 授权成功通知\n      - [ ] 变更授权通知\n      - [ ] 取消授权通知\n    - [ ] 成员通知事件\n    - [ ] 部门通知事件\n    - [ ] 标签通知事件\n    - [ ] 共享应用事件回调\n    - [ ] 应用管理员变更回调\n- [x] 通讯录管理\n  - [x] 成员管理\n    - [x] 创建成员\n    - [x] 读取成员\n    - [x] 更新成员\n    - [x] 删除成员\n    - [x] 获取部门成员\n    - [x] 获取部门成员详情\n    - [x] userid与openid互换\n    - [ ] 二次验证\n    - [ ] 邀请成员\n    - [x] 手机号获取userid\n    - [x] 获取成员授权列表\n    - [x] 查询成员用户是否已授权\n    - [x] 获取选人ticket对应的用户\n    - [x] 自建应用获取用户隐私信息\n    - [x] 获取成员ID列表\n  - [x] 部门管理\n    - [x] 创建部门\n    - [x] 更新部门\n    - [x] 删除部门\n    - [x] 获取部门列表\n    - [x] 获取子部门ID列表\n    - [x] 获取单个部门详情\n  - [x] 标签管理\n    - [x] 创建标签\n    - [x] 更新标签名字\n    - [x] 删除标签\n    - [x] 获取标签成员\n    - [x] 增加标签成员\n    - [x] 删除标签成员\n    - [x] 获取标签列表\n  - [ ] 异步批量接口\n  - [ ] 通讯录回调通知\n  - [ ] 通讯录搜索\n  - [ ] 通讯录ID转译\n  - [ ] 通讯录userid排序\n  - [ ] 异步导出接口\n  - [ ] 推广二维码\n- [x] 客户联系\n  - [x] 获取配置了客户联系功能的成员列表\n  - [x] 客户联系「联系我」管理\n    - [x] 配置客户联系「联系我」方式\n    - [x] 获取企业已配置的「联系我」方式\n    - [x] 获取企业已配置的「联系我」列表\n    - [x] 更新企业已配置的「联系我」方式\n    - [x] 删除企业已配置的「联系我」方式\n    - [x] 结束临时会话\n  - [x] 客户管理\n    - [x] 获取客户列表\n    - [x] 获取客户详情\n    - [x] 批量获取客户详情\n    - [x] 修改客户备注信息\n    - [x] 外部联系人unionid转换\n    - [x] 代开发应用external_userid转换\n  - [x] 客户标签管理\n    - [x] 管理企业标签\n      - [x] 获取企业标签库\n      - [x] 添加企业客户标签\n      - [x] 编辑企业客户标签\n      - [x] 删除企业客户标签\n    - [x] 编辑客户企业标签\n  - [x] 在职继承\n    - [x] 分配在职成员的客户\n    - [x] 查询客户接替状态\n  - [x] 离职继承\n    - [x] 获取待分配的离职成员列表\n    - [x] 分配离职成员的客户\n    - [x] 查询客户接替状态\n    - [x] 分配离职成员的客户群\n  - [x] 客户群管理\n    - [x] 获取客户群列表\n    - [x] 获取客户群详情\n    - [x] 客户群opengid转换\n  - [x] 客户朋友圈\n    - [x] 企业发表内容到客户的朋友圈\n      - [x] 创建发表任务\n      - [x] 获取任务创建结果\n    - [x] 获取客户朋友圈全部的发表记录\n      - [x] 获取企业全部的发表列表\n      - [x] 获取客户朋友圈企业发表的列表\n      - [x] 获取客户朋友圈发表时选择的可见范围\n      - [x] 获取客户朋友圈发表后的可见客户列表\n      - [x] 获取客户朋友圈的互动数据\n  - [x] 消息推送\n    - [x] 创建企业群发\n    - [x] 获取企业的全部群发记录\n      - [x] 获取群发记录列表\n      - [x] 获取群发成员发送任务列表\n      - [x] 获取企业群发成员执行结果\n    - [x] 发送新客户欢迎语\n    - [x] 入群欢迎语素材管理\n  - [x] 统计管理\n    - [x] 获取「联系客户统计」数据\n    - [x] 获取「群聊数据统计」数据\n      - [x] 按群主聚合的方式\n      - [x] 按自然日聚合的方式\n  - [ ] 变更回调\n    - [ ] 添加企业客户事件\n    - [ ] 编辑企业客户事件\n    - [ ] 外部联系人免验证添加成员事件\n    - [ ] 删除企业客户事件\n    - [ ] 删除跟进成员事件\n    - [ ] 客户接替失败事件\n    - [ ] 客户群创建事件\n    - [ ] 客户群变更事件\n    - [ ] 客户群解散事件\n    - [ ] 企业客户标签创建事件\n    - [ ] 企业客户标签变更事件\n    - [ ] 企业客户标签删除事件\n    - [ ] 企业客户标签重排事件\n  - [x] 管理商品图册\n    - [x] 创建商品图册\n    - [x] 获取商品图册\n    - [x] 获取商品图册列表\n    - [x] 编辑商品图册\n    - [x] 删除商品图册\n  - [x] 管理聊天敏感词 \n    - [x] 新建敏感词规则\n    - [x] 获取敏感词规则列表\n    - [x] 获取敏感词规则详情\n    - [x] 修改敏感词规则\n    - [x] 删除敏感词规则\n  - [x] 上传附件资源\n- [x] 微信客服\n  - [x] 客服帐号管理\n    - [x] 添加客服帐号\n    - [x] 删除客服帐号\n    - [x] 修改客服帐号\n    - [x] 获取客服帐号列表\n    - [x] 获取客服帐号连接\n  - [x] 接待人员管理\n    - [x] 添加接待人员\n    - [x] 删除接待人员\n    - [x] 获取接待人员列表\n  - [x] 会话分配与消息收发\n    - [x] 分配客服会话\n    - [ ] 接收消息和事件\n      - [x] 读取消息\n    - [x] 发送消息\n    - [x] 发送欢迎语等事件响应消息\n  - [x] [升级服务]配置\n  - [x] 其它基础信息获取\n    - [x] 获取客户基础信息\n    - [x] 获取企业状态信息\n  - [x] 统计管理\n    - [x] 获取「客户数据统计」企业汇总数据\n    - [x] 获取「客户数据统计」接待人员明细数据\n  - [x] 机器人管理\n    - [x] 知识库分组管理\n      - [x] 添加分组\n      - [x] 删除分组\n      - [x] 修改分组\n      - [x] 获取分组列表\n- [x] 接口调用许可\n  - [x] 订单管理\n    - [x] 下单购买帐号\n    - [x] 下单续期帐号\n    - [x] 获取订单列表\n    - [x] 获取订单详情\n    - [x] 获取订单中的帐号列表\n  - [x] 帐号管理\n    - [x] 激活帐号\n    - [x] 获取激活码详情\n    - [x] 获取企业的帐号列表\n    - [x] 获取成员的激活详情\n    - [x] 帐号继承\n  - [x] 自动激活设置\n    - [x] 设置企业的许可自动激活状态\n    - [x] 查询企业的许可自动激活状态\n- [x] 应用管理\n  - [x] 获取应用\n    - [x] 获取指定的应用详情\n    - [x] 获取access_token对应的应用列表\n  - [ ] 设置工作台自定义展示\n- [x] 消息推送\n  - [x] 发送应用消息\n  - [x] 发送应用模板消息\n  - [x] 更新应用模板消息\n  - [ ] 接收消息与事件\n  - [x] 撤回应用消息\n- [x] 素材管理\n  - [x] 上传临时素材\n  - [x] 上传图片\n  - [x] 获取临时素材\n  - [ ] 获取高清语音素材\n- [x] 会话内容存档\n  - [x] 获取会话内容存档开启成员列表\n  - [x] 获取会话同意情况\n  - [x] 获取会话内容存档内部群信息\n- [x] 电子发票\n  - [x] 查询电子发票\n  - [x] 更新发票状态\n  - [x] 批量更新发票状态\n  - [x] 批量查询电子发票\n- [x] 学校沟通\n  - [x] 基础接口\n    - [x] 获取「学校通知」二维码\n    - [x] 管理「学校通知」的关注模式\n      - [x] 设置关注「学校通知」的模式\n      - [x] 获取关注「学校通知」的模式\n    - [ ] 发送「学校通知」\n    - [x] 手机号转外部联系人ID\n    - [x] 管理「老师可查看班级」模式\n      - [x] 设置「老师可查看班级」的模式\n      - [x] 获取「老师可查看班级」的模式\n    - [x] 获取可使用的家长范围\n  - [x] 学生与家长管理\n    - [x] 创建学生\n    - [x] 删除学生\n    - [x] 更新学生\n    - [x] 批量创建学生\n    - [x] 批量删除学生\n    - [x] 批量更新学生\n    - [x] 创建家长\n    - [x] 删除家长\n    - [x] 更新家长\n    - [x] 批量创建家长\n    - [x] 批量删除家长\n    - [x] 批量更新家长\n    - [x] 读取学生或家长\n    - [x] 获取部门成员详情\n    - [x] 设置家校通讯录自动同步模式\n    - [x] 获取部门家长详情\n  - [x] 部门管理\n    - [x] 创建部门\n    - [x] 更新部门\n    - [x] 删除部门\n    - [x] 获取部门列表\n    - [x] 修改自动升年级的配置\n- [x] 学校应用\n  - [x] 上课直播\n    - [x] 获取老师直播ID列表\n    - [x] 获取直播详情\n    - [x] 获取观看直播统计\n    - [x] 获取未观看直播统计\n    - [x] 删除直播回放\n  - [x] 班级收款\n    - [x] 获取学生付款结果\n    - [x] 获取订单详情\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-laoji%2Fwecom-go-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgo-laoji%2Fwecom-go-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgo-laoji%2Fwecom-go-sdk/lists"}