mirror of
https://github.com/langbot-app/LangBot.git
synced 2026-10-30 04:15:45 +08:00
106 lines
3.4 KiB
Plaintext
106 lines
3.4 KiB
Plaintext
---
|
|
title: "接入飞书机器人"
|
|
---
|
|
|
|
## 创建机器人
|
|
|
|
前往[飞书开放平台](https://open.feishu.cn/app)，登录后，创建企业自建应用/商店应用 [(区别介绍)](https://open.feishu.cn/document/platform-overveiw/overview)。
|
|
|
|
|
|
|
|
|
|
|
|
为应用添加机器人能力：
|
|
|
|
|
|
在权限管理中添加图中所示权限：
|
|
|
|
|
|
|
|
如需卡片流式权限则多添加如下图的创建与更新卡片：
|
|
|
|
|
|
|
|
<Warning>
|
|
默认卡片模板如需更换，需要自己去平台适配器的代码中修改卡片模板
|
|
</Warning>
|
|
|
|
## 对接 LangBot
|
|
|
|
在`凭证与基础信息`页找到`app_id`和`app_secret`。
|
|
|
|
|
|
|
|
|
|
|
|
打开LangBot 的 Webui 配置页面，创建一个新的机器人
|
|
|
|
将相关信息填入表单
|
|
|
|
|
|
|
|
流式相关：
|
|
|
|
|
|
填写完成后启动 LangBot，若成功配置，日志中会出现`[01-29 23:42:56.796] manager.py (68) - [INFO] : 初始化平台适配器 1: lark`的字样，保持 LangBot 运行。
|
|
|
|
<Warning title="">
|
|
默认使用的是 WebSocket 长连接模式，对应下方的长连接订阅。但某些情况下（如国际版飞书）不具有长连接模式，此时需要使用 Webhook 模式，对应`将事件发送到开发者服务器`模式，请参考以下配置：
|
|
|
|
- `enable-webhook`：设置为`true`
|
|
- `encrypt-key`：设置为`事件与回调`页面的`加密策略`中的`Encrypt Key`
|
|
|
|
注意，在Webhook模式中，LangBot 需要部署在具有公网 IP 的服务器上，并确保防火墙已开放上方配置的端口。
|
|
|
|
</Warning>
|
|
<Tip>
|
|
**没有公网服务器？** [LangBot Cloud](https://space.langbot.app/cloud) 自带域名和 HTTPS，无需自行配置，开箱即用飞书机器人。
|
|
</Tip>
|
|
|
|
## 配置事件订阅
|
|
|
|
前往`事件与回调`页，配置订阅方式为`长连接`：
|
|
|
|
|
|
|
|
并添加事件：`接收消息`
|
|
|
|
|
|
|
|
|
|
设置`回调配置`，选择使用长连接的回调(如果是webhook则使用webhook)
|
|
|
|
|
|
|
|
添加回调`卡片回传交互`
|
|
|
|
|
|
|
|
<Warning title="">
|
|
Webhook 模式配置方式：
|
|
|
|
|
|
|
|
请先启动 LangBot，在此处填写从 LangBot 获取的 Webhook 地址
|
|
|
|
</Warning>
|
|
|
|
## 发布机器人
|
|
|
|
点击顶部`创建版本`，填写版本号等信息，点击下方`保存`。
|
|
|
|
|
|
|
|
在飞书群中添加机器人，即可使用：
|
|
|
|
|
|
|
|
|
|
|
|
私聊也可以直接使用
|
|
|
|
|
|
|
|
## 常见问题
|
|
- 商店应用机器人创建/保存后无法立刻响应聊天消息，由于[app_ticket事件](https://open.feishu.cn/document/server-docs/application-v6/event/app_ticket-events)延迟机制，需要等待2分钟左右才可以正常使用。
|