- MediaGetResponse 返回http.Header,满足文件名、文件长度、文件类型等其它需求
- feat Issues12
因修改了返回类型,不兼容之前的Content-Type
,使用临时素材获取接口需要注意sdk版本
- 当请求返回42001时(token过期)则清空缓存触发重试
- 官方2023/11/21变更获取客户群详情接口支持返回群成员版本号
- 官方2023/12/21变更接口微信客服发送消息支持发送“获客链接消息”
- feature: GetBillList 获取对外收款记录
- fix: 修改 KfSyncMsgResponse 的 HasMore 类型, 由 bool -> int
- refactor: 修改 MsgMenu 结构, 将 menu 中的 Click, View, Miniprogram 独立为 struct
- fix: 删掉 MsgLink struct 的 PicUrl, 使用 ThumbMediaId 代替
- refactor: extract item of MsgList as struct KfMessage
- 增加获取临时素材功能,感谢xzvwang贡献
使用go-resty代替原生http.Client
- 增加SetProxy(proxyUrl string) 对绕过IP限制有用
- 增加SetDebug(debug bool) 可以监控http请求
- 升级了些基础库版本
- TODO:
- 低版本测试,开发环境为 go 1.20
- 单测补充
增加jssdk调用时的config签名函数
- GetConfigSignature
- GetAgentConfigSignature
bug fix: User 序列化时某个字段空值的bug
对应官方 2022/12/01 接口变更
- 新增接口 支持终止尚未发送的朋友圈发表任务
- 变更接口 增加allow_select参数,允许成员在待发送客户列表中重新选择发送客户
- 新增接口 重新触发群发通知,提醒成员完成群发任务
- 新增接口 支持取消尚未发送给客户的群发任务
- 变更接口 获取客服帐号列表接口,支持查看账号管理权限
- 变更接口 读取消息接口,支持指定拉取某个客服账号的消息,支持视频号小店订单、商品类型消息
- 变更接口 进入会话事件,客户从视频号小店和视频号进入时,返回更详细的来源信息
- 变更接口 获取客户基础信息,支持客户从视频号小店和视频号进入时,查看更详细的来源信息
- 接口调用许可
- 自动激活设置
- 设置企业的许可自动激活状态
- 查询企业的许可自动激活状态
- 自动激活设置
- 应用授权
- 获取应用的管理员列表
- 客户标签ID的转换接口
- ID转换接口
- corpid的转换
- userid的转换
- 转换客户external_userid
- 转换客户群成员external_userid
- 微信客服ID的转换
- 移除成员、部门、学生、家长、家校部门修改时非必填项的验证
bug fix:
- GetUserInfo3rd(code string) (resp GetUserInfo3rdResponse)
- GetUserInfoDetail3rd(userTicket string) (resp GetUserInfoDetail3rdResponse)
- GetUserInfo(corpId uint, code string) (resp GetUserInfoResponse)
- GetUserDetail(corpId uint, userTicket string) (resp GetUserDetailResponse)
接口URL修改
- 新增加单元测试代码,文档见test下readme
bug fix:
- 成员id列表序列化
- 应用授权逻辑优化
增加:
- 机器人管理
- 知识库分组管理
- 添加分组
- 删除分组
- 修改分组
- 获取分组列表
- 知识库分组管理
bug fix: MessageUpdateTemplateCard 添加 agentid cwww3提交PR
增加:
- 自建应用获取用户隐私信息
- 获取成员ID列表
bug fix: DepartmentSimpleListResponse 序列化错误
增加:(仅会话存档应用的secret获取的accesstoken可调用)
- 会话内容存档
- 获取会话内容存档开启成员列表
- 获取会话同意情况
- 获取会话内容存档内部群信息
fix:升级badger库为v3版本,并且不再将缓存写到内存;改写文件
使用过程中有发现v2版本有占用内存高的情况
增加:
- 通讯录管理
- 成员管理
- 创建成员
- 更新成员
- 删除成员
- 部门管理
- 创建部门
- 更新部门
- 删除部门
- 成员管理
fix: GetGroupMsgSendResultResponse中external_userid序列化错误
增加:新增ExecuteCorpApi方法,用来执行未实现的授权企业应用接口,返回值需要自行做序列化处理
增加服务商接口调用许可相关接口
- 接口调用许可
- 订单管理
- 下单购买帐号
- 下单续期帐号
- 获取订单列表
- 获取订单详情
- 获取订单中的帐号列表
- 帐号管理
- 激活帐号
- 获取激活码详情
- 获取企业的帐号列表
- 获取成员的激活详情
- 帐号继承
- 订单管理
- MessageSend 增加
agentid
参数
- 增加:SetAgentIdFunc、GetAgentId 定义用于获取应用的agentid
- 弃用: CorpPermanentCode表将永久授权码信息合并存入 agent 表
- defaultAppSecretFunc默认从agent表中读取配置
bugfix:
- KfAccountList 接口定义错误,感谢Drogenwei反馈
官方2022/04/29更新
- 客户联系
- 变更接口 获取客户详情接口:若客户来源于视频号,则返回视频号添加场景(主页或直播间)
- 变更接口 批量获取客户详情接口:若客户来源于视频号,则返回视频号添加场景(主页或直播间)
- 微信客服
- 变更接口 获取客服帐号列表接口支持分页拉取
- 变更接口 添加接待人员接口支持按部门配置接待人员
- 变更接口 删除接待人员接口支持按部门删除接待人员
- 变更接口 获取接待人员列表接口返回接待人员部门的id
增加:
- 微信客服
- 客服帐号管理
- 添加客服帐号
- 删除客服帐号
- 修改客服帐号
- 获取客服帐号列表
- 获取客服帐号连接
- 接待人员管理
- 添加接待人员
- 删除接待人员
- 获取接待人员列表
- 会话分配与消息收发
- 分配客服会话
- 接收消息和事件
- 读取消息
- 发送消息
- 发送欢迎语等事件响应消息
- [升级服务]配置
- 其它基础信息获取
- 获取客户基础信息
- 获取企业状态信息
- 统计管理
- 获取「客户数据统计」企业汇总数据
- 获取「客户数据统计」接待人员明细数据
- 客服帐号管理
- 兼容代开发、自建应用、三方应用
- 增加
SetAppSecretFunc
接口以处理自定义的应用secret配置 - 增加jsapi的两个ticket获取接口
- 增加代开发应用的回调处理示例
- 修改项目名称为
wecom-go-sdk
- 增加自建代开发支持(可用于三方应用或者是自建代开发应用)
- logic增加Migrate,修复不使用默认配置文件名时数据库创建失败的bug
- 服务端路由注入格式统一;修改样例中代码
针对企业微信4.0的接口变更
- 新增接口 第三方应用新增组织架构信息权限,可以获取部门组织架构以及上级身份
- 新增接口 可获取指定部门的全部子部门ID列表
- 新增接口 可获取单个部门详情,包括部门负责人
- 变更接口 创建成员接口,可以指定企业邮箱biz_mail
- 变更接口 更新成员接口,可以指定企业邮箱biz_mail
- 变更接口 读取成员接口,新增返回企业邮箱biz_mail
- 变更接口 获取部门成员详情,新增返回企业邮箱biz_mail
- 新增接口 获取带参的应用二维码
- 变更接口 企业用户通过带参的应用二维码安装应用之后,获取企业永久授权码时返回state值
- 变更事件 企业用户通过带参的应用二维码安装应用之后,授权通知事件返回State字段
增加:
- 学校应用
- 上课直播
- 获取老师直播ID列表
- 获取直播详情
- 获取观看直播统计
- 获取未观看直播统计
- 删除直播回放
- 班级收款
- 获取学生付款结果
- 获取订单详情
- 上课直播
增加:
- 学校沟通
- 基础接口
- 获取「学校通知」二维码
- 管理「学校通知」的关注模式
- 设置关注「学校通知」的模式
- 获取关注「学校通知」的模式
- 发送「学校通知」
- 手机号转外部联系人ID
- 管理「老师可查看班级」模式
- 设置「老师可查看班级」的模式
- 获取「老师可查看班级」的模式
- 获取可使用的家长范围
- 学生与家长管理
- 创建学生
- 删除学生
- 更新学生
- 批量创建学生
- 批量删除学生
- 批量更新学生
- 创建家长
- 删除家长
- 更新家长
- 批量创建家长
- 批量删除家长
- 批量更新家长
- 读取学生或家长
- 获取部门成员详情
- 设置家校通讯录自动同步模式
- 获取部门家长详情
- 部门管理
- 创建部门
- 更新部门
- 删除部门
- 获取部门列表
- 修改自动升年级的配置
- 基础接口
增加:
- 应用管理
- 获取应用
- 获取指定的应用详情
- 获取access_token对应的应用列表
- 获取应用
- 电子发票
- 查询电子发票
- 更新发票状态
- 批量更新发票状态
- 批量查询电子发票
增加:
- 统计管理
- 管理商品图册
- 管理聊天敏感词
api列表参考readme 此版本未做完整测试,后续将补充待完善接口及测试代码
因第三方应用限制将不能像自建应用一样做单元测试;后期思路写一个完整的web接口配合postman做接口测试
本sdk需要依赖Mysql数据库只需要在配置文件写好连接信息,运行时会自动创建数据表。
数据表结构仅当前版本测试使用后期有可能修改结构
当前版本生产环境慎用!慎用!慎用!慎用!