自适应网站m域名必须做301,网站设计开发的难点,个人网页设计模版,天眼查个人查询入口文章目录 0. 前言1. 无痛入门1.1 飞书创建群聊机器人1.2 Webhook 请求示例1.3 设置安全策略 2. 实战3. 总结3.1 使用体验3.2 深入使用建议 先进团队用飞书#xff0c;先进飞书群聊有......
0. 前言
科技蓬勃发展的今天#xff0c;我们可以轻松拥有属于自己/团队的机器人。日… 文章目录 0. 前言1. 无痛入门1.1 飞书创建群聊机器人1.2 Webhook 请求示例1.3 设置安全策略 2. 实战3. 总结3.1 使用体验3.2 深入使用建议 先进团队用飞书先进飞书群聊有......
0. 前言
科技蓬勃发展的今天我们可以轻松拥有属于自己/团队的机器人。日常工作与生活中我们可以创建各种各样的机器人来帮助我们传递信息甚至可以接入大语言模型或者其它 AI 神经网络来实现各种各样的回复功能进一步解放生产力。而作为日常工作中经常使用的飞书更是提供了可以非常快速入门的自定义机器人来帮助我们做日常管理。
幸运的是小编本人单位最近就全面采用飞书进行行政管理与团队沟通、任务统筹工作。这也让小编本人有机会接触将后端告警信息接入飞书机器人的业务。本文记录本次根据官方文档实现业务接入机器人的简单入门过程。一来对个人而言作为一次笔记记录方便日后回顾与拓展二来希望帮助到有需要的读者快速入门接入飞书机器人。
需求描述 创建飞书机器人并通过 Webhook 的方式请求飞书将监控信息接入飞书群聊及时通知开发团队提高整体效率。
演示创建机器人的过程直接通过 Webhook 的方式请求其本质是一次 Http 请求一般情况下为POST 请求实现过程以 Java 代码示例
参考教程 飞书官方文档
1. 无痛入门
我们团队首次使用飞书不到半月。短短几天内我的领导就已经将 Jekins 项目构建监控信息接入了飞书我也收到了研发改善性需求遂从入门到简单接入业务开始从个人版到企业飞书创建了一个业务监控机器人。
本小节介绍飞书群聊创建机器人先在个人版做演示。
1.1 飞书创建群聊机器人
截图演示快速创建群聊机器人此处以个人版的示例群聊为例。
第1步目标群聊
第2步点击创建机器人
第3步设置信息
第4步注意保管好Webhook地址
至此基本创建完毕我们先不勾选安全测试先调用通过再通过官方建议设置安全策略。
1.2 Webhook 请求示例
Webhook 调用 的本质是 Http 请求。以下以 Java 为例。
创建一个测试类再发送 Http 请求
测试类
Test
void firstRobotTest() throws IOException, NoSuchAlgorithmException, InvalidKeyException {String webhook https://open.feishu.cn/open-apis/bot/v2/hook/[secert];// 定义 webhook 的 URL 地址URL url new URL(webhook);// 创建一个 HTTP POST 请求HttpURLConnection connection (HttpURLConnection) url.openConnection();connection.setRequestMethod(POST);connection.setDoOutput(true);// 设置请求头connection.setRequestProperty(Content-Type, application/json; charsetutf-8);// 设置请求体// 创建一个 JSON 对象JSONObject jsonObject new JSONObject();jsonObject.put(msg_type, text);jsonObject.put(content, { \text\: \Hello, Im a new robot from Sharry! Nice to meet U guys\ });// 将 JSON 对象转换为字符串String payload JSON.toJSONString(jsonObject);connection.getOutputStream().write(payload.getBytes());// 获取响应状态码int statusCode connection.getResponseCode();System.out.println(HTTP status code: statusCode);}说明这里涉及两个小核心一个是需要我们保管好的Webhook地址因此示例代码的实际webhook用[secert]代替另一个就是如何发送 Http 请求。一般来说发送 Http 请求是我们程序猿的基本功但又不巧的是日常工作中直接手写发送Http请求或许也不是十分频繁框架帮我们做了嘛。而好消息是飞书机器人入门真的好简单当我们忘了这部分知识时我们甚至可以通过官方文档的说明度娘或GPT一样实现请求。再不行直接抄上文的测试类也是可以的。
测试结果
好了基本测试通过接下来我们来稍微完善一下。
1.3 设置安全策略
我们回到机器人调用界面发现安全策略提醒。此处我们选取签名认证的方式来示例。
通过官方文档快速实现前面认证 根据官方文档的描述我们可以写一个同款生成Sign信息方法也可以直接复用官方文档的示例以下是复制官方文档的生成Sign方法:
private static String GenSign(String secret, int timestamp) throws NoSuchAlgorithmException, InvalidKeyException {//把timestamp\n密钥当做签名字符串String stringToSign timestamp \n secret;//使用HmacSHA256算法计算签名Mac mac Mac.getInstance(HmacSHA256);mac.init(new SecretKeySpec(stringToSign.getBytes(StandardCharsets.UTF_8), HmacSHA256));byte[] signData mac.doFinal(new byte[]{});return new String(Base64.encodeBase64(signData));}组装请求体
Test
void firstRobotTest() throws IOException, NoSuchAlgorithmException, InvalidKeyException {String webhook https://open.feishu.cn/open-apis/bot/v2/hook/[secert];// 定义 webhook 的 URL 地址URL url new URL(webhook);// 创建一个 HTTP POST 请求HttpURLConnection connection (HttpURLConnection) url.openConnection();connection.setRequestMethod(POST);connection.setDoOutput(true);// 设置请求头connection.setRequestProperty(Content-Type, application/json; charsetutf-8);// 设置请求体// 创建一个 JSON 对象JSONObject jsonObject new JSONObject();jsonObject.put(msg_type, text);jsonObject.put(content, { \text\: \Hello, Im a new robot from Sharry! With sign this time\ });// 签名信息int timestamp (int) (System.currentTimeMillis() / 1000);String sign GenSign(SECRET, timestamp);jsonObject.put(timestamp, timestamp);jsonObject.put(sign, sign);// 将 JSON 对象转换为字符串String payload JSON.toJSONString(jsonObject);connection.getOutputStream().write(payload.getBytes());// 获取响应状态码int statusCode connection.getResponseCode();System.out.println(HTTP status code: statusCode);}注意根据官方文档的说明还要带上时间戳具体详见上述方法。
测试结果
恭喜已完成入门接下来是实战了
2. 实战
本文截取部分已脱敏的个人工作实战代码来示例演示将 Sping filter chains 的一个监控信息先组装一下通知信息Json再通过 Webhook 的调用方式及时通知到飞书群。
有了上述基础直接上代码示例应该很好理解。注意文中涉及的 Filter 与 Druid 等 的其它配置请读者参考其它文档。
Spring Filter 调用Webhook 实现监控信息发到飞书群
Overridepublic void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {// Filter逻辑处理方法HttpServletRequest httpServletRequest (HttpServletRequest) servletRequest;long startTime System.nanoTime();filterChain.doFilter(servletRequest, servletResponse);long endTime System.nanoTime();long executeTime endTime - startTime;if (executeTime THRESHOLD_NANO) {// 获取请求路径String url httpServletRequest.getRequestURI();String tips 详细信息请查阅Druid监控及日志;// 定义 webhook 的 URL 地址URL targetUrl new URL(webhook);// 创建一个 HTTP POST 请求HttpURLConnection connection (HttpURLConnection) targetUrl.openConnection();connection.setRequestMethod(POST);connection.setDoOutput(true);// 设置请求头connection.setRequestProperty(Content-Type, application/json; charsetutf-8);// 设置请求体// 创建一个 JSON 对象HashMapString,String contentMap new HashMap(2);String message 慢SQL或业务整体缓慢 警告: 执行时间 executeTime / 1000 / 1000 ms, 接口路径 url \n tips;contentMap.put(text, message);JSONObject jsonObject new JSONObject();jsonObject.put(msg_type, text);jsonObject.put(content, contentMap);// 签名信息int timestamp (int) (System.currentTimeMillis() / 1000);String sign null;try {sign GenSign(SECRET, timestamp);} catch (NoSuchAlgorithmException | InvalidKeyException e) {throw new RuntimeException(e);}jsonObject.put(timestamp, timestamp);jsonObject.put(sign, sign);// 将 JSON 对象转换为字符串String payload JSON.toJSONString(jsonObject);connection.getOutputStream().write(payload.getBytes());}复用我们入门的时候的代码即可非常好用
实际效果部分截图
3. 总结
3.1 使用体验
本次飞书创建机器人快速入门调用接口非常方便飞书文档简单易读调用起来方便快捷且兼容性强。不像WeChat机器人需要另辟蹊径。通过快速构建简单易用的机器人并快速接入我们所需业务一方面在开发者眼中可以快速实现基础业务方便进一步优化以及开发另一方面在用户体验中短时间就能实现飞书机器人并及时收到通知多是一件美事。但对于深度使用飞书的用户与开发者来说只入门基础调用可能还不够但快速入门至少是能最快迈出第一步。
但是要注意由于简单易用的特性任何人都能快速入门并快速调用你的机器人飞书群聊机器人的Webhook地址务必要保护好重要的事情说三遍务必保护好机器人Webhook地址务必保护好机器人Webhook地址务必保护好机器人Webhook地址
3.2 深入使用建议
飞书机器人可以实现的功能还有很多很多本文只是将飞书官方文档筛选一遍只取最快速入门的一部分结合个人实践代码入门一遍。对于飞书机器人的深度使用如消息卡片、接入其它第三方工具、机器人交互等还请继续阅读官方文档。飞书的官方文档简单易懂且详尽调用方便快捷相信你可以通过飞书官方文档构建出更好用更有价值的机器人
