企业微信入门

在使用之前,先按照下面方法初始化一个实例:

  1. WeComApp, err := work.NewWork(&work.UserConfig{
  2. CorpID: "[app_id]", // 企业微信的app id,所有企业微信共用一个。
  3. AgentID: AgentID, // 内部应用的app id
  4. Secret: "[wecom_secret]", // 内部应用的app secret
  5. OAuth: work.OAuth{
  6. Callback: "https://wecom.artisan-cloud.com/callback", //
  7. Scopes: nil,
  8. },
  9. HttpDebug: true,
  10. // 可选,不传默认走程序内存
  11. Cache: kernel.NewRedisClient(&kernel.UniversalOptions{
  12. Addrs: []string{"127.0.0.1:6379"},
  13. Password: "",
  14. DB: 0,
  15. }),
  16. })

同时因为企业微信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
  • 必传:
  • 示例:
  1. miniProgram.Log{
  2. Level: "debug", // 输出日志等级
  3. File: "./wechat.log", // 输出日志文件
  4. }

输出日志到指定文件。

HttpDebug

  • 类型: bool
  • 必传:
  • 默认值:false

是否开启打印SDK调用微信API接口时候的日志,开启之后会显示出提交的参数和微信详情的数据,对于排查问题时候非常有帮助。

Cache

  • 类型: CacheInterface
  • 必传:
  • 默认值:nil

如果需要实现Token中控,例如多个应用实例共享或者和其他应用共享Token。

更多详细内容请参考: Cache配置