# 飞书机器人应用

***

**特别注意：飞书应用使用的是批量发送消息接口，消息会有一定延迟，且必须要有至少一个飞书用户open\_id或user\_id或union\_ids或部门open\_department\_id，否则无法收取消息**

**创建飞书应用**

打开飞书开放平台，创建飞书企业自建app应用 https://open.feishu.cn/app/

![fei](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-1a934929a441d581b0a6ce67de103c23de9f58a7%2Ffsapp%E7%99%BB%E5%BD%95%E5%88%9B%E5%BB%BA%E6%9C%BA%E5%99%A8%E4%BA%BA1.png?alt=media)

![fei2](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-953bae8918a26f56becd357a2d071993a5a66e5d%2Ffsapp%E7%99%BB%E5%BD%95%E5%88%9B%E5%BB%BA%E6%9C%BA%E5%99%A8%E4%BA%BA2.png?alt=media)

创建完成后，选择刚刚创建的应用，进入应用管理后台，选择 应用功能--> 机器人，开启应用的机器人能力

![fei3](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-80f537b48153d530596c33e9f80f361dbec9f3e0%2Ffsapp%E5%90%AF%E7%94%A8%E6%9C%BA%E5%99%A8%E4%BA%BA3.png?alt=media)

继续分配应用权限，选择 权限管理--> 消息与群组，开通以下权限

* 给多个用户批量发消息
* 给一个或多个部门的成员批量发消息
* 获取与发送单聊、群组消息

![fei4](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-90cb0aa8a541581810a6a8ac99191405bc253752%2Ffsapp%E5%88%86%E9%85%8D%E6%9C%BA%E5%99%A8%E4%BA%BA%E6%9D%83%E9%99%904.png?alt=media)

最后发布应用版本，让具有管理员权限的用户去审核申请的权限和发布请求即可

![fei5](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-a9be23f1672e3c29b1b6591c20d492b67d2bf08c%2Ffsapp%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%865.png?alt=media)

审核完成后，获取到飞书应用的 `App ID`和`App Secret`，并配置到PrometheusAlert 的 app.conf配置项目中

![fei6](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-2105121570d3c814dacb74470d0b06be6cec95fe%2Ffsapp6.png?alt=media)

**飞书应用app.conf配置**

```
#---------------------↓飞书机器人应用-----------------------
#是否开启feishuapp告警通道,可同时开始多个通道0为关闭,1为开启
open-feishuapp=1
# APPID
FEISHU_APPID=cli_xxxxxxxxxxxxxxxxxxxxx
# APPSECRET
FEISHU_APPSECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 可填飞书 用户open_id、user_id、union_ids、部门open_department_id
AT_USER_ID="xxxxxxxxxxx"
```

**如何查找user\_id**

通过飞书管理员登录飞书管理后台，进入 组织架构-->成员与部门-->找到对应的用户，查看成员详情即可

![fei7](https://1024575059-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M8n6Ta3jydOf-smMmDd%2Fuploads%2Fgit-blob-c165327c5a033f6671314018a846a6f221137b80%2Ffsapp7.png?alt=media)

**如何使用**

以Prometheus配合自定义模板为例：

Prometheus配置参考：

```
global:
  resolve_timeout: 5m
route:
  group_by: ['instance']
  group_wait: 10m
  group_interval: 10s
  repeat_interval: 10m
  receiver: 'web.hook.prometheusalert'
receivers:
- name: 'web.hook.prometheusalert'
  webhook_configs:
  - url: 'http://[prometheusalert_url]:8080/prometheusalert?type=fsapp&tpl=prometheus-feishu-app&at=xxxxxxxx,xxxxxx2,xxxxxxx3'
```
