创建应用
打开飞书管理后台 https://open.feishu.cn/app 点击“创建应用”
lark的管理后台地址是https://open.larksuite.com/app
添加机器人
“应用能力” -> “添加应用能力” -> “按能力添加”: 添加 机器人
权限管理
需要的权限为:
消息读取/消息发送/上传、获取图片
点击左侧权限管理
,权限配置输入以下内容,点击开通权限
- im:chat.members:read
- im:chat
- im:message:send_as_bot
- im:message
- im:resource
- im:message.group_at_msg
事件与回调
事件与回调有HTTP模式和长连接两种模式 截止当前飞书两种都有,lark只有HTTP模式. 且飞书的长连接模式也只在内测阶段 需要扫码加入飞书内测群,给公司自建APP自动开通长连接模式。 |
导航到下图中页面,如果订阅方式已经有长连接
,就直接使用长连接模式,否则只能使用HTTP模式
HTTP模式
需要申请一个公网域名或者公网IP,用于飞书将群消息发送给机器人.
这里记为$IP
或者$DOMAIN
关于飞书事件和回调出口IP:
飞书开放平台向应用配置的回调地址推送事件时,是通过特定的 IP 发送出去的,应用可以通过本接口获取所有相关的 IP 地址。 参考文档获取 https://open.feishu.cn/document/server-docs/event-subscription-guide/list
生成Encrypt Key
与Verification Token
点击加密策略
,生成Encrypt Key
和Verification Token
启动截图服务
将生成Encrypt Key
与Verification Token
之后,与app_id
, app_secret
一起给flashcat交付同学,先将截图服务的容器启动起来。
截图服务默认监听端口是8081
否则在选择订阅方式时会出现无法保存的错误。(因为保存时飞书开放平台会发送一个challenge, 后端服务需要解密之后响应该challenge)
- App ID
- App Secret
- Encrypt Key
- Verification Token
事件配置
选择订阅方式
飞书选长连接
模式
lark用户在这里只能看到一种订阅方式,也即HTTP模式.
事件这里写入http(s):$IP/welcome
或者http(s):$DOMAIN/welcome
添加事件:
- 接受消息 v2.0
点击添加事件
按钮,在搜索框搜索 接收
, 找到后确认添加
回调配置
-
长连接模式(推荐飞书用户使用,如果看不到长连接模式,回到本文档前面,扫码入群后刷新页面)
-
HTTP模式 回调这里写入
http(s):$IP/act
或者http(s):$DOMAIN/act
添加回调
- 卡片回传交互
为了卡片交互功能,我们在需要在“回调配置”中写入“请求地址”,且“添加回调”,如下图所示:
发布应用
版本管理与发布
创建版本 ,线上发布后等待审核通过
添加机器人
审核通过后,在群内,添加机器人
[图片] 现在可以在群里跟机器人进行交互了,发送help命令即可获取全部指令。灭火图截图效果如下