企业微信入门
在使用之前，先按照下面方法初始化一个实例：
go
WeComApp, err := work.NewWork(&work.UserConfig{
CorpID: "[app_id]", // 企业微信的app id，所有企业微信共用一个。
AgentID: AgentID, // 内部应用的app id
Secret: "[wecom_secret]", // 内部应用的app secret
OAuth: work.OAuth{
Callback: "https://wecom.artisan-cloud.com/callback", //
Scopes: nil,
},
Log: work.Log{
Level: "debug",
File: "./wechat.log",
Stdout: false, // 是否打印在终端
},
HttpDebug: true,
// 可选，不传默认走程序内存
Cache: kernel.NewRedisClient(&kernel.UniversalOptions{
Addrs: []string{"127.0.0.1:6379"},
Password: "",
DB: 0,
}),
})同时因为企业微信secret需要配置非常多个（自建应用secret、基础应用secret、通讯录管理secret、外部联系人管理secret等等），所以建议一个模块就初始化一个实例。
UserConfig参数说明
CorpID
- 类型:
string - 必传:
是 - 示例:
ww16143ea0101327cc
每个企业都拥有唯一的corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看“企业ID”（需要有管理员权限）
Secret
- 类型:
string - 必传:
是 - 示例:
1e116d3db6d32322d3b1d8666232b097
secret是企业应用里面用于保障数据安全的“钥匙”，每一个应用都有一个独立的访问密钥，为了保证数据的安全，secret务必不能泄漏。
目前secret有：
- 自建应用secret。在管理后台->“应用与小程序”->“应用”->“自建”，点进某个应用，即可看到。
- 基础应用secret。某些基础应用（如“审批”“打卡”应用），支持通过API进行操作。在管理后台->“应用与小程序”->“应用->”“基础”，点进某个应用，点开“API”小按钮，即可看到。
- 通讯录管理secret。在“管理工具”-“通讯录同步”里面查看（需开启“API接口同步”）；
- 外部联系人管理secret。在“客户联系”栏，点开“API”小按钮，即可看到。
Token
- 类型:
string - 必传:
是 - 示例:
vlhkaO8PW6UYyRgWCgb3UwF
微信回调消息的Token，请到微信后台获取。
如果会出现报错"初始化报错 illegal base64 data at input byte 0" 可以随机给予一个初始化的字符串，如上案例。
AESKey
- 类型:
string - 必传:
是 - 示例:
zUfVSOan3B5ZZZZZZ66ixY6OrB28MTS9OIiBLaq3q2PhNG
微信回调消息的密钥，即 AESKey，请到微信后台获取。
如果没有给AESKey，初始化会有提示消息"AES Key is empty, this may occur errors when decode callbacks message"
Log （TODO）
- 类型:
miniProgram.Log - 必传:
否 - 示例:
go
miniProgram.Log{
Level: "debug", // 输出日志等级
File: "./wechat.log", // 输出日志文件
Stdout: false, // 是否打印在终端
}输出日志到指定文件。
HttpDebug
- 类型:
bool - 必传:
否 - 默认值：
false
是否开启打印SDK调用微信API接口时候的日志，开启之后会显示出提交的参数和微信详情的数据，对于排查问题时候非常有帮助。
Cache
- 类型:
CacheInterface - 必传:
否 - 默认值：
nil
如果需要实现Token中控，例如多个应用实例共享或者和其他应用共享Token。
更多详细内容请参考： Cache配置