Files
LangBot/docs/zh/deploy/platforms/lark.md
T
2025-05-11 18:18:47 +08:00

76 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 接入飞书机器人
## 创建机器人
前往[飞书开放平台](https://open.feishu.cn/app),登录后,创建企业自建应用。
![alt text](/assets/image/zh/deploy/bots/lark/lark_01.png)
![alt text](/assets/image/zh/deploy/bots/lark/lark_02.png)
为应用添加机器人能力:
![alt text](/assets/image/zh/deploy/bots/lark/lark_03.png)
在权限管理中添加图中所示权限:
![alt text](/assets/image/zh/deploy/bots/lark/lark_04.png)
## 对接 LangBot
在`凭证与基础信息`页找到`app_id`和`app_secret`。
![alt text](/assets/image/zh/deploy/bots/lark/lark_05.png)
打开LangBot 的 Webui 配置页面,创建一个新的机器人
将相关信息填入表单
![alt text](/assets/image/zh/deploy/bots/lark/connect_to_langbot.png)
填写完成后启动 LangBot,若成功配置,日志中会出现`[01-29 23:42:56.796] manager.py (68) - [INFO] : 初始化平台适配器 1: lark`的字样,保持 LangBot 运行。
:::warning
默认使用的是 WebSocket 长连接模式,对应下方的长连接订阅。但某些情况下(如国际版飞书)不具有长连接模式,此时需要使用 Webhook 模式,对应`将事件发送到开发者服务器`模式,请参考以下配置:
- `enable-webhook`:设置为`true`
- `encrypt-key`:设置为`事件与回调`页面的`加密策略`中的`Encrypt Key`
注意,在Webhook模式中,LangBot 需要部署在具有公网 IP 的服务器上,并确保防火墙已开放上方配置的端口。
:::
## 配置事件订阅
前往`事件与回调`页,配置订阅方式为`长连接`:
![alt text](/assets/image/zh/deploy/bots/lark/lark_07.png)
并添加事件:`接收消息`
![alt text](/assets/image/zh/deploy/bots/lark/lark_08.png)
:::warning
Webhook 模式配置方式:
![alt text](/assets/image/zh/deploy/bots/lark/lark_13.png)
请先启动 LangBot,在此处填写你的服务器地址和端口,路径为`/lark/callback`,点击`保存`。
:::
## 发布机器人
点击顶部`创建版本`,填写版本号等信息,点击下方`保存`。
![alt text](/assets/image/zh/deploy/bots/lark/lark_09.png)
在飞书群中添加机器人,即可使用:
![alt text](/assets/image/zh/deploy/bots/lark/lark_10.png)
![alt text](/assets/image/zh/deploy/bots/lark/lark_11.png)
私聊也可以直接使用
![alt text](/assets/image/zh/deploy/bots/lark/lark_12.png)