在企业日常开发中，随着告警、通知和定时提醒等消息的增多，需要发送的消息也越来越多。然而，常见的消息软件如微信、飞书和钉钉在接入方面使用不同的API，这就需要花费大量时间和精力去查阅文档进行对接。为了解决这个问题，我们的messenger应用着重于提供一种简化接入流程的解决方案。
01 开源工具
messenger是一个简单轻量的消息发送服务，目前支持邮件、微信、飞书、钉钉，同时支持配置动态修改，使用简单灵活。
messenger提供了统一的接口，使得您无需关心不同消息软件的API差异和文档查阅，您可以通过messenger的API快速发送告警、通知和定时提醒等各种消息，极大地简化了开发过程。
开源地址：
02 快速上手
1. 启动服务
messenger部署非常简单，支持源码和docker启动，下面我们使用最简单的源码方式启动为例。因ops-tools是个工具集合，所以你只需要关注messenger目录即可。
git clone https://github.com/veops/ops-tools.gitcd ops-tools/messengercp confTemplate.yaml conf.yamlsh build.sh./messenger
支持动态修改配置文件，所以不需要一开始就配置好sender，上述操作中我们仅拷贝了一份配置模板而已，我们还需修改具体的配置。
2. 平台对接
各种IM软件的应用和机器人接入流程均比较相似，这里我们演示一个钉钉机器人的配置。
1. 在群设置中选择机器人，添加一个自定义机器人
一般顺序为 群设置->添加机器人->自定义。
2.配置机器人
配置机器人名称，安全设置选择加签并复制(后续配置的token)，点击完成。
复制webhook地址地址。
3.配置messenger
将上一步骤中获取的token和webhook地址配置到messenger的conf.yaml中的dingdingBot下，由于conf的senders下内容修改后无需重启服务，直接生效。
app: ip: port: 8888
senders: - type: dingdingBot name: dingdingBot # 名称随意填写，发送时sender填写该名称即可 url: https://oapi.dingding.com/robot/send?access_token=xxxx # 第二步复制的webhook token: # 第二步复制的加签token
4 .发送
03 深入一下
鉴权
默认可以不使用鉴权，即配置中的auths的内容注释掉即可，如果需要有鉴权功能，目前支持IP、token、sign三种鉴权方式
1 . IP
发送请求的客户端ip需匹配pattern
auths: - type: ip pattern: 192.168.*.*
- token
发送请求中需要添加请求头 X-Token = xxxxxx
auths: - type: token token: xxxxxx
- sign
签名鉴权需要添加请求头 X-TS = 当前unix秒数时间戳 X-Nonce = 随机内容 X-Sign = 根据签名算法生成的签名，详细的生成算法可以参考仓库的说明文档。
auths: - type: sign secret: yyyyyy
多种发送方式
发送方式在senders里面配置，支持动态修改，无需重启服务，目前支持主流的消息类型。
| wechatBot | dingdingAppsenders | |
|---|---|---|
| wechatApp | feishuBot | |
| dingdingBot | feishuApp |
自定义发送方式
通常情况下，以上7中方式能满足大部分需求，但是如果你想要定制自己的sender，可以按如下步骤进行开发。
-
在send目录下创建你的sender文件，如mysender.go
-
定义mysender类并实现sender接口
typesenderinterface{ send(*message) error getConf() map[string]string}
- 新增init方法，将sender注册到后台goroutine中，registered的关键字mysender即为新的sender类型，可以在配置文件中使用，建议将文件名、结构体名、类型名保持一致。
func init(){ registered["mysender"] = func(conf map[string]string) sender { return &feishuBot{conf: conf} }}
04 结语
以上即为我们messenger的使用介绍，如果您在企业日常开发中需要频繁发送消息，不妨试试messenger，相信它会给您带来便利和效益。
