Skip to content

接入飞书机器人

创建机器人

前往飞书开放平台,登录后,创建企业自建应用。

alt text

alt text

为应用添加机器人能力: alt text

在权限管理中添加图中所示权限:

alt text

在 LangBot 中填写信息并启动

根据填写配置信息中的飞书适配器配置,填写相关信息。可以在凭证与基础信息页找到app_idapp_secret

alt text

json
        {
            "adapter": "lark",
            "enable": true,
            "app_id": "cli_abcdefgh",
            "app_secret": "XXXXXXXXXX",
            "bot_name": "LangBot",
            "enable-webhook": false,
            "port": 2285,
            "encrypt-key": "xxxxxxxxx"
        },

注意:bot_name必须与创建机器人时填写的机器人名称相同。确保enabletrue

填写完成后启动 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

并添加事件:接收消息

alt text

WARNING

Webhook 模式配置方式:

alt text

请先启动 LangBot,在此处填写你的服务器地址和端口,路径为/lark/callback,点击保存

发布机器人

点击顶部创建版本,填写版本号等信息,点击下方保存

alt text

在飞书群中添加机器人,即可使用:

alt text

alt text

私聊也可以直接使用

alt text